@bytehumi/klipeo-bridge

Local bridge daemon for Klipeo Vibe mode. Runs on your machine and connects Klipeo's web app to your already-installed AI coding CLI (Claude Code, Codex, Gemini CLI, or OpenCode). Uses your existing subscription — Klipeo never proxies your AI calls.

Install

npm install -g @bytehumi/klipeo-bridge

Quick start

klipeo login     # opens browser to sign in with Klipeo
klipeo start     # starts the local daemon on localhost:7777

Leave klipeo start running in a terminal. Open Klipeo in your browser — Vibe mode will auto-detect the bridge.

Manual token (dev / staging)

While the web OAuth flow is still being built, you can paste a token directly:

klipeo login --token <jwt>

Point at a different Klipeo environment

KLIPEO_BASE_URL=http://localhost:3000 klipeo login
KLIPEO_BASE_URL=http://localhost:3000 klipeo start

Commands

| Command | What it does | | --- | --- | | klipeo login | Browser-based sign-in. Supports --token for manual tokens. | | klipeo start | Boots the local HTTP/WS server and begins polling Klipeo for tasks. | | klipeo status | Prints login state, daemon pid, and detected CLIs. | | klipeo logout | Clears saved credentials. | | klipeo detect | One-shot detection of supported CLIs. |

Supported CLIs

| CLI | Binary | Spawn | Stream parsing | MCP | | --- | --- | --- | --- | --- | | Claude Code | claude | -p <prompt> --output-format stream-json --include-partial-messages --permission-mode bypassPermissions --mcp-config <file> | Raw API events (content_block_start/delta/stop) | mcp.json written to workspace, passed via --mcp-config | | Codex | codex | exec --json --full-auto -C <path> <prompt> | Thread/turn/item state machine | Global ~/.codex/config.toml (user-configured) | | Gemini CLI | gemini | -p <prompt> --approval-mode yolo -o stream-json | NDJSON (init/message/tool_use/tool_result/result) | .gemini/settings.json written to workspace | | OpenCode | opencode | run --format json --dangerously-skip-permissions <prompt> | NDJSON (text/tool_use/step_finish/error) | opencode.json written to workspace |

At least one of those needs to be installed and signed in on your machine. klipeo detect shows what's available.

Where things live

~/.klipeo/
  credentials.json      # { token, userId, email } — chmod 600
  config.json           # { preferredCli, baseUrl }
  daemon.pid            # running daemon pid
  projects/<id>/
    composition.json    # latest snapshot from Klipeo
    mcp.json            # Claude Code MCP config
    .gemini/settings.json # Gemini CLI MCP config
    opencode.json       # OpenCode MCP config

Troubleshooting

• Port 7777 busy — another klipeo start is running. Run klipeo status to check.
• CLI not detected — confirm the binary is on your $PATH. klipeo detect runs --version on each.
• Claude --mcp-config rejected — older Claude Code versions may not accept the flag. The bridge also writes KLIPEO_MCP_CONFIG into the child env as a fallback.
• Codex hangs on approval — your Codex CLI is older than the --full-auto flag. Upgrade to @openai/[email protected]+.
• Gemini hangs in non-interactive mode — make sure --approval-mode yolo is taking effect (older --yolo flag is deprecated).
• OpenCode --prompt flag not found — you're on OpenCode 1.4+, which made the prompt positional. The bridge already passes it positionally.
• 401 from upstream — token expired. Run klipeo login again.

Security

• Credentials live in ~/.klipeo/credentials.json with 0600 permissions.
• The local HTTP server only accepts connections from 127.0.0.1 and CORS-limits browser requests to https://klipeo.com, https://dev.klipeo.com, and http://localhost:3000/3001.
• No telemetry.
• Your AI CLI calls go directly from your machine to Anthropic / OpenAI / Google using your own credentials; Klipeo never sees them.