Spawns a new OpenCode CLI session and starts the initial task. Returns session_id and events_log_path. After starting, use a persistent background notification watcher on to receive events (running, idle, waiting_input, done, stale, contract_violated). Call opencode_read when notified, then opencode_kill when done.

Returns the last 200 lines of buffered output and current session status.

Sends raw text or keystrokes to the PTY. Supports , , , , , , , , .

Sends a command or text to OpenCode and submits it with Enter.

Returns the current status of a session: running, idle, waiting_input, stale, done, error, contract_violated, or starting.

Terminates a session and frees all its resources.

Lists all tracked OpenCode sessions with their IDs, tasks, statuses, and active status.

Switches the active session to the specified session ID.

Returns the ID and status of the currently active session.

Dynamically switches the AI model on an active or idle session for subsequent prompts.

Returns a full health report for a session: status, uptime, last activity, output line count, recovery attempts, contract violations, file change count, and operation log count.

Returns the operation log and file changes tracked for this session.

Returns change metadata for a specific file tracked during the session.

Sends Ctrl+C to interrupt the task, returns the final output buffer and reason.

Saves a checkpoint snapshot of session state WITHOUT interrupting it.

Loads a saved checkpoint and spawns a new session continuing from that state.

Lists all saved checkpoints sorted by recency.

Queries OpenCode model and statistics information.

Classifies a task to decide whether to delegate to OpenCode, recommended model, and strategy.

Starts up to 3 parallel OpenCode sessions with dependency support.

Returns status for a batch of session IDs.

Returns recent bridge log entries.

Gets or sets the delegation toggle ('on' | 'off').

Gets or updates configuration options (effort_level, default_model, default_agent).

One-time setup: writes OpenCode subagent guidelines to local workspace and user home profile directory.

Reports the state of the underlying opencode serve process itself (pid, port, alive, HTTP-healthy, whether an automatic recovery is in progress) — distinct from opencode_health, which reports a single session's state.

Forcibly restarts the underlying opencode serve process. Disruptive: every in-flight session on that process is interrupted. Normally unnecessary — the bridge restarts automatically when it detects a wedged or failed session — use this only to force a clean process explicitly (e.g. right after fixing provider auth).

Returns the complete behavioral guide for using opencode-mcp-bridge correctly — when to delegate, model selection, the async event-driven workflow, batch/dependency orchestration, guardrails, and how to diagnose a failed session. Call this first before delegating a task through OpenCode.