Cursor Integration

Cursor is a fork of VS Code, so the Callipso extension works the same way. The main difference is the installation path and the dedicated port (3002 instead of 3001).

Installation

From the marketplace

Open Cursor
Press Cmd+Shift+X to open the Extensions panel
Search for Callipso
Click Install

Manual installation

If the extension is not available in Cursor's marketplace, install it manually:

bash

# Download the .vsix from GitHub releases
# Then in Cursor:
# Cmd+Shift+P → "Extensions: Install from VSIX..."
# Select the downloaded .vsix file

Extension path

Cursor installs extensions to ~/.cursor/extensions/, not the VS Code path (~/.vscode/extensions/). When developing or debugging the extension, make sure you are editing files in the correct location.

Cursor-specific considerations

Port allocation

Cursor uses port 3002 for the Callipso extension, separate from VS Code's port 3001. This means you can run both VS Code and Cursor simultaneously with Callipso, and terminals from each IDE will be properly distinguished in the overlay.

AI features coexistence

Cursor has its own AI integration (Cursor Tab, Cmd+K, etc.). Callipso does not interfere with these features. The hotkeys are different and the systems operate independently:

Cursor AI — Built-in code completion and generation
Callipso — Voice-to-terminal routing (including to Claude Code sessions in Cursor's terminal)

You can use both simultaneously. A common workflow is to use Cursor's AI for inline code edits while using Callipso to voice-dictate prompts to a Claude Code session in Cursor's integrated terminal.

Multiple windows

If you have multiple Cursor windows open, each window's terminals are tracked separately. The Callipso overlay shows all terminals from all windows, with the window ID as a distinguishing attribute.

Verifying the connection

Open a terminal in Cursor (Ctrl+`` )
Check the Callipso overlay — the terminal should appear with a Cursor icon
Speak a test command and verify it appears in the terminal

bash

# If terminals don't appear, reload the Cursor window:
# Cmd+Shift+P → "Developer: Reload Window"

# Check extension status:
# Cmd+Shift+P → "Extensions: Show Running Extensions"

Configuration

The extension settings are the same as VS Code, accessible via Cursor's settings:

json

{
  "callipso.enabled": true,
  "callipso.port": 3002,
  "callipso.pollInterval": 1000
}

Port conflict

Do not change the Cursor port to 3001 — this would conflict with VS Code if both are running. Each IDE must use its assigned port.

Troubleshooting

The troubleshooting steps are identical to the VS Code guide. The most common issues are:

Extension not installed or disabled
Cursor window needs a reload
Callipso overlay not running

If the extension appears to be loaded but terminals are not discovered, check Cursor's developer console (Cmd+Shift+P > Developer: Toggle Developer Tools) for HTTP connection errors to localhost:3002.

VS Code

Overview