OpenCode Slash Commands: Complete TUI Reference (2026)

OpenCode is an open-source agentic terminal for working with LLMs on your codebase—supporting multiple providers, subagents, MCP servers, and a keyboard-first TUI. Beyond natural-language prompts, it exposes 17 built-in slash commands, custom markdown commands in .opencode/commands/, and @ / ! input patterns for file injection and shell passthrough.

Custom commands are defined in markdown with YAML frontmatter—you can override built-ins, pin agents and models per command, and force subagent invocation with subtask: true. This article is a complete reference from the official Commands and TUI documentation.

It is not a replacement for upstream docs. Use this as a map of the surface area and a workflow guide; verify behavior against opencode.ai/docs before you ship team runbooks.

Sister guides: Claude Code · Codex · Gemini CLI · Cursor CLI

TL;DR

Three input patterns: /, @, and !

OpenCode uses three prefixes with different roles—similar to Gemini CLI:

Configured reference aliases also appear in @ autocomplete—type @alias for a reference root or @alias/ to browse files inside it.

How slash commands fit a typical workflow

flowchart LR
  A[Setup /connect /init] --> B[Work /models custom cmds]
  B --> C[Context @files !shell]
  C --> D[Undo /undo /redo]
  D --> E[Share /share /export]
  E --> F[Sessions /new /sessions]

First session in a repo

During a task

Session control and undo

Git requirement: /undo and /redo use Git internally to manage file changes—your project must be a Git repository.

Export and share

Built-in slash commands (complete reference)

Every built-in command from the TUI documentation as of June 11, 2026.

Leader key: Default leader is Ctrl+x—many shortcuts require leader first (e.g. Ctrl+x then n for new session). Customize via tui.json keybinds.

Command palette: Ctrl+p opens the full command list beyond slash autocomplete.

Note: Custom commands with the same name override built-ins. If you define .opencode/commands/init.md, it replaces /init.

Custom slash commands (.md and JSON)

Custom commands are OpenCode's primary extensibility layer—repetitive prompts defined once, invoked with /command-name.

Scopes

Check project commands into Git for team workflows.

Markdown command example

Create .opencode/commands/test.md:

---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---

Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.

Invoke:

/test

JSON config alternative

{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    "test": {
      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "anthropic/claude-3-5-sonnet-20241022"
    }
  }
}

Frontmatter / JSON options

Agent behavior: If the specified agent is a subagent, the command triggers subagent invocation by default. Set subtask: false to disable. Set subtask: true to force subagent mode even when the agent is configured as primary.

Template placeholders

Component example:

---
description: Create a new component
---

Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.

/component Button

Coverage analysis example:

---
description: Analyze test coverage
---

Here are the current test results:
!`npm test`

Based on these results, suggest improvements to increase coverage.

Review with file reference:

---
description: Review component
---

Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.

Shell commands in templates run from the project root; output becomes part of the prompt.

At commands (@): file references

Example prompt:

How is auth handled in @packages/functions/src/api/index.ts?

OpenCode respects .gitignore for file filtering (similar to Gemini CLI's git-aware @ behavior).

Bash commands (!): shell passthrough

Unlike slash commands, ! patterns are message prefixes, not CLI meta-commands.

TUI configuration (tui.json)

TUI behavior is configured separately from opencode.json via tui.json or tui.jsonc:

{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "opencode",
  "leader_timeout": 2000,
  "keybinds": {
    "leader": "ctrl+x",
    "command_list": "ctrl+p"
  },
  "scroll_speed": 3,
  "diff_style": "auto",
  "mouse": true,
  "attention": {
    "enabled": true,
    "notifications": true,
    "sound": true
  }
}

Use OPENCODE_TUI_CONFIG for a custom config path. Disable keybinds by setting value to "none".

Notable keybinds beyond slash commands:

Full list: Keybinds documentation.

Four-way comparison: OpenCode vs Claude Code vs Codex vs Gemini CLI

Full references: OpenCode · Claude Code · Codex · Gemini CLI

Commands worth memorizing first

/connect                       # add provider + API key
/init                          # AGENTS.md guided setup
/models                        # pick model
/compact                       # free context mid-session
@src/main.ts Explain this file # attach code
!git diff                      # shell output in chat
/undo                          # revert last turn + files
/sessions                      # switch saved sessions
/share                         # share session link
/export                        # markdown export

Quick custom command starter

mkdir -p .opencode/commands
cat > .opencode/commands/plan.md << 'EOF'
---
description: Strategic plan only—no implementation
agent: plan
subtask: true
---

Create a step-by-step plan for: $ARGUMENTS
Do NOT write or modify code.
EOF

/plan Refactor the auth module

Related ExplainX guides

• Claude Code commands reference — Anthropic CLI
• Codex slash commands reference — OpenAI CLI
• Gemini CLI slash commands reference — Google CLI
• Cursor CLI slash commands reference — Cursor terminal
• What are agent skills? — skill patterns across hosts
• What is MCP? — MCP in OpenCode config
• Agent skills secure registry — OpenCode in the skills ecosystem
• Goal mode complete guide — /goal on Codex and Claude Code
• gstack skills factory — multi-CLI skill layouts

Primary sources: Commands — OpenCode Docs · TUI — OpenCode Docs · Keybinds

Summary

OpenCode's slash-command surface is lean on built-ins (17 commands) and deep on custom .md commands—with agent, model, and subtask overrides that none of the other three CLIs match one-to-one. The /undo / /redo pair with Git-backed file reversion is distinctive; so is subtask: true for context-isolated custom workflows.

Type /help or Ctrl+p to discover commands in your build. Treat opencode.ai/docs as source of truth; bookmark this guide alongside the Claude Code, Codex, Gemini CLI, and Cursor CLI references for cross-platform work.

Command names, keybinds, and custom command syntax reflect OpenCode documentation as of June 11, 2026. Re-check opencode.ai/changelog before documenting internal runbooks.