Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>OpenCodePilotNew to Visual Studio Code? Get it now.
OpenCodePilot

OpenCodePilot

Saleh Gholamian

|
1 install
| (0) | Free
Full graphical client for the OpenCode coding agent — streaming chat, tool activity, permissions, diffs, sessions and dynamic model selection, with first-class RTL/Persian support.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

OpenCodePilot

OpenCodePilot

A full graphical client for the OpenCode coding agent, inside VS Code and Cursor.

OpenCode remains the agent and execution engine — models, tools, permissions, file operations. OpenCodePilot becomes its IDE interface: streaming chat, live tool activity, permission approvals, diff review, session management, dynamic model selection, and first-class Persian/RTL support.

Works with any provider OpenCode supports — nothing is hard-coded. When OpenCode adds a new model tomorrow, it shows up in the picker automatically.


Highlights

  • Sidebar chat with real-time streaming, Markdown, syntax-highlighted code blocks, copy/retry/stop
  • Agent transparency — tool calls (reads, edits, searches, commands) as expandable cards; todos as a progress list
  • Permission requests surfaced safely — Allow / Always allow / Deny; nothing privileged runs silently
  • Diff review — per-session change lists wired into VS Code's native diff editor, plus revert / restore
  • Complete sessions UX — create, resume, rename, fork, share-link, delete, search history
  • Dynamic model & agent pickers straight from OpenCode's registry (OpenCode Zen, OpenRouter, OpenAI, Anthropic, GitHub Copilot, Ollama, …)
  • IDE context — attach current file, selection, or any workspace file via @ autocomplete or drag-and-drop
  • Project rules — discovers AGENTS.md hierarchies, injects directory-scoped rules, scaffolds new ones
  • RTL done right — Persian/Arabic input and responses render correctly; code, paths, URLs and diffs stay LTR

Prerequisites

  1. VS Code ≥ 1.90 (or Cursor, any recent version)
  2. The OpenCode CLI: curl -fsSL https://opencode.ai/install | bash (or npm i -g opencode-ai)
  3. At least one authenticated provider, e.g. opencode auth login

Install

From source (development)

git clone <repo-url> opencode-pilot
cd opencode-pilot
npm install
npm run compile
npx @vscode/vsce package --no-dependencies   # produces opencode-pilot-<version>.vsix
code --install-extension opencode-pilot-*.vsix        # VS Code
cursor --install-extension opencode-pilot-*.vsix      # Cursor

See INSTALL.md for detailed local-install instructions and PUBLISHING.md for Marketplace release steps.

Getting started

  1. Click the OpenCodePilot icon in the Activity Bar (or Cmd/Ctrl+Alt+O).
  2. The extension finds a running OpenCode server, or starts one for your workspace automatically.
  3. Type a task in any language and press Enter. Watch tools run, approve permissions, review diffs.

Keybindings

Command Keys
New session Ctrl/Cmd+Alt+N
Stop agent Ctrl/Cmd+Alt+.
Add selection as context Ctrl/Cmd+Alt+A
Keep the change at the cursor Ctrl/Cmd+Y while a reviewed diff is open
Undo the change at the cursor Ctrl/Cmd+N while a reviewed diff is open
Previous / next hunk Alt+Up / Alt+Down while a reviewed diff is open

All commands are also available under the OpenCodePilot: category in the Command Palette.

Composer tips

  • Type @ to fuzzy-reference workspace files as context
  • Type / to invoke OpenCode custom commands (/init, …)
  • Drag files from Explorer/Finder into the composer to attach them
  • Enter sends · Shift+Enter adds a newline · Esc dismisses popups

Settings (opencodePilot.*)

Setting Default Purpose
server.url (empty) Connect to an existing server instead of auto-discovery
server.executablePath opencode CLI binary used when starting a server
server.port 4096 Preferred port for auto-started servers
server.autoStart true Start a server when none is reachable
server.autoConnect true Connect when the sidebar opens
ui.defaultAgent (empty) Agent used for new prompts (e.g. build, plan)
ui.direction auto Force UI text direction
ui.notifications true Notify when long tasks finish outside the sidebar
composer.sendOnEnter true Enter sends. When off, Enter inserts a newline and Ctrl/Cmd+Enter sends
rules.autoInject true Attach applicable directory-scoped rules to prompts
debug false Verbose logging to the Output channel

OpenCode itself stays the source of truth for providers, keys, agents and permissions — configure those via opencode.json / opencode auth login.

How it connects

┌─────────────────────────── VS Code / Cursor ───────────────────────────┐
│  Sidebar Webview (Vue)    ⇄  Extension Host (controller)               │
│                                  │  typed intents / updates            │
│                                  ▼                                     │
│                    official @opencode-ai/sdk                           │
│                         HTTP + SSE events                              │
└────────────────────────────┬───────────────────────────────────────────┘
                             ▼
                 opencode serve  (spawned or existing)
              agent · tools · permissions · providers · storage

The extension never re-implements agent behavior. See ARCHITECTURE.md.

Development

npm install
npm run watch        # rebuild extension + webview on change
# press F5 in VS Code → Extension Development Host
npm test             # vitest unit suites
npm run smoke        # end-to-end check against a real `opencode serve`
npm run typecheck && npm run lint

Documentation

  • Architecture — components, event flow, security model
  • INSTALL.md — run/package/install locally in VS Code and Cursor
  • PUBLISHING.md — prepare and publish to the VS Code Marketplace
  • CHANGELOG.md

Known limitations

  • One OpenCode server serves one directory; multi-root workspaces use the first folder.
  • Real-time terminal mirroring of executed commands is on the roadmap (OpenCode exposes PTY endpoints).

License

MIT

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft