CLI Interface
The anyy command opens the TUI by default and also provides script-friendly commands for setup, diagnostics, administration, and one-shot conversations.
Start the Interactive Interface
anyy
Anyy resolves the active Profile, connects to its resident Gateway, and opens the terminal interface. Select another Profile or initial Role before the command:
anyy --profile personal --role research
Resume a known session directly:
anyy --resume SESSION_ID
See TUI for interactive commands and keyboard controls.
Send One Prompt
Use anyy chat when a shell script or another program needs one response without opening the TUI:
anyy chat "Summarize my current tasks"
Continue an existing conversation with --session:
anyy chat --session SESSION_ID "What should I do next?"
Use --json for machine-readable output. State-changing tool calls still follow the configured approval policy; --yes only applies where the command explicitly supports confirmation.
anyy chat sends the prompt through the resident Gateway. Check it with anyy gateway status if the command cannot connect.
Select the Right Profile
Global selection flags must come before the command:
anyy --profile work status
anyy --profile work chat "Show today's priorities"
| Flag | Purpose |
|---|---|
--profile NAME | Select a named Profile |
--profile-root PATH | Use a different root for named Profiles |
--role ROLE | Set the initial Role for a new session |
--home PATH | Point a supported command at one Profile home |
--socket PATH | Override the Gateway socket where supported |
--no-color | Disable colored terminal output |
Prefer --profile for normal daily use. Reserve --home and --socket for diagnostics or explicit nonstandard layouts.
Command Groups
| Goal | Command |
|---|---|
| Configure Anyy | anyy setup, anyy setup model, anyy setup channel |
| Inspect health | anyy status, anyy doctor, anyy config |
| Manage resident runtime | anyy gateway start|restart|status|stop |
| Open the web interface | anyy dashboard |
| Manage capabilities | anyy tools, anyy browser |
| Manage scheduled work | anyy cron, anyy heartbeat status |
| Protect and maintain data | anyy backup, anyy maintenance |
Run anyy --help for the installed catalog and anyy COMMAND --help before using unfamiliar flags.
Shell Scripting
Use JSON output where the command offers it:
anyy status --json
anyy backup list --json
anyy heartbeat status --json
JSON mode writes a single structured result and is the stable choice for parsing. Human output is designed for reading and may use symbols or color.
Troubleshooting
| Symptom | What to do |
|---|---|
anyy opens the wrong data | Put --profile NAME before the command and verify with anyy status |
| One-shot chat cannot connect | Run anyy gateway status, then anyy gateway start |
| A flag is rejected | Run the exact subcommand with --help; flags are not all global |
| A script breaks on formatted output | Use --json instead of parsing the human view |
For the full command inventory, see CLI Command Reference.