Agent Approve for OpenCode

Mobile approvals, shared guardrails, and activity monitoring for OpenCode from your phone

OpenCode logo
GUICLIPlugin integration

Agent Approve gives you centralized control over OpenCode from your phone. Approve or deny actions from your iPhone or Apple Watch, with push notifications so you know when OpenCode needs input.

You get one shared set of guardrails, one activity history, and one approval workflow that works the same way across OpenCode, Cursor, Claude Code, Gemini CLI, Codex, OpenClaw, and Copilot. Integration is plugin-based, so it slots into OpenCode without changing your existing setup.

Install OpenCode

Quick start

1

Download Agent Approve from the App Store and complete onboarding.

2

Run npx agentapprove on your machine and select OpenCode.

3

The installer adds @agentapprove/opencode to your OpenCode plugin config automatically.

4

Scan the QR code to pair, then start using OpenCode.

Install command

npx agentapprove

Agent Approve config: ~/.agentapprove/

OpenCode hook config: ~/.config/opencode/opencode.json


Recommended configuration

  • The installer adds @agentapprove/opencode to your plugin config automatically. You can also run the installer again to update the plugin when a new version is available.
  • By default, OpenCode allows all operations without requiring explicit approval.

Capabilities

Approval requests
Follow-up commands
Voice input
Activity monitoring
Push notifications
MCP tool tracking

Good to know

1

Plugin-based integration – The installer adds @agentapprove/opencode to the plugin array in opencode.json and pins the dependency in package.json.

2

Event coverage – The plugin hooks into permission.ask, tool.execute.before, tool.execute.after, chat.message, event, and experimental.session.compacting.

3

Follow-up commands – Supported when OpenCode reaches its idle state: Agent Approve appends your reply back into the OpenCode TUI and submits it automatically.

4

Voice input – Continue an idle session from your phone without returning to the keyboard.

5

Bulk command parsing – Policy evaluation parses shell commands chained with && into individual sub-commands evaluated independently. A dangerous command like rm -rf hidden as the third step in a chain is caught even when the batch starts with safe commands.

6

Stay up to date – Run npx agentapprove again at any time to update the plugin to the latest version.


Use cases

Step away from the terminal and approve OpenCode actions from your phone instead of waiting at your desk.

Use the same policy rules across OpenCode, Cursor, Claude Code, Gemini CLI, Codex, and all your other coding agents.

When OpenCode goes idle, send a follow-up prompt from your phone so the session keeps moving.

Track OpenCode tool execution and permission decisions in the same history as your other agents.


Questions about OpenCode

A few common questions about how Agent Approve fits alongside OpenCode.