@gemus/bridge
v0.3.0
Published
Bridge CLI for connecting Claude Code to Gemus platform
Downloads
87
Maintainers
Readme
@gemus/bridge
Connect your own Claude Code subscription to the Gemus platform and drive node-based AI design workflows from the in-app Chat Panel — using your own subscription quota.
The Bridge CLI runs on your machine. Claude Code calls Gemus platform tools over MCP (create nodes, edit workflows, run generations); you chat in the browser and results stream back live.
Prerequisites
- A Claude Code subscription (Anthropic Max or Pro) — run
claude --versionto confirm it's installed. - A one-time subscription login:
claude auth login(orclaude setup-token+ setCLAUDE_CODE_OAUTH_TOKEN). - Node.js ≥ 18.
- A Gemus account and an MCP API key (
mak_…).
Get an MCP API key
Log in to gemus.ai, open Settings → Bridge / MCP Keys, and click Generate new key. The key (mak_…) is shown once — copy it immediately. You can revoke it any time from the same screen.
Usage
npx @gemus/bridge --api-key mak_xxxxxxxxxxxxxxxxOr set it via env var:
export GEMUS_API_KEY=mak_xxxxxxxxxxxxxxxx
npx @gemus/bridgeThen open the Chat Panel in the Gemus editor and select "Claude Code" as the provider.
Options
| Flag | Env | Default | Description |
|------|-----|---------|-------------|
| --api-key <key> | GEMUS_API_KEY | required | Your MCP API key (mak_…) |
| --server <url> | GEMUS_SERVER | https://gemus.ai | Platform server URL |
| --session-mode <mode> | BRIDGE_SESSION_MODE | sdk | Session runner: sdk (default, robust) or cli |
Codex env vars (#1969)
| Env | Default | Description |
|-----|---------|-------------|
| BRIDGE_CODEX_INSTANT_DELIVERY | auto | Codex image delivery mode. Default probes for the App Server image worker (codex ≥ 0.144) and, if present, generates codex-imagen nodes via your subscription with instant per-image backfill + live "generating" spinner. Set to off to force the classic turn-end backfill fallback. |
| BRIDGE_IMAGE_CONCURRENCY | 2 | Max concurrent Codex image generations (hard-clamped to 1–4). Bounded for subscription-plan compliance — large batches should use a platform API provider, not this. |
See the full deployment & usage guide in the Gemus docs for billing, troubleshooting, and the SDK/CLI runner details.
License
MIT
