Elixium AI Companion for VS Code
Your agile board, inside your IDE. Connect to Elixium.ai and manage stories, track iteration context, and run MCP tools without leaving your editor.
Getting Started
Sign in — no API key needed
- Install the extension and click the Elixium icon in the activity bar
- In the Connect panel, click Sign in with Elixium (or run
Elixium: Sign In from the Command Palette)
- Your browser opens Elixium's consent page — sign in and pick the workspace to connect
- Back in VS Code, pick your board — done
That's the whole setup: the extension connects to the hosted Elixium endpoint over OAuth 2.1 (authorization code + PKCE). No API key to generate, no JSON to edit, no local server process. Your session refreshes automatically and can be revoked anytime from your workspace.
Self-hosted deployment?
Open the Self-hosted deployment option in the Connect panel and enter your deployment's connect URL (e.g. https://connect.your-host/mcp). Sign-in then routes to your identity provider via the endpoint's own discovery metadata — same steps as SaaS, and nothing leaves your network.
Manual Setup
The remote entry the extension writes to .vscode/mcp.json — you can add it by hand for any agent with remote MCP support:
{
"servers": {
"elixium": {
"type": "http",
"url": "https://connect.elixium.ai/mcp"
}
}
}
No credential goes in the file — each agent authenticates itself (OAuth) against the endpoint.
Legacy setup (API key + local server) — still supported during the coexistence window
If you prefer the key-based local server, add this to .vscode/mcp.json (API key from Profile tab → your workspace card → Generate Key):
{
"mcpServers": {
"elixium": {
"command": "npx",
"args": ["-y", "@elixium.ai/mcp-server@latest"],
"env": {
"ELIXIUM_API_KEY": "your_api_key_here",
"ELIXIUM_API_URL": "https://your-tenant.elixium.ai/api",
"ELIXIUM_BOARD_SLUG": "main",
"ELIXIUM_USER_EMAIL": "you@company.com"
}
}
}
}
Have one of these already? On activation the extension detects legacy configs and offers a one-click migration to the remote entry (it strips the API key from the file and preserves your board). Declining is fine — the legacy path keeps working until the announced cutover.
The Elixium: Advanced Setup wizard remains available for key-based multi-agent configuration.
Features
Iteration Context Panel
A dedicated sidebar panel showing your board at a glance:
- Current stories with lane, points, and state
- Backlog stories ready to pull
- Objectives with status tracking
- Live badge showing story counts
- Warm start — loads cached context instantly on startup, refreshes in the background
Click any story to open it in the board or create a git branch.
Story Actions
Manage your workflow from the Command Palette:
| Command |
What it does |
Elixium: Start Story (Picker) |
Pick a story, get the implementation brief copied to clipboard |
Elixium: Create Story |
Create a story with title, description, lane, and points |
Elixium: Move Story to Lane |
Move a story between Backlog, Icebox, Current |
Elixium: Set Story State |
Set state (started, finished, etc.) with guardrails |
Elixium: Open Story in Board |
Open the selected story in your browser |
Elixium: Create Git Branch from Story |
Generate a branch name from the story title |
Elixium: Copy Implementation Brief |
Get the full implementation context on your clipboard |
Elixium: Copy Hypothesis Template |
Quick hypothesis template for Learning Loop stories |
Browse and run any of the 19+ Elixium MCP tools directly from the sidebar. Each tool prompts for required arguments and shows results in a dedicated output panel.
Real-Time Notifications
The extension polls your board every 60 seconds and notifies you when stories change lanes or states — so you know when a story is delivered, accepted, or blocked without checking the board.
Multi-Agent Setup
Point your other AI agents at the same board with the remote entry above:
- GitHub Copilot —
.vscode/mcp.json
- Cursor —
.cursor/mcp.json
- Claude Code —
.mcp.json
- OpenAI Codex —
.codex/mcp.json
- Windsurf —
.windsurf/mcp.json
The connect flow writes the correct format per agent (servers vs mcpServers) and auto-detects which agents are installed. Legacy key-based multi-agent setup remains available via Elixium: Advanced Setup.
Claude Slash Commands
The Elixium: Advanced Setup wizard scaffolds three Claude Code commands in .claude/commands/:
/elixium-start-story — List stories, pick one, get implementation brief/elixium-board-status — Summarize current iteration with counts and objectives/elixium-create-story — Guided story creation with hypothesis support
All Commands
| Command |
Description |
Elixium: Sign In |
OAuth sign-in for the remote (hosted) connection |
Elixium: Connect |
Open the Connect panel |
Elixium: Switch Board |
Switch the active board |
Elixium: Advanced Setup |
Legacy wizard for key-based credentials and agent configs |
Elixium: Verify Connection |
Test your MCP connection |
Elixium: Refresh |
Refresh tools list and iteration context |
Elixium: Run MCP Tool |
Run any MCP tool with argument prompts |
Elixium: Start Story (Picker) |
Pick a story and get implementation brief |
Elixium: Create Story |
Create a new story inline |
Elixium: Move Story to Lane |
Move story between lanes |
Elixium: Set Story State |
Change story workflow state |
Elixium: Open Story in Board |
Open story in browser |
Elixium: Create Git Branch from Story |
Generate branch from story title |
Elixium: Copy Implementation Brief |
Copy implementation context to clipboard |
Elixium: Copy Hypothesis Template |
Copy hypothesis template to clipboard |
Requirements
- VS Code 1.80+
- An Elixium.ai account with a workspace
- Node.js 18+ — only for the legacy local-server setup (the remote connection needs nothing installed)
Links
