Command Reference

The geoff command launches an interactive session, runs a single prompt, or invokes a subcommand.

geoff [options] [command]

Run geoff --help for inline help, or geoff <command> --help for a specific subcommand.

Global options

These apply to the root geoff command (interactive and prompt modes).

Option	Description
`-S, --session [id]`	Resume a session. With an ID, resume that session; without one, open an interactive picker.
`-r, --resume [id]`	Hidden alias for `--session`.
`-C, --continue`	Continue the previous session for the working directory.
`-m, --model <model>`	Model alias for this invocation. Defaults to `default_model` in `config.toml`.
`-k, --api-key <key>`	API key for this invocation. Sets `GEOFF_API_KEY` for Geoff providers; not persisted to config.
`-p, --prompt <prompt>`	Run one prompt non-interactively and print the response.
`--output-format <format>`	Output format for prompt mode: `text` (default) or `stream-json`.
`-y, --yolo`	Automatically approve all actions.
`--auto`	Start in auto permission mode.
`--plan`	Start in plan mode (read-only tools).
`--skills-dir <dir>`	Load skills from this directory instead of auto-discovered ones. Repeatable.
`-V, --version`	Print the version.
`-h, --help`	Show help.

`-k, --api-key`

Use an API key for a single run without writing it to disk. It sets GEOFF_API_KEY for Geoff providers during that invocation only:

geoff --api-key sk-geoff-... -p "Explain the build pipeline."

For a persistent key, set the GEOFF_API_KEY environment variable or add api_key to a provider in config.toml.

Prompt mode

-p runs one turn and exits. Pair it with --output-format stream-json for machine-readable output (see Wire Mode) and -y to auto-approve every action:

geoff -p "Add a CHANGELOG entry for the current version." -y
geoff -p "List TODOs in src/." --output-format stream-json

Subcommands

Authenticate with Geoff Code via the device-code flow.

geoff login

Prints a verification URL and code; sign in via your browser. Credentials are stored under ~/.geoff.

geoff doctor

Validate Geoff Code configuration files. With no arguments, checks both config.toml and tui.toml.

geoff doctor                 # validate both files
geoff doctor config [path]   # validate config.toml (or a file at <path>)
geoff doctor tui [path]      # validate tui.toml (or a file at <path>)

Exits non-zero and prints the validation issues if a file is invalid.

geoff export

Export a session as a ZIP archive.

geoff export [sessionId]

Option	Description
`sessionId`	Session ID to export. Defaults to the most recent session.
`-o, --output <path>`	Output ZIP path.
`-y, --yes`	Skip the previous-session confirmation.
`--no-include-global-log`	Skip bundling the active global diagnostic log (`~/.geoff/logs/geoff-code.log`). Included by default.

geoff acp

Run Geoff Code as an Agent Client Protocol (ACP) server over stdio, for editor and IDE integrations.

geoff acp
geoff acp --login   # run the device-code login flow, then exit

Option	Description
`--login`	Run the device-code login flow then exit (entry point for ACP terminal-auth).

geoff migrate

Migrate data from a legacy geoff-cli installation into Geoff Code. Launches an interactive migration screen.

geoff migrate

geoff upgrade

Upgrade Geoff Code to the latest version.

geoff upgrade

Slash commands

Inside an interactive session, type / to access slash commands. A selection of the most useful:

Command	Description
`/help`	List available commands.
`/init`	Analyze the project and write an `AGENTS.md` summary.
`/login` · `/logout`	Manage authentication.
`/new` · `/clear`	Start a fresh session (`/clear` is an alias for `/new`).
`/sessions`	List and switch sessions.
`/compact`	Summarize the conversation to reclaim context.
`/undo`	Revert the agent’s last change.
`/fork`	Branch the current session into a new one.
`/model`	Switch the active model.
`/mcp-config`	Add, edit, or log in to MCP servers.
`/plugins`	Install and manage plugins.
`/skill:<name>`	Activate a skill.
`/swarm`	Launch a coordinated swarm of agents.
`/plan`	Toggle plan mode.
`/yolo` · `/auto`	Change the permission mode.
`/theme` · `/editor`	Adjust TUI preferences.
`/status` · `/usage`	Show session status and token usage.
`/exit`	Quit.

Config Files

Set defaults the flags above override.

Wire Mode

Streaming JSON and ACP details.

Getting Started

Extending

Reference

Global options

`-k, --api-key`

Prompt mode

Subcommands

geoff doctor

geoff export

geoff acp

geoff migrate

geoff upgrade

Slash commands

Config Files

Wire Mode

​Global options

​-k, --api-key

​Prompt mode

​Subcommands

​geoff login

​geoff doctor

​geoff export

​geoff acp

​geoff migrate

​geoff upgrade

​Slash commands

​Related

Config Files

Wire Mode

Global options

`-k, --api-key`

Prompt mode

Subcommands

geoff login

geoff doctor

geoff export

geoff acp

geoff migrate

geoff upgrade

Slash commands

Related