Reference
CLI Every 8gent command and flag, from 8gent --help on main.
8gent, 8gent-code and 8 are the same command. With no arguments it opens the workspace. 8gent --help prints this list.
8gent # open the workspace 8gent --provider=ollama --model=qwen3:14b 8gent --resume # resume the last session 8gent --resume= < name > # resume a named session 8gent --continue < i d > # resume by id or name 8gent --name= < name > # name this session 8gent --infinite # every tab starts in Infinite 8gent --yes # no setup questions, approve prompts Flag What it does -h, --helpHelp -v, --versionVersion --provider=<p>Use this provider --model=<m>Use this model --resume, --resume=<name>Resume the last or a named session --continue <id>Resume a session by id or name --name=<name>Name the session --infinite, -iStart in Infinite mode --yes, -yNon-interactive: no setup, approve prompts --fastStart on the fastest available model --jsonMachine-readable output, for commands that support it --cwd=<dir>Work in another directory --no-pet, --petTurn the macOS dock companion off, or start it on its own --rpcJSON-RPC 2.0 over stdin and stdout, no workspace --output-format stream-jsonWith run: one JSON event per line --text-toolsWith chat: drive a model without native tool calling through a text protocol. On automatically for Ollama, LM Studio and llama-server
Command What it does tuiOpen the workspace (the default) run <prompt>One-shot agent run chat <message>Send one message, print the reply. --stdin reads the message from a pipe infinite <task>Run a task in Infinite mode until done pipeline <task>Planner, engineer and judge on local models reviewReview the current git diff for bugs, security and style. --pr <n> reviews a pull request doctorCheck engines, models, tools and config statusFull system status updateUpdate to the latest release onboardRun setup again initCreate .8gent/ in the current directory permissionsmacOS: check Screen Recording and Accessibility for your terminal. --open opens the settings panes keys [reload|status|open]Edit ~/.8gent/keys.env, reload it, or list which keys are present install <preset>Install another agent CLI for /spawn export <id|--last>Export a session as a self-contained HTML file outline <file>Symbols in a file, with signatures symbol <file>::<name>Source of one symbol search <query>Search for symbols across files benchmarkRun the efficiency benchmarks petStart the macOS dock companion only rpcJSON-RPC 2.0 server over stdin and stdout mcp-server [--tools=safe]Serve 8gent's tools over MCP. See MCP publish <app-dir>Package an app for the marketplace (--out, --max-size, --strict-lint, --json)
Command What it does agent listRunning sub-agents agent spawn <persona> <task>Start a sub-agent agent kill <id>Stop one agent message <id> <msg>Send it a message agent auto [on|off]Allow automatic spawning agent statusOrchestration status
Command What it does session list [--limit=N]Recent sessions session resume <name-or-id>Resume one session checkpointSave a checkpoint session compactCompress history
Command What it does memory recall <query>Search memory memory remember <fact>Store a fact memory forget <id>Delete one memory statsMemory statistics
Command What it does preferences getShow all preferences set <key> <value>Set one: name, role, style, language, model, provider, voice, autonomy, branch-prefix preferences resetBack to defaults
Command What it does cron listJobs cron add <name> <schedule> <command>Add one cron remove <id>, cron enable <id>, cron disable <id>Manage one
Command What it does daemon runRun in the foreground daemon installInstall and start as a login service: launchd on macOS, systemd --user on Linux. No admin needed. (A Scheduled Task on Windows.) daemon uninstallStop and remove it daemon start, daemon stopStart or stop it daemon statusInstalled and running?
8gent chat " Fix the auth middleware " --json echo " Explain this code " | 8gent chat --stdin 8gent run " Add tests for src/slug.ts " --output-format stream-json 8gent session list --json --limit=5 8gent memory recall " auth " --json Exit codes: 0 success, 1 error, 2 sign-in required.