A lookup table for the terminal (TUI). For the step-by-step, see Use the TUI . Start the interface with imaginne (or imaginne chat); send with Enter .
Slash commands
Type / at the start of the message. Aliases are in parentheses.
Command Aliases Effect /help/h, /?Shows the help. /quit/q, /exitExits the TUI. /clear/clsClears the screen / the conversation. /context clear— Clears the context (resets the reasoning without erasing the transcript). /model/mOpens the model picker (filtered by policy). Default nnumbers. /autonomy/aAdjusts autonomy: low / medium / high. /verbose/vAdjusts verbosity: silent / medium / debug. /version— Shows the version. /update— Updates the binary. /diagnostics— Collects diagnostics. /status— Shows the current session status. /project/pProject operations. /skill/skillsManages skills (see subcommands). /sessions— Manages sessions (see subcommands). /plan— Enters Plan mode. /exe/executeEnters Execute mode. /ask— Enters Ask mode. /lang/language, /idiomaSwitches the language. /remote— Remote pairing (see subcommands). /init— Initializes the project. /iterate/iterIterates on the current task. /agent— Manages subagents (see subcommands). /login— Logs in via the browser. /logout— Logs out. /whoami— Shows your identity (without exposing your session). /policy— Shows the effective policy. /memory— Opens the project memory. /feedback/fbSends feedback. /todo— The session's task list.
/skill subcommands Subcommand Effect /skill listLists the available skills. /skill info <name>Details of a skill. /skill validate [path|key]Validates a skill's manifest. /skill groups [--search q]Lists the skill groups. /skill publish <key|--skill-path p> --group <slug|id> [--mode]Publishes a skill to a group. /skill statusThe skills' sync state.
/sessions subcommands Subcommand Effect /sessions listLists the sessions. /sessions new <title>Creates a session. /sessions switch <id>Switches session. /sessions archive <id>Archives a session. /sessions rename <id> <title>Renames a session.
/agent subcommands Subcommand Effect /agent listLists the subagents. /agent spawn <type> <task>Starts a subagent. /agent statusThe subagents' state. /agent cancel <id>Cancels a subagent. /agent metricsThe subagents' metrics. /agent costThe subagents' cost.
Subagent types: explorer, analyzer, reviewer, implementer, tester, refactorer, documenter.
/remote subcommands Subcommand Effect /remoteShows a pairing code (valid for 30s). /remote statusThe pairing state. /remote stopEnds the pairing.
Requires browser login. Open <host>/remote in the browser and paste the code. See Use remotely .
File mentions (@)
Form Effect @pathReads and injects the file's content inline. @"path with spaces"Path with spaces. @/abs/pathAbsolute path. @~/pathStarting from home .
It skips directories, binaries, and files larger than ~100 KB. Tab completes (path mode and fuzzy mode); ↑ /↓ navigate.
Keyboard shortcuts
Key Action Enter Sends the message. Esc Cancels; Esc Esc clears. Ctrl +C Exits. Ctrl +G / F2 Voice (depends on a build with the voice tag). Ctrl +A Autonomy. Ctrl +T Task panel. Ctrl +X Verbose. Ctrl +K Clears the screen. Ctrl +O Clears the context. Ctrl +Y / F1 Help. Shift +Tab Cycles the mode (Execute / Plan / Ask). Tab Completes (mentions and paths). PgUp / PgDn Scroll the viewport.
Binary subcommands
Command Effect imaginneOpens the chat (default). imaginne chatOpens the chat. imaginne versionShows the version. imaginne updateUpdates the binary. imaginne config initCreates the initial configuration. imaginne loginLogs in via the browser. imaginne logoutLogs out. imaginne whoamiShows the identity. imaginne password-loginPassword login (legacy). imaginne serveIDE mode (used by the VS Code extension).
Root flags
Flag Effect --config <path>Uses a specific configuration file. --dangerous-bypassEnables the dangerous_bypass execution mode (see Autonomy ). -v, --versionShows the version.
Client environment variables
See the full list, with voice and the installer, in Environment variables .
Variable Effect IMAGINNE_DANGEROUS_BYPASSFlags the dangerous execution mode at startup. IMAGINNE_DEBUGEnables debug logs. IMAGINNE_LEGACYTurns on legacy behaviors. IMAGINNE_TUI_LOCAL_STORE=offTurns off the local persistence of sessions. IMAGINNE_GLOBAL_SKILLS_DIROverrides the global skills directory.
Configuration (~/.imaginne/config.yaml)
A YAML file with permissions 0600. Main keys:
Key Default What for llm.modelnnumbersThe default model. llm.max_tokens16384The generation limit. llm.temperature0.7The temperature. memory.storage_path— The memory path.
The connection and the session are managed by login
The connection details and your authenticated session live in this file, but they are populated and maintained automatically by login — you don't need to (and shouldn't) edit them by hand.