OpenCode cheatsheet

Binary-backed rows were checked against installed opencode v1.4.7 on 2026-08-18; docs-only rows reflect current OpenCode v1 documentation and may describe features added after that binary. The OpenCode GitHub repository is included as a second primary source. The config examples target v1, not the separate opencode2 beta.

Use the search box to find a command, flag, config key, or workflow; the full reference also works with JavaScript disabled.

Command drill

16 verified OpenCode commands. Read the task, type the command, press Enter. Every answer is on this page's tables - this drill only asks what the verified data already states.

Answer key - all 16 commands

1. Print the installed version. opencode --version
2. Remove OpenCode and its related files. opencode uninstall
3. Alias for provider login; choose a provider and authenticate. opencode auth login
4. List configured providers and credentials. opencode auth list
5. Interactively remove credentials for a configured provider. opencode auth logout
6. Start the TUI in the current directory. opencode
7. Continue the last session. opencode --continue
8. List saved sessions. opencode session list
9. Show available TUI commands and keybinds. /help
10. Add or authenticate an AI provider from the TUI. /connect
11. Browse available models. /models
12. Start a new session. /new
13. Open the session picker. /sessions
14. Compact the current session. /compact
15. Undo the last message or change. /undo
16. Redo an undone message or change. /redo

75 commands · verified against the installed binary v1.4.7 and the official docs · checked 2026-08-18 sourcesourcesourcesourcesourcesourcesourcesourcesourcesource

Install & authenticateStart & resume sessionsTUI commands & controlsAgents & modelsPermissions & safetyConfig & project rulesMCP serversPlugins & skillsHeadless, server & web

Install & authenticate

Put OpenCode on the path, update it, then connect a model provider.

Command	What it does	Notes
curl -fsSL https://opencode.ai/install | bash docs	Install the native CLI with the official installer.
brew install anomalyco/tap/opencode docs	Install the current Homebrew tap build on macOS or Linux.
npm i -g opencode-ai@latest docs	Install or update the npm distribution.
opencode --version	Print the installed version.
opencode upgrade [target]	Upgrade to the latest release or a specific target version.
opencode uninstall	Remove OpenCode and its related files.
opencode auth login	Alias for provider login; choose a provider and authenticate.	The canonical v1 command is also `opencode providers login`.
opencode auth list	List configured providers and credentials.	Alias: `opencode providers list`.
opencode auth logout	Interactively remove credentials for a configured provider.	Alias: `opencode providers logout`; choose the provider interactively.

Start & resume sessions

Launch the TUI in a project, choose its model or agent, and pick up where you left off.

Command	What it does	Notes
opencode	Start the TUI in the current directory.
opencode /path/to/project	Start the TUI for a specific project directory.
opencode --continue	Continue the last session.	Short form: `-c`.
opencode --session <id>	Continue a specific session by ID.	Short form: `-s`; combine with `--fork` to branch it.
opencode --fork --session <id>	Fork a session before continuing it.
opencode session list	List saved sessions.
opencode session delete <sessionID>	Delete a saved session.
opencode export [sessionID]	Export session data as JSON.
opencode import <file>	Import session data from a JSON file or URL.

TUI commands & controls

The slash commands and input conventions that make the terminal interface fast.

Command	What it does	Notes
/help	Show available TUI commands and keybinds.
/connect	Add or authenticate an AI provider from the TUI.
/models	Browse available models.
/new	Start a new session.
/sessions	Open the session picker.
/compact	Compact the current session.	Alias: `/summarize`; keybind: `ctrl+x c`.
/undo	Undo the last message or change.
/redo	Redo an undone message or change.
/export	Export the current conversation to Markdown and open it in the configured editor.
@path/to/file docs	Fuzzy-search for a file and attach its contents to the prompt.
!command !git status --short docs	Run a shell command and add its output to the conversation.
Tab docs	Switch between the built-in `build` and `plan` agents.	`@general` invokes the built-in general subagent in a prompt.

Agents & models

Choose the worker and the provider/model pair that should do the work.

Command	What it does	Notes
opencode --model <provider/model> opencode --model anthropic/claude-sonnet-4-5	Start the TUI with a fully qualified provider/model ID.
opencode --agent <name>	Start with a named agent.
opencode models [provider]	List available models, optionally filtered by provider.
opencode models --refresh	Refresh the model cache from models.dev.	Use `--verbose` to include metadata such as costs.
opencode agent list	List available built-in and custom agents.
opencode agent create	Interactively create a custom agent.
.opencode/agents/<name>.md docs	Project agent definition with YAML frontmatter and instructions.	Global agents live under `~/.config/opencode/agents/`.
opencode run --variant <name> "<prompt>"	Select a provider-specific model variant, such as a reasoning effort.

Permissions & safety

Decide which tools run automatically, ask first, or remain blocked.

