opencode-ask-mode

Read-only Ask Mode plugin for OpenCode. Switch to Ask mode when you want to explore a codebase without risking accidental edits.

What it does

• Registers a new Ask agent as a primary mode (selectable in the mode switcher)
• Denies all file edits — cannot create, modify, or delete files
• Denies all shell commands — no bash, no terminal access
• Pure read-only: search, read, explain, answer questions

Installation

npm install -g opencode-ask-mode

Then add to your global opencode config (~/.config/opencode/opencode.json):

{
  "plugin": ["opencode-ask-mode"]
}

Restart opencode. The Ask mode will appear in your mode switcher.

Usage

Switch to Ask mode in the opencode TUI, or use /mode ask. The assistant can:

• Read files and search the codebase
• Explain how code works
• Look up documentation
• Help debug by reading error output

It cannot edit files, run commands, or create plans.

vs Plan Mode

| Feature | Ask Mode | Plan Mode | |---------|----------|-----------| | File edits | Denied | Denied | | Shell commands | Denied | Allowed | | Create plans | No | Yes | | Read code | Yes | Yes |

License

MIT