IDE
The CoDev Code extension for VS Code, Cursor, and other IDEs
CoDev Code integrates with VS Code, Cursor, or any IDE that supports a terminal. Just run codev in the terminal to get started.
Usage
- Quick Launch: Use
Cmd+Esc(Mac) orCtrl+Esc(Windows/Linux) to open CoDev Code in a split terminal view, or focus an existing terminal session if one is already running. - New Session: Use
Cmd+Shift+Esc(Mac) orCtrl+Shift+Esc(Windows/Linux) to start a new CoDev Code terminal session, even if one is already open. You can also click the CoDev Code button in the UI. - Context Awareness: Automatically share your current selection or tab with CoDev Code.
- File Reference Shortcuts: Use
Cmd+Option+K(Mac) orAlt+Ctrl+K(Linux/Windows) to insert file references. For example,@File#L37-42.
Installation
Prerequisite
The extension drives the CoDev Code CLI under the hood, so you need the codev command installed first. Install CoDev Code if you haven't already.
Download the .vsix package and install it manually. This works in VS Code and popular forks like Cursor, Windsurf, and VSCodium.
Then install it from the IDE or the command line.
Install from the IDE
- Open the Extensions view —
Cmd+Shift+X(Mac) orCtrl+Shift+X(Windows/Linux). - Click the
···menu at the top of the panel and choose Install from VSIX…. - Select the
codev-code-1.18.3-2.vsixfile you downloaded. - Reload the window if prompted.
Install from the command line
Point the code CLI at the downloaded file:
code --install-extension ~/Downloads/codev-code-1.18.3-2.vsixFor a fork, swap code for its CLI — cursor, windsurf, or codium.
If you want to use your IDE when you run /editor or /export from the TUI, set export EDITOR="code --wait". Learn more.
Troubleshooting
If the code command isn't found:
- Confirm the CLI for your IDE is installed:
- For VS Code:
codecommand - For Cursor:
cursorcommand - For Windsurf:
windsurfcommand - For VSCodium:
codiumcommand - If not, run
Cmd+Shift+P(Mac) orCtrl+Shift+P(Windows/Linux) and search for "Shell Command: Install 'code' command in PATH" (or the equivalent for your IDE).
- For VS Code:
- Ensure your IDE has permission to install extensions.