Skip to content

Terminal UI

Octipus includes two terminal clients:

ClientCommandPurpose
Chatbin/octi tuiStream a conversation and respond to permission prompts
Editorbin/octi editWork with a file tree, text buffer, and agent chat

Both connect to the backend gateway and pin the project context to the directory where the command is launched. Start a backend first with bin/octi start, or use bin/octi start tui to start and attach in one command.

The clients support streaming output, slash commands, file references, and interactive permission decisions. Exact keys and commands appear in the in-app help and can change during alpha. User overrides live in ~/.octipus/keybindings.json; repository defaults are documented in docs/TUI-EDITOR.md.

Tool requests marked ASK require an attended client decision. Unattended execution cannot silently approve them.