CLI Command Reference

A complete map of Trylle CLI command groups, common conventions, and behavior that matters in scripts and reviews.

The installed CLI is the source of truth for the exact flags in your version. Move from the root help to the leaf command before a write:

try --help
try pr --help
try pr create --help

This page maps the complete command surface in Trylle CLI 1.1.4 and highlights the behavior that is easy to miss.

Common conventions

Repository selection

Commands that accept -R/--repo infer OWNER/NAME from a recognized Git remote when the option is omitted.

try repo context
try pr list -R OWNER/NAME

Commands such as try repo view, try clone, and try repo clone accept the repository positionally.

Output

Human-readable output is the default. Most platform leaf commands, plus explain, draft, and diff, offer JSON output for scripts and agents. ask and agent do not.

JSON support is a leaf-command option, not a universal root option. Check the leaf help instead of assuming it exists.

Bodies and input files

Pull request, review, issue, and comment commands commonly accept either --body or --body-file, but not both. Prefer a file for multiline content:

try pr create \
  --title "Add the parser" \
  --base main \
  --body-file pr-body.md

Where supported, --body-file - reads standard input. A command cannot use two different body-file options to consume stdin at the same time.

List commands may expose --page, --per-page, --limit, or --cursor. Filters can apply to the returned page, so fetch a sufficiently large page or paginate before concluding that no matching resource exists.

Account and daily context

Command	Subcommands	Purpose
`auth`	`login`, `logout`, `status`, `token`	Save, inspect, and remove Trylle CLI credentials
`whoami`	None	Validate the active credential and print its Trylle identity
`status`	None	Show viewer, inbox, pull requests, issues, CI, and recent automation state

Credential precedence is TRYLLE_BOT_TOKEN, then TRYLLE_API_KEY, then the saved key. auth token masks the value unless --show is explicitly used. auth logout currently removes the entire CLI config.json, including saved AI and agent settings.

Repositories

Command	Subcommands	Purpose
`clone`	None	Root shortcut that clones a Trylle repository with system Git
`repo`	`list`, `view`, `create`, `clone`, `fork`, `branches`, `edit`, `delete`, `context`	Create, inspect, clone, fork, configure, and remove repositories

Both clone forms accept OWNER/NAME, a Trylle web URL, or an SSH Git URL:

try clone OWNER/NAME DIRECTORY
try repo clone OWNER/NAME DIRECTORY

repo delete is irreversible from the CLI. Inspect repo view OWNER/NAME and the leaf help before using it.

Pull requests and reviews

Command	Subcommands
`pr`	`list`, `view`, `diff`, `current`, `create`, `edit`, `checkout`, `comment`, `update-branch`, `request-reviewers`, `remove-reviewers`, `review`, `dismiss-review`, `review-comments`, `reply-review-comment`, `delete-review-comment`, `changelog`, `set-changelog`, `status`, `merge`, `close`, `reopen`

Important behavior:

pr current exits nonzero when the current branch has no open pull request.
pr review requires exactly one of --approve, --request-changes, or --comment.
Inline --comments or --comments-file require --commit-id with the current pull request head SHA.
pr review-comments NUMBER resolve COMMENT_ID and unresolve COMMENT_ID change a native review conversation's state.
pr merge defaults to squash. Other supported methods are merge, rebase, rebase-merge, fast-forward-only, and manually-merged.
Merge, close, review dismissal, and review-comment deletion should be preceded by a fresh pr view or pr status check.

Issues

Command	Subcommands
`issue`	`list`, `view`, `create`, `edit`, `comment`, `comments`, `delete-comment`, `reaction`, `label`, `close`, `reopen`, `timeline`

Use issue label --add and --remove to preserve unrelated labels. --set replaces the complete label set.

try issue label NUMBER -R OWNER/NAME \
  --add triage \
  --remove needs-info

Pull request stacks

Command	Subcommands
`stack`	`create`, `track`, `log`, `next`, `prev`, `restack`, `sync`, `submit`

