A gathering of experts, in your editor: chat with sangam's agents, pick model / thinking / run mode / workspace, browse sessions, and control tools, MCP, runtimes and config via the local sangam headless server.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
A gathering of experts, in your editor. Chat with sangam's agents, pick the
model, thinking level, run mode and workspace, browse your sessions, and control
tools, MCP servers, runtimes and config — all through the local sangam headless
server.
Features
sangam: Open Chat — the chat panel: streamed answers, tool steps, a
Stop button, and /compact.
sangam: Run Agent — describe a goal and let the agent work on it.
sangam: Explain — explain the current selection or file.
Sessions view — every chat and agent session, newest first, with rename.
sangam: Tools / MCP Servers / Runtimes — the same toggles the CLI's
/tools, /mcp and /plugins drive.
sangam: Open Config File / Set Config Value — the config layer the CLI's
/config edits.
sangam: AGENTS.md — show, turn off/on, or choose the chat's instructions.
sangam: Search Sessions — full-text search over sessions and messages.
sangam: Run Tests — run the workspace's tests through the server.
Status-bar item showing the server state, the model and the run mode.
Requirements
The extension talks to the sangam headless server over HTTP/HTTPS. Start it
with:
sangam serve
or run ./install.sh to install sangam and start the server automatically.
Configuration
Setting
Default
Description
sangam.serverUrl
http://127.0.0.1:8765
Base URL of the sangam headless server.
sangam.serverCert
(empty)
Path to the TLS CA/certificate to trust when the server uses HTTPS.
sangam.maxSteps
20
Maximum agent steps per run, sent as max_steps (1–1000).
sangam.workspace
(empty)
Directory the agent runs in: an absolute path or a registered workspace id. Empty means the first folder open in VS Code.
sangam.model
(empty)
Model for every run. Empty means the server's default.
sangam.thinkingLevel
(empty)
Thinking level for every run.
sangam.runMode
(empty)
readonly, write, supervised or unrestricted.
Development
npm install
npm run compile # or: npm run watch
npx vsce package # builds sangam-<version>.vsix
code --install-extension sangam-<version>.vsix
