SYNAPSEv0.1open dashboard →
▸ docs · install in 30 seconds

Wire your harness.
Watch the bill drop.

Pick your harness below. Copy the snippet. That's it.

▸ quickstart · 01

One command.
Auto-detects every harness on your machine.

~ $ installcopy + paste
# install + wire every harness on your machine
npx synapse-llm@latest setup

# pin a single harness
npx synapse-llm@latest setup claude-code
  1. /01
    Run the setup command
    It auto-detects which AI tools are on your machine and rewrites their config to route through Synapse.
  2. /02
    Paste your syn_ key when asked
    Get it from the dashboard → API keys. One key works for every harness in this workspace.
  3. /03
    Use your tools normally
    Open Claude Code, Cursor, Aider — whatever you already use. Synapse runs underneath. Savings appear on the overview page.
▸ wire it manually · 02

Or paste an env var pair.
One snippet per harness.

▸ claude codeAnthropic env vars. Add to ~/.zshrc or ~/.bashrc.
export ANTHROPIC_BASE_URL="https://synapse-proxy-pbmw.onrender.com"
export ANTHROPIC_AUTH_TOKEN="syn_xxxxxxxxxxxxx"
unset ANTHROPIC_API_KEY
claude

▸ replace syn_xxx with your workspace key · replace https://synapse-proxy-pbmw.onrender.com with your Synapse base URL

▸ stuck? · 03

Common gotchas.
Short answers.

[ first-call ]

First call is taking forever.

The hosted proxy sleeps when idle. First request after a quiet period wakes it in ~50 seconds. Subsequent calls are normal speed.

[ no-savings ]

I'm not seeing any savings yet.

Savings come from repeat work — semantic cache + memory both need a few calls to warm up. Run your usual flow for ~5–10 minutes; the overview page updates live.

[ wrong-key ]

Getting `401` from the proxy.

Your harness is sending the wrong key. Make sure your env var contains the `syn_*` workspace key (not your raw provider key), and that you ran `unset ANTHROPIC_API_KEY` if you previously set it.

▸ still stuck? open an issue on github — we read every one