Terminal Interface
Run anyy with no command to open the interactive terminal interface (TUI):
anyy
It provides persistent chat, streaming tool activity, session selection, provider/model controls, approvals, clarifications, Skills, and next-task queue controls without a browser.
Startup Behavior
On a fresh Profile, the TUI guides you into setup before chat. When the default Gateway socket is unavailable, it can start an in-process Gateway for the TUI session and stop that in-process runtime when you exit.
If you pass an explicit --socket, Anyy uses that socket and does not silently replace it with a local fallback:
anyy --socket /path/to/anyy.sock
For an always-on runtime used by Dashboard, messaging, or one-shot CLI calls, start the resident service instead:
anyy gateway start
Sending and Editing
| Key | Action |
|---|---|
Enter | Send |
Shift+Enter, Alt+Enter, or Ctrl+J | Insert a newline |
A single trailing \ + Enter | Replace the slash with a newline |
Ctrl+A / Home | Move to start |
Ctrl+E / End | Move to end |
Ctrl+U | Delete to start |
Ctrl+K | Delete to end |
Ctrl+W | Delete the previous word |
Ctrl+C while running | Interrupt the active turn |
Esc while running | Interrupt the active turn |
Ctrl+C with a draft | Clear the draft |
Ctrl+C on an empty idle composer | Exit |
Ctrl+D | Exit |
Type / to open command completion. Use the arrow keys to select a command and Enter to accept or run it.
Local Commands
These commands are handled directly by the TUI:
| Command | Purpose |
|---|---|
/help | Show TUI help |
/quit | Exit |
/new | Start a new session |
/status | Show current conversation status |
/usage | Show current provider usage and context |
/skills | Choose a Skill command to insert |
/yolo | Toggle yolo for this session |
/effort | Select reasoning effort for the session or save it as the default |
The live Gateway command catalog adds commands such as /sessions, /provider, and /model. Installed Skills can add more. Use /help and completion as the authoritative list for the running version.
Sessions
Use /sessions to open recent conversations, or launch a known session directly:
anyy --resume SESSION_ID
Use /new when you want a clean context. Session history is stored in the selected Profile, so changing --profile or --home changes the conversations you see.
Queue and Steer
If you submit while a turn is active, Anyy can place the input in the next-task queue. Press Ctrl+S to steer with the selected/drafted queue input when the interface offers that action. Steering redirects active work; a normal queued task waits for its turn.
Queue items can be selected, edited, retried, or canceled from the TUI. Keep corrections short and explicit so the active assistant can apply them without losing the original goal.
Approvals and Clarifications
When work requires authorization, the TUI opens an approval overlay. Review the proposed effect and choose only one of the decisions offered by the runtime.
Clarification overlays accept an offered option or a typed response. Esc or Ctrl+C closes ordinary overlays when allowed; an active execution can still require an explicit answer or interruption.
Provider, Model, and Effort
Use:
/provider
/model
/effort
The first two open live provider/model pickers. /effort changes the reasoning level supported by the current target and can optionally make it the default.
Changing effort invalidates the existing prompt cache for the session. Use /new when cache reuse and predictable input-token cost matter.
Non-Interactive Alternatives
Send one prompt through an already running resident Gateway:
anyy chat "Summarize today's priorities"
Use --json for machine-readable output. anyy chat does not start the resident Gateway for you.
Troubleshooting
| Problem | Fix |
|---|---|
| TUI opens setup | Complete model setup for the selected Profile |
| Explicit socket cannot connect | Correct --socket or start the Gateway that owns it |
One-shot anyy chat cannot connect | Run anyy gateway start first |
| A command is unknown | Type / or /help; availability depends on runtime and installed Skills |
| Sessions appear missing | Check --profile, --home, and /sessions |
Ctrl+C exits instead of interrupting | No active turn was running and the composer was empty |