Polyphon for VS Code
A VS Code extension that connects to a running Polyphon instance, letting you have multi-voice AI conversations from within your editor — with full awareness of your open file, selection, and errors.
Requirements
- Polyphon must be installed and running locally (desktop app)
- VS Code 1.85 or later
Installation
VS Code Marketplace (coming soon)
Search for Polyphon in the Extensions panel or visit the Marketplace page.
Manual installation (VSIX)
- Download the
.vsix from the latest release
- In VS Code: Extensions → ⋯ → Install from VSIX…
- Select the downloaded file
Configuration
Open Settings (Cmd/Ctrl+,) and search for polyphon:
| Setting |
Default |
Description |
polyphon.host |
127.0.0.1 |
Host of your Polyphon instance |
polyphon.port |
7432 |
TCP port Polyphon is listening on |
polyphon.token |
(empty) |
API token — use the Polyphon: Read Local API Token command to load automatically |
The API token is stored at ~/Library/Application Support/Polyphon/api.key on macOS. Run Polyphon: Read Local API Token from the Command Palette to populate it automatically.
Usage
- Start Polyphon
- Open the Polyphon panel — click the icon in the Activity Bar, or run Polyphon: New Session from the Command Palette
- The extension connects automatically; the status bar shows
$(radio-tower) Polyphon when connected
- Select a composition from the dropdown
- Choose or create a session
- Type a message and press Send or
Enter
Each voice in the composition responds in the unified thread, labeled by name. Use @VoiceName to target a specific voice.
Voice targeting
Type @ in the message field to see a dropdown of voices in the current composition. Select one to direct your message to that voice only.
Code context
Click 📎 attach context before sending to include:
- The path of your currently open file
- Any selected text (as a fenced code block)
- Active error diagnostics in the selected range
The context is prepended to the message sent to Polyphon. Only the plain message text is shown in the conversation panel.
Select code in the editor, right-click, and choose Polyphon: Ask About Selection to open the sidebar with the selection pre-filled.
Commands
| Command |
Description |
Polyphon: Connect |
Manually connect to Polyphon |
Polyphon: Disconnect |
Disconnect from Polyphon |
Polyphon: New Session |
Create a new session in the active composition |
Polyphon: Ask About Selection |
Open the sidebar with the current selection pre-filled |
Polyphon: Read Local API Token |
Auto-populate the API token from the running Polyphon instance |
Development
npm install
npm run dev # build (non-production)
npm run build # type-check + production build
npm run package # build + package as .vsix
npm run lint # ESLint
To run the extension in a development host, open this folder in VS Code and press F5.
See CONTRIBUTING.md for architecture details and contribution guidelines.
License
MIT — see LICENSE
