CLI Commands Reference

The anyy command opens the TUI when run without a subcommand. Its public commands configure and operate the selected Profile and resident Gateway.

Global Entry Point

anyy [--profile NAME] [--profile-root PATH] [--role ROLE]
anyy [--profile NAME] [--profile-root PATH] [--role ROLE] COMMAND
anyy --version
anyy --resume SESSION_ID

Invocation selectors such as --profile, --profile-root, --role, and --no-color appear before the command. Command-specific --home and --socket flags appear after the subcommand that accepts them.

Flag	Purpose
--profile NAME	Select a named Profile
--profile-root PATH	Override the Profile manager's base root
--role ROLE	Select the Role for this invocation
--resume ID	Open a known session in the TUI
--home PATH	Override Anyy home after a command that accepts it
--socket PATH	Connect to an explicit Gateway socket after a command that accepts it
--no-color	Disable colored terminal output
--version	Print version information

Use anyy COMMAND --help for the exact flags supported by the installed version.

Chat and Health

anyy / --resume

anyy
anyy --resume SESSION_ID

Open the Terminal Interface, optionally resuming one session.

anyy chat

anyy chat [--home PATH] [--socket PATH] [--role ROLE] \
  [--session ID] [--json] [--yes] PROMPT

Send one prompt through an already running resident Gateway. --session continues a known session. --yes approves supported pending approvals and should be used only when the task and effects are trusted.

anyy status

anyy status [--home PATH] [--socket PATH] [--json]

Report selected Profile/Gateway/runtime status.

anyy doctor

anyy doctor [--home PATH] [--config PATH] [--json]

Run configuration and runtime diagnostics.

anyy config

anyy config [--home PATH] [--config PATH]

Show the configuration dashboard in the terminal: paths, provider/model, endpoint, and credential-reference status. This command does not edit configuration or reveal secret values.

Setup and Models

anyy setup

anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
  [--set INPUT=VALUE] [--sensitive-fd INPUT=FD] \
  [--external-locator-fd INPUT=FD]

Run the interactive full/quick setup or a focused model/channel flow. See Setup.

anyy tools

anyy tools [--home PATH] [--probe]
anyy tools list [--home PATH]
anyy tools websearch [--home PATH]
anyy tools image [--home PATH] [--probe]
anyy tools image understanding [--home PATH] [--probe]
anyy tools image generation [--home PATH] [--probe]
anyy tools video [understanding] [--home PATH] [--probe]
anyy tools voice [--home PATH] [--probe]
anyy tools voice tts [--home PATH] [--probe]
anyy tools voice stt [--home PATH] [--probe]

Configure optional web, image, video, and voice capability backends.

Gateway and Dashboard

anyy gateway

anyy gateway start [--home PATH]
anyy gateway restart [--home PATH]
anyy gateway status [--home PATH]
anyy gateway stop [--home PATH]

Manage the resident Gateway background service.

anyy dashboard

anyy dashboard [--home PATH] [--socket PATH] [--listen ADDR] [--no-open]
anyy dashboard --status
anyy dashboard --stop

Start, inspect, or stop the on-demand Dashboard sidecar. See Dashboard.

Messaging

anyy channel

anyy channel doctor CHANNEL [--home PATH] [--socket PATH] [--json]
anyy channel pairing list [--channel CHANNEL] [--account ACCOUNT] [--all] [--json]
anyy channel pairing approve --request REQUEST
anyy channel pairing approve --prompt-code --channel CHANNEL --account ACCOUNT
anyy channel pairing approve --code-stdin --channel CHANNEL --account ACCOUNT
anyy channel pairing reject --request REQUEST
anyy channel pairing revoke --grant GRANT [--reason TEXT]
anyy channel reload [--home PATH] [--socket PATH] [--json]

Diagnose Channels, decide pairing requests, revoke grants, and reload runtime configuration. See Messaging Platforms.

Browser

anyy browser

anyy browser status [--home PATH] [--socket PATH] [--json]
anyy browser doctor [--home PATH] [--socket PATH] [--json]
anyy browser connect [--browser NAME] [--headless] [--yes] [--home PATH] [--socket PATH]
anyy browser connect --url URL
anyy browser connect --backend agent-browser [--args ARG[,ARG...]]
anyy browser disconnect [--home PATH] [--socket PATH]
anyy browser enable [--browser NAME] [--headless] [--yes] [--home PATH] [--socket PATH]
anyy browser enable --backend playwright-mcp --url URL
anyy browser enable --backend agent-browser [--args ARG[,ARG...]]
anyy browser disable [--home PATH] [--socket PATH]

Connect or configure a browser backend. Local isolated-browser connection requires explicit confirmation. Run anyy browser --help for backend-specific compatibility options.

Skills and MCP

anyy skills

anyy skills list [--home PATH] [--json]
anyy skills view [--home PATH] [--json] NAME [FILE_PATH]
anyy skills install [--home PATH] [--name NAME] [--force] [--all] [--now] [--json] SOURCE
anyy skills uninstall [--home PATH] [--now] [--json] NAME
anyy skills rollback [--home PATH] [--revision REVISION_ID] [--now] [--json] NAME
anyy skills reload [--home PATH] [--socket PATH] [--json]

