opencode

Files (3)

• SKILL.md
• openai.yaml · agents/
• docs.md · resources/auto/

SKILL.md (first lines)

# OpenCode Expert

Reference guide for OpenCode - the open-source AI coding agent.

## Quick Reference

| Task                  | Command/Action                         |
| --------------------- | -------------------------------------- |
| Start TUI             | `opencode`                             |
| Continue session      | `opencode -c` or `opencode --continue` |
| Run non-interactive   | `opencode run "message"`               |
| Start headless server | `opencode serve`                       |
| Web interface         | `opencode web`                         |
| Switch agent          | `Tab` key                              |
| File search           | `@` then type filename                 |
| Undo changes          | `/undo`                                |
| Redo changes          | `/redo`                                |
| Share conversation    | `/share`                               |
| Initialize project    | `/init`                                |
| Configure API keys    | `/connect`                             |

## Agents

OpenCode has two primary agents, switchable with `Tab`:

### Build Agent (Default)

- Full access to all tools
- Can edit files, run commands, make changes
- Use for active development work

### Plan Agent

- Read-only mode for analysis and exploration
- File edits and bash commands require approval (`ask` mode)
- Use for reviewing implementation strategy before changes

### Subagents

Invoke subagents with `@` mention:

- **@general** - Complex research and multi-step tasks with full tool access
- **@explore** - Fast read-only codebase searches and code questions

## Keyboard Shortcuts

| Key      | Action                               |
| -------- | ------------------------------------ |
| `Tab`    | Switch between Build and Plan agents |
| `@`      | Fuzzy file search                    |
| `Ctrl+C` | Cancel current operation             |

## Slash Commands

| Command    | Description                               |
| ---------- | ----------------------------------------- |
| `/connect` | Configure LLM provider API keys           |
| `/init`    | Initialize project and create `AGENTS.md` |
| `/undo`    | Revert recent changes (stackable)         |
| `/redo`    | Restore undone changes                    |
| `/share`   | Create shareable conversation link        |

## CLI Commands

### Interactive Mode

```bash
# Start TUI in current directory
opencode

# Start in specific project
opencode /path/to/project

# Continue previous session
opencode --continue
opencode -c

# Use specific session
opencode --session <id>
opencode -s <id>

# Start with specific model
opencode --model <model>
opencode -m <model>

# Start with specific agent
opencode --agent build
opencode --agent plan
```

### Non-Interactive Mode

```bash
# Run single prompt
opencode run "Fix the bug in auth.py"

# Run with file attachment
opencode run "Review this" --file README.md
opencode run "Review this" -f README.md

# Run and share result
opencode run "Explain this code" --share

# Run specific command
opencode run --command "npm test"
```

### Server Mode

```bash
# Start headless API server
opencode serve

# With custom port
opencode serve --port 3000

# With mDNS discovery
opencode serve --mdns

From MAHDTech/agent-skills, MIT.

More from MAHDTech/agent-skills