synapse-llm

One-command setup for the Synapse LLM proxy. Detects installed AI coding harnesses and wires them to route through your proxy.

Install

# no install needed
npx synapse-llm@latest setup

Or install globally:

npm install -g synapse-llm
synapse-llm setup

Requires Node.js >= 18.

Usage

# Auto-detect every harness on your machine and wire them all
synapse-llm setup

# Wire a single harness
synapse-llm setup claude-code

# Show what's installed and supported
synapse-llm list

# Help
synapse-llm --help

You'll be prompted for two values:

| Prompt | Default | | --- | --- | | Synapse base URL | https://synapse-proxy-pbmw.onrender.com | | Synapse API key | (none — must start with syn_) |

Get the API key from the Synapse dashboard → API keys → Create new key.

Supported harnesses

| ID | Harness | Auto-config | | --- | --- | --- | | claude-code | Claude Code | shell rc env vars | | cursor | Cursor | manual (Settings UI) | | aider | Aider | shell rc env vars | | codex-cli | Codex CLI | shell rc env vars | | continue | Continue.dev | ~/.continue/config.json | | openai-sdk | OpenAI SDK | manual (code change) | | anthropic-sdk | Anthropic SDK | manual (code change) |

Examples

Claude Code

$ synapse-llm setup claude-code
▸ Synapse base URL (https://synapse-proxy-pbmw.onrender.com)
▸ Synapse API key (starts with syn_)  syn_***************

▸ Claude Code (claude-code)
  ◆ wrote:
    ~/.zshrc
    ~/.bashrc
    · restart your terminal (or source ~/.zshrc)
    · run claude

Appends to your shell rc files:

# >>> synapse: claude-code >>>
export ANTHROPIC_BASE_URL="https://synapse-proxy-pbmw.onrender.com"
export ANTHROPIC_AUTH_TOKEN="syn_***************"
unset ANTHROPIC_API_KEY
# <<< synapse: claude-code <<<

Continue.dev

Writes a Synapse entry to ~/.continue/config.json:

{
  "title": "Synapse",
  "provider": "openai",
  "model": "gpt-4o",
  "apiBase": "https://synapse-proxy-pbmw.onrender.com/v1",
  "apiKey": "syn_***************"
}

Cursor

Prints the values to paste into Settings → Models → Override OpenAI Base URL:

• Base URL: https://synapse-proxy-pbmw.onrender.com/v1
• API key: syn_***************

Auto-detect

Detects which harnesses are installed and prompts before wiring them:

$ synapse-llm setup
▸ detected: claude-code, aider
wire all 2? (Y/n)

How it works

• Shell rc edits are wrapped in # >>> synapse: <id> >>> / # <<< synapse: <id> <<< markers. Re-running the command updates the block in place — no duplicates.
• JSON config edits preserve other entries; the Synapse entry is replaced on rerun.
• No telemetry. No network calls except the initial detection (command -v <bin>) and your own proxy.
• Zero npm dependencies. Pure Node + readline.

Uninstall

# Remove a single harness
sed -i '/# >>> synapse: claude-code >>>/,/# <<< synapse: claude-code <<</d' ~/.zshrc ~/.bashrc

# Or unset env vars in the current shell
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN OPENAI_API_BASE OPENAI_API_KEY

Links

• Proxy source: https://github.com/SaiSanthosh1508/synapse
• Dashboard: https://synapse-five-gamma.vercel.app/dashboard
• Docs: https://synapse-five-gamma.vercel.app/docs
• Issues: https://github.com/SaiSanthosh1508/synapse/issues

License

AGPL-3.0-only