VS Code Integration

The Callipso VS Code extension provides the deepest integration with Callipso. It enables terminal discovery, voice routing, focus tracking, and Claude Code session management.

Installation

From the marketplace

1. Open VS Code
2. Press Cmd+Shift+X to open the Extensions panel
3. Search for Callipso
4. Click Install

From the command line

code --install-extension colinmignot.callipso

Manual installation

Download the .vsix file from callipso.dev/download and install it:

code --install-extension callipso-0.1.0.vsix

Verifying the connection

After installing the extension and launching Callipso:

1. Open a terminal in VS Code (Ctrl+`` )
2. Check the Callipso overlay — your terminal should appear in the terminal list
3. The terminal entry shows the IDE icon, terminal name, and index

If the terminal does not appear, try:

# Reload the VS Code window
# Cmd+Shift+P → "Developer: Reload Window"

# Check that the extension is active
# Cmd+Shift+P → "Extensions: Show Running Extensions"
# Look for "Callipso" in the list

Features

Terminal list sync

The extension polls VS Code's terminal API every second and sends the list to Callipso. Each terminal is identified by:

• Name — The terminal's display name (e.g., "bash", "zsh", "node")
• Index — The terminal's position in VS Code's terminal list
• Active state — Whether the terminal currently has focus
• Process ID — The shell process ID (used for session matching)

Voice text delivery

When you speak and trigger the routing hotkey, Callipso tells the extension which terminal to target. The extension calls:

terminal.sendText(transcribedText, false)

The false parameter means the text is typed but not automatically followed by Enter. This gives you a chance to review the transcription before executing.

Claude Code session detection

The extension detects Claude Code sessions by monitoring terminal output. When a Claude Code session starts, its session ID is extracted and registered with Callipso. This enables session-aware routing that prevents cross-pollination between parallel Claude Code sessions.

Configuration

The extension has minimal configuration — most settings live in the Callipso overlay. Extension-specific settings are in VS Code's settings:

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

| Setting | Type | Default | Description | |---|---|---|---| | callipso.enabled | boolean | true | Enable or disable the extension | | callipso.port | number | 3001 | HTTP port for communication with Callipso | | callipso.pollInterval | number | 1000 | Terminal polling interval in milliseconds |

Troubleshooting

Terminals not appearing

1. Verify the extension is installed and enabled
2. Reload the VS Code window (Developer: Reload Window)
3. Check that Callipso is running (the overlay should be visible)
4. Check the extension logs: Cmd+Shift+P > Developer: Toggle Developer Tools > Console tab

Voice text not delivered

1. Verify the target terminal is visible in the Callipso terminal list
2. Check that the correct terminal is selected (pinned or auto-routed)
3. Try sending text manually from the Callipso overlay to isolate the issue

High CPU usage

The extension polls terminals every second by default. If this causes performance issues, increase the poll interval:

{
  "callipso.pollInterval": 2000
}