openmath-vscode
VS Code extension for openmath-ai — an agentic coding assistant that runs in your editor sidebar.
Features
- Chat sidebar — Interactive chat with openmath-ai models
- Session management — Create, switch, and delete chat sessions
- Streaming responses — Real-time token-by-token response rendering
- Mathematics rendering — LaTeX math via KaTeX, markdown via marked
- Reasoning display — Collapsible thinking traces
- Settings UI integration — Configure via VS Code's native settings editor
- Soft reload — Re-initialize the engine without restarting VS Code
Requirements
- VS Code
- An openmath-ai compatible API endpoint (default: DeepSeek API)
OPENMATH_API_KEY configured (via VS Code settings or .env file)
Configuration
All settings are under the openmath.env key in VS Code Settings (Ctrl+, → search "openmath").
Essential
| Setting |
Default |
Description |
OPENMATH_API_KEY |
"" |
API key for your provider |
OPENMATH_PROVIDER |
openai-compatible |
API provider |
OPENMATH_BASE_URL |
https://api.deepseek.com |
API base URL |
OPENMATH_MODEL |
deepseek-v4-flash |
Model name |
See .env.example for the full list of available options.
Configuration can also be provided via a .env file in the workspace root. VS Code settings take precedence over .env.
Usage
- Open the OpenMath sidebar (click the circuit-board icon in the activity bar, or run
OpenMath: Open Chat)
- Select or create a session from the session list
- Type your message and press Enter
- View responses with streaming, reasoning traces, and rendered math
Commands
| Command |
Description |
OpenMath: Open Chat |
Open the chat sidebar |
OpenMath: New Session |
Create a new chat session |
OpenMath: Switch Session |
Switch to a different session |
OpenMath: Delete Session |
Delete a session |
OpenMath: Reload Extension |
Re-initialize the engine after changing settings |
Error Handling
If the engine fails to start (e.g., missing API key), the sidebar displays an error panel with two buttons:
- Open Settings — Opens VS Code settings at
openmath.env
- Reload Extension — Re-initializes the engine after you've corrected the configuration
You can also run OpenMath: Reload Extension from the command palette (Ctrl+Shift+P).
Development
# Install dependencies
npm install
# Compile
npm run compile
# Watch mode
npm run watch
# Lint
npm run lint
Press F5 in VS Code to launch an extension development host.
| |