Inspect, install, remove, roll back, and reload Skills.

anyy mcp

anyy mcp add SERVER_ID [--home PATH] --transport stdio --command CMD [--env KEY=VALUE] [--no-discover] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --command CMD --enable --include a,b [--activate-toolset] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --url URL [--transport http] [--auth oauth|header|none] [--header KEY=VALUE] [--enable --include a,b]
anyy mcp add SERVER_ID [--home PATH] --preset filesystem [-- ARG...]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--include a,b] [--enable] [--activate-toolset]
anyy mcp login SERVER_ID [--home PATH] [--json]
anyy mcp remove SERVER_ID [--home PATH] [--force]
anyy mcp enable SERVER_ID [--home PATH]
anyy mcp disable SERVER_ID [--home PATH]
anyy mcp set SERVER_ID KEY VALUE [--home PATH]
anyy mcp unset SERVER_ID KEY [--home PATH]
anyy mcp status [--home PATH] [--socket PATH] [--json]
anyy mcp list [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER.TOOL [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER_ID TOOL_NAME [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp show SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp probe SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp test SERVER_ID [--home PATH] [--socket PATH]
anyy mcp reload [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp logs [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp serve [--home PATH] [--socket PATH]

Manage stdio or HTTP MCP servers, authentication, exposed tools, runtime status, and direct calls. Run anyy mcp --help before adding a server; transport flags differ.

Automation

anyy cron

anyy cron list [--home PATH] [--include-disabled] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE [--execution-mode approval|yolo] [--json]
anyy cron update [--home PATH] --id ID [--enable|--disable] [--schedule SCHEDULE] [--prompt TEXT] \
  [--execution-mode approval|yolo] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron delete [--home PATH] --id ID [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]

List and manage scheduled prompts. Review yolo schedules carefully because they can run without an interactive approval.

anyy heartbeat

anyy heartbeat status [--home PATH] [--json]

Report resident heartbeat state.

Profiles and Roles

anyy profile

anyy profile list [--json]
anyy profile get NAME [--json]
anyy profile create NAME [--display-name NAME] [--json]
anyy profile use NAME [--json]
anyy profile delete NAME --force [--purge-secrets] [--json]

Manage isolated Profile homes. Delete is destructive and requires --force.

anyy role

anyy role list [--home PATH] [--include-archived] [--json]
anyy role get [--home PATH] ROLE_ID [--json]
anyy role create [--home PATH] ROLE_ID [--display-name NAME] [--json]
anyy role update [--home PATH] ROLE_ID [--display-name NAME] [--soul-file PATH] [--json]
anyy role use [--home PATH] ROLE_ID [--json]
anyy role delete [--home PATH] ROLE_ID [--json]

Inspect and manage assistant Roles and Soul content.

Advanced Prompt Evaluation

anyy prompt eval

anyy prompt eval [--output PATH] [--json]
anyy prompt eval local --authorize-live [--home PATH] [--output PATH]
anyy prompt eval live --manifest PATH --authorize-live --credential-env NAME
anyy prompt eval tui [--mode collect|finalize-grades|finalize-report] ...

The default command runs offline prompt-program gates and writes an immutable local report. local uses the active Profile's selected provider/model for real calls and writes a private comparison report; it refuses to run without --authorize-live.

live validates an exact-target manifest and credential environment for an authorized external evaluation runner; it does not itself execute that runner. tui is the qualification workflow for collecting and finalizing pinned comparison artifacts. Its required files vary by mode, so use anyy prompt eval tui --help rather than copying a partial command.

Evaluation can be billable

local and TUI collect make real model calls. Inspect the selected Profile, target files, credential environment, and output location before adding --authorize-live.

Backup, Maintenance, and Release Lifecycle

anyy backup

anyy backup create [--home PATH] [--output PATH] [--include-secrets] [--json]
anyy backup restore --archive PATH --target-home PATH [--json]
anyy backup list [--home PATH] [--json]

Create, list, or restore Profile backups. Secrets are excluded unless --include-secrets is explicit.

anyy maintenance

anyy maintenance compact-state [--home PATH] (--output PATH | --replace) [--temp-dir PATH] [--json]
anyy maintenance checkpoint-state [--home PATH] [--json]
anyy maintenance cache-token-estimates [--home PATH] [--limit N] [--execute] [--json]

Perform state-database and token-estimate maintenance. Commands that replace state should be preceded by a verified backup.

anyy update

anyy update [--home PATH] [--version VERSION] [--base-url URL]
anyy update --compact [--home PATH] [--version VERSION] [--base-url URL]
anyy update --check [--home PATH] [--version VERSION] [--base-url URL]

Check or update a native resident installation. See Updating & Uninstalling.

anyy uninstall

anyy uninstall
anyy uninstall --keep-data --yes
anyy uninstall --full --yes

Remove a native resident installation. --full also removes all Anyy data in scope; back up first.