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) or Ctrl+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) or Ctrl+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) or Alt+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.

Download codev-code-1.18.3-2.vsix

Then install it from the IDE or the command line.

Install from the IDE

  1. Open the Extensions view — Cmd+Shift+X (Mac) or Ctrl+Shift+X (Windows/Linux).
  2. Click the ··· menu at the top of the panel and choose Install from VSIX….
  3. Select the codev-code-1.18.3-2.vsix file you downloaded.
  4. 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.vsix

For 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: 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 your IDE has permission to install extensions.