blob: b2f7d1e10f4969d6a4192a0a4b238f967be7be1b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
---
title: IDE
description: 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
---
### 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)
- Ensure VS Code has permission to install extensions
|
