CoDev
Dashboard

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.

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.4-5.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.4-5.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.4-5.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.

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.

Drag and drop files

Dropping a file onto the CoDev Code terminal in the editor area opens it in a new tab instead of sending it to CoDev Code — VS Code's editor group handles the drop first. Two ways to get the file through:

  1. Hold Shift while dropping. With Shift held, VS Code routes the drop to the terminal instead of the editor group — the file's path is inserted into the codev prompt, and the TUI attaches it. This works for drags from the Explorer, from another tab, or from Finder.
  2. Move the terminal to the bottom panel. Right-click the codev tab → "Move Terminal into Panel" (or drag it down). Drops onto panel terminals insert the path directly, no Shift required.