opencode-orca-hint

opencode plugin that tells the agent when it is running inside the Orca app, so it reaches for Orca's own tooling instead of falling back to raw shell workarounds.

Why

When opencode runs inside an Orca-managed environment, the agent often doesn't realize it has dedicated tooling available. Instead of using orca-cli and the orca-cli skill for Orca-managed state — worktrees, folder contexts, terminals, repos, automations, artifacts, worktree comments, and the browser embedded inside Orca — it reaches for ad hoc PTYs, git worktree, Playwright, or Computer Use.

This plugin detects the Orca environment and injects a short hint into the system prompt, so the agent routes Orca-related work through Orca's CLI and skills.

How it works

• Detects the environment through environment variables exported by the Orca app (ORCA_CLI_COMMAND, ORCA_DEV_REPO_ROOT, or any ORCA_* variable).
• When detected, appends a few lines to the system prompt via the experimental.chat.system.transform hook.
• When not detected, the plugin is a no-op — no overhead in regular terminals.

Install

opencode plugin install opencode-orca-hint

Or add it to the plugin array in your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-orca-hint"]
}

Restart opencode after installing.

Verify

Inside Orca's terminal, open opencode and ask:

Paraphrase what your system prompt says about what environment you are running in.

It should answer that it is running inside the Orca app, not a standalone terminal, and mention orca-cli. Repeat the same question in a regular terminal — there it should not mention Orca at all.

Requirements

• opencode ^1.0.0

License

MIT