stack restack runs a Git rebase and can stop on conflicts. stack submit pushes the current HEAD to origin before creating a pull request when one does not already exist.

Organizations and profiles

Command	Subcommands	Purpose
`org`	`list`, `view`, `members`, `secret`, `variable`	Inspect organizations and manage organization Actions configuration
`org secret`	`list`, `get`, `set`, `delete`	Manage organization secrets
`org variable`	`list`, `get`, `set`, `delete`	Manage organization variables
`profile`	`view`, `follow`	Inspect or follow a Trylle user

SSH keys

Command	Subcommands
`ssh-key`	`list`, `add`, `delete`

try ssh-key list
try ssh-key add "Work laptop" "$(cat ~/.ssh/id_ed25519.pub)"

The CLI has no GPG command. Register and manage GPG keys through the platform as described in the security documentation.

CI and Actions configuration

Command	Subcommands	Purpose
`ci`	`list`, `view`, `logs`, `watch`, `cancel`, `usage`	Inspect jobs, follow logs, wait for completion, cancel runs, and read usage
`actions secret`	`list`, `get`, `set`, `delete`	Manage repository or organization secrets
`actions variable`	`list`, `get`, `set`, `delete`	Manage repository or organization variables

The actions commands default to repository scope and accept --org ORG for organization scope. The equivalent organization-first forms are try org secret and try org variable.

Secret values are positional arguments to set. Supply them from a protected environment variable and disable shell tracing so expanded values do not enter logs.

Automations and bots

Command	Subcommands	Purpose
`automation`	`list`, `runs`, `enable`, `disable`	Inspect and toggle existing automation definitions
`bot`	`list`, `token`	Inspect existing bot identities and print or mint a bot token

The CLI does not create automation definitions or bot identities. Use the platform for creation, then operate existing resources from the CLI. bot token can return secret material and should not be sent to an ordinary log.

Web links and raw API access

Command	Subcommands	Purpose
`browse`	`repo`, `pr`, `issue`	Print and open a Trylle web URL
`api`	None	Call an uncovered public Trylle API endpoint

browse opens the URL after printing it. Add --no-open when a human needs the URL without launching a browser:

try browse repo -R OWNER/NAME --no-open
try browse pr NUMBER -R OWNER/NAME --no-open

Use api only when no first-class command covers the operation. It supports GET, POST, PUT, PATCH, and DELETE, query fields, typed or raw body fields, and a JSON input file. Call documented public /v1 paths rather than guessing private platform endpoints.

Local AI, agents, and review tools

Command	Subcommands or aliases	Purpose
`ask`	Alias: `ai`	Ask a direct AI provider to propose and optionally execute a shell command
`agent`	None	Run Codex CLI, Claude CLI, or OpenCode CLI in the current context
`skill`	`install`, `update`, `uninstall`, `path`	Manage the Trylle Agent Skill for supported local agents
`explain`	None	Explain a working tree, commit, range, or pull request with a direct AI provider
`draft`	`branch`	Draft a commit message or branch name and optionally create it
`diff`	Aliases: `d`, `review`, `r`	Open the interactive diff viewer or emit a unified diff for automation

Direct AI and local-agent credentials are separate from the Trylle platform credential. See AI and agent commands and Diff reviews for configuration and safety details.

CLI metadata and updates

Command	Subcommands	Purpose
`about`	None	Print copyright, license, and community information
`version`	`check`, `update`	Print the version, query the package registry, or update the installation

version update understands npm, uv, and Homebrew-managed installs. On a local or Cargo-built binary it switches to the canonical scoped npm package; use Cargo directly if you want to remain source-built.

Capabilities outside the CLI

The following platform capabilities do not currently have first-class CLI commands:

Registering or deleting GPG keys.
Creating automation definitions.
Creating bot identities.
Installing the skill with try skill --agent cursor.
Synchronizing viewed-file state from the diff TUI to a pull request.

Use the linked platform guides rather than inferring an unsupported command.

CLI Command Reference

On this page