An Obsidian plugin that connects to a running Polyphon instance, letting you have multi-voice AI conversations from within your vault.
- Polyphon must be installed and running locally (desktop app)
- Obsidian desktop — mobile is not supported
The plugin is not yet listed in the Obsidian community plugin directory. Install it manually or via BRAT.
- Download
main.js,manifest.json, andstyles.cssfrom the latest release - Create the folder
<vault>/.obsidian/plugins/polyphon/if it doesn't exist - Copy the three files into that folder
- Enable the plugin in Settings → Community plugins
Install BRAT, then add polyphon-ai/obsidian-polyphon as a beta plugin. BRAT will keep it up to date automatically.
Open Settings → Polyphon after enabling the plugin:
| Setting | Default | Description |
|---|---|---|
| Host | 127.0.0.1 |
Hostname or IP of your Polyphon instance |
| Port | 7432 |
TCP port Polyphon is listening on |
| API token | (auto) | Use Read local token to load from the running instance, or paste manually |
| Persist conversations | Off | Save and restore history across restarts |
| Debug mode | Off | Log raw JSON-RPC frames to the console |
The API token is stored at ~/Library/Application Support/Polyphon/api.key on macOS. The Read local token button in settings loads it automatically.
- Start Polyphon
- Open the sidebar — click the message icon in the ribbon, or use
Cmd/Ctrl+P → Polyphon: Open sidebar - The plugin connects automatically; the status badge shows online when ready
- 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.
Type @ in the message field to see a dropdown of voices. Select one to direct your message to that voice only.
The plugin automatically includes your current open file path in the first message of each session, giving the AI voices context about what you're working on.
npm install
npm run dev # watch mode — auto-copies to vault/.obsidian/plugins/polyphon/
npm run build # production build
npm test # unit + integration tests
npm run lint # ESLintSee CONTRIBUTING.md for details on the test suite and architecture.
- Join the discussion — questions, ideas, and feedback
- Open an issue — bug reports and feature requests
MIT — see LICENSE