e4d91aadf9
- Full Obsidian vault content - Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte) - Media stack documentation - Traefik HA setup - Automation scripts - Bachelor party planning
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
---
|
||
type: agent-doc
|
||
agent: OpenCode
|
||
source: https://opencode.ai/docs/ide/
|
||
scraped: 2026-04-28T21:02:07.880123+00:00
|
||
content_hash: 55751af4
|
||
---
|
||
# IDE
|
||
|
||
The OpenCode extension for VS Code, Cursor, and other IDEs
|
||
|
||
OpenCode integrates with VS Code, Cursor, or any IDE that supports a terminal. Just run opencode in the terminal to get started.
|
||
|
||
---
|
||
|
||
## Usage
|
||
|
||
- Quick Launch: Use Cmd+Esc (Mac) or Ctrl+Esc (Windows/Linux) to open OpenCode in a split terminal view, or focus an existing terminal session if one is already running.
|
||
- New Session: Use Cmd+Shift+Esc (Mac) or Ctrl+Shift+Esc (Windows/Linux) to start a new OpenCode terminal session, even if one is already open. You can also click the OpenCode button in the UI.
|
||
- Context Awareness: Automatically share your current selection or tab with OpenCode.
|
||
- File Reference Shortcuts: Use Cmd+Option+K (Mac) or Alt+Ctrl+K (Linux/Windows) to insert file references. For example, @File#L37-42.
|
||
|
||
---
|
||
|
||
## Installation
|
||
|
||
To install OpenCode on VS Code and popular forks like Cursor, Windsurf, VSCodium:
|
||
|
||
1. Open VS Code
|
||
2. Open the integrated terminal
|
||
3. Run opencode - the extension installs automatically
|
||
|
||
If on the other hand you want to use your own IDE when you run /editor or /export from the TUI, youâll need to set export EDITOR="code --wait". Learn more.
|
||
|
||
---
|
||
|
||
### Manual Install
|
||
|
||
Search for OpenCode in the Extension Marketplace and click Install.
|
||
|
||
---
|
||
|
||
### Troubleshooting
|
||
|
||
If the extension fails to install automatically:
|
||
|
||
- Ensure youâre running opencode in the integrated terminal.
|
||
- Confirm the CLI for your IDE is installed: For VS Code: code command For Cursor: cursor command For Windsurf: windsurf command For VSCodium: codium command If not, run Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for âShell Command: Install âcodeâ command in PATHâ (or the equivalent for your IDE)
|
||
- For VS Code: code command
|
||
- For Cursor: cursor command
|
||
- For Windsurf: windsurf command
|
||
- For VSCodium: codium command
|
||
- If not, run Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for âShell Command: Install âcodeâ command in PATHâ (or the equivalent for your IDE)
|
||
|
||
- Ensure VS Code has permission to install extensions
|