Command	What it does	Notes
opencode --auto docs	Auto-approve requests that are not explicitly denied.	Current v1 docs feature; not advertised by installed v1.4.7. Explicit `deny` rules still win; `opencode run --auto` works too.
opencode run --dangerously-skip-permissions "<prompt>"	Auto-approve permissions that are not explicitly denied in a headless run.	Dangerous: use only in a deliberately isolated environment.
"permission": { "*": "ask", "bash": "allow", "edit": "deny" } docs	Set v1 global permission defaults in `opencode.json`.	Actions are `allow`, `ask`, or `deny`.
"permission": { "bash": { "*": "ask", "git *": "allow" } } docs	Use command patterns for granular bash permissions.
"permission": { "skill": { "internal-*": "deny" } } docs	Control which skills an agent may load by wildcard.
"agent": { "plan": { "permission": { "edit": "deny" } } } docs	Override permissions for one agent.	Agent rules take precedence over global rules.

Config & project rules

Know which JSON file wins and where to put durable project instructions.

Command	What it does	Notes
opencode.json docs	Project config, safe to check into the repository.	JSONC is also supported; add `$schema`: `https://opencode.ai/config.json`.
~/.config/opencode/opencode.json docs	Global user config for providers, models, permissions, and runtime defaults.
OPENCODE_CONFIG=/path/config.json docs	Load a custom config path.
OPENCODE_CONFIG_CONTENT={...} docs	Apply inline config at runtime.
opencode debug config	Print the resolved configuration after merging sources.
opencode debug paths	Show OpenCode data, config, cache, and state paths.
AGENTS.md docs	Project instructions OpenCode can use as durable context.	OpenCode also supports `CLAUDE.md` and configurable instruction files.
tui.json docs	Separate TUI settings such as theme, cursor, mouse, and attention notifications.

MCP servers

Connect external tools and context through Model Context Protocol servers.

Command	What it does	Notes
opencode mcp add	Interactively add a local or remote MCP server.
opencode mcp list	List configured MCP servers and their status.	Alias: `opencode mcp ls`.
opencode mcp auth [name]	Authenticate an OAuth-enabled MCP server.
opencode mcp logout [name]	Remove OAuth credentials for an MCP server.
opencode mcp debug <name>	Debug an MCP OAuth connection.
"mcp": { "my-server": { "type": "local", "command": ["npx", "-y", "example"] } } docs	Configure a local stdio server in v1 `opencode.json`.
"mcp": { "my-server": { "type": "remote", "url": "https://example/mcp" } } docs	Configure a remote HTTP MCP server.	Set `enabled: false` to keep a server configured but off.

Plugins & skills

Extend OpenCode in-process and give agents reusable, on-demand instructions.

Command	What it does	Notes
opencode plugin <npm-module>	Install a plugin and update config.	Use `--global` for global config or `--force` to replace an installed version.
"plugin": ["my-plugin"] docs	Load a plugin from the v1 config.
.opencode/skills/<name>/SKILL.md docs	Define a project skill with required `name` and `description` frontmatter.	Claude-compatible `.claude/skills/` and agent-compatible `.agents/skills/` paths are also discovered.
opencode debug skill	List all skills OpenCode can discover.
"permission": { "skill": { "*": "allow", "internal-*": "deny" } } docs	Allow, prompt for, or hide skills using wildcard permissions.
"agent": { "plan": { "tools": { "skill": false } } } docs	Disable the skill tool for an agent.	The v1 docs describe this alongside the permission system; use the agent override when only one agent should be restricted.
opencode --pure	Run without external plugins.

Headless, server & web

Use OpenCode in scripts, CI, remote clients, and browser-facing workflows.

Command	What it does	Notes
opencode run "<prompt>"	Run one prompt without opening the TUI.
opencode run --format json "<prompt>"	Emit raw JSON events for programmatic consumers.	Default output format is `default` (formatted).
opencode run --file src/app.ts "Review this file"	Attach one or more files to a run.	Short form: `-f`; repeat the flag for multiple files.
opencode run --attach http://localhost:4096 "<prompt>"	Send a run to an already-running OpenCode server.
opencode serve --port 4096	Start a headless OpenCode HTTP server.	Default hostname is `127.0.0.1`; use `--hostname` to change it.
opencode web --port 4096	Start the server and open the web interface.
opencode attach http://localhost:4096	Attach the TUI to a running server.
"server": { "port": 4096, "hostname": "0.0.0.0", "cors": ["http://localhost:5173"] } docs	Configure server listening and browser CORS in `opencode.json`.	mDNS is available with `mdns: true` and optional `mdnsDomain`.
opencode acp	Start an Agent Client Protocol server for compatible clients.

Official docs

• OpenCode , GitHub repository
• OpenCode , installed-version release
• OpenCode , CLI reference
• OpenCode , TUI guide
• OpenCode , configuration
• OpenCode , permissions
• OpenCode , MCP servers
• OpenCode , server

Specs evolve faster than chapters. Links checked 2026-08-18; when in doubt, the upstream wins.