ClaudeMap

Harness Bridge

A local launcher that points Claude Code and seven other coding harnesses at any OpenAI-, Anthropic- or Responses-compatible endpoint — without editing a single config file.

SDKs & Toolinglauncherlocal-modelsclimenu-barendpoints
Visit project0xSero/harness-bridge

Harness Bridge discovers which dialects an endpoint actually serves by probing /chat/completions, /messages and /responses, then offers exactly the harnesses that will work — Claude Code rides the messages dialect via ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN and --model. A session is one readable command, not a generated script: the endpoint, key and model travel in the launch environment, your ~/.claude.json and other configs are never edited, and the key is stored 0600, never passed on a command line. Claude Code is told the model's real context window from the endpoint's /models (via CLAUDE_CODE_MAX_CONTEXT_TOKENS and friends), so locally served models stop triggering premature compaction. One core, four shells: a CLI (harness-bridge / hbr), a macOS menu bar app, and a loopback web UI; missing harnesses install themselves from vendor packages; reasoning levels map per harness.

What it does

  • Dialect discovery, not declaration: probes the endpoint to learn what it serves before offering a harness — Responses-shaped traffic never hits a chat-only endpoint
  • Nothing you own is edited: the launch environment carries endpoint, key and model; config is 0600 and keys never touch a command line or a session
  • Claude Code gets the real context window from /models, not a silent 128k assumption that compacts early on locally served models
  • One core, four shells: CLI (harness-bridge/hbr), macOS menu bar app, loopback web UI on 127.0.0.1:4141

When to use it

Running Claude Code against a local or self-hosted endpoint — vLLM-style gateways, corporate proxies, alternative providers — and switching models or harnesses from one place without touching ~/.claude.json.

Getting started

git clone https://github.com/0xSero/harness-bridge && cd harness-bridge
bun install
cd packages/cli && bun link      # Bun >= 1.1; puts harness-bridge / hbr on PATH

harness-bridge providers add --name HomeLab --url http://host:8080/v1 --key sk-...
harness-bridge models            # what the endpoint actually serves
harness-bridge run claude        # Claude Code opens already talking to it

Things to know

For convenience against local endpoints, Claude Code launches with --dangerously-skip-permissions by default (and Codex with its bypass flag) — visible via args, overridable per launch with --safe or custom flags. The web UI binds loopback with no authentication. The menu bar app needs macOS with Xcode command line tools; the CLI needs Bun >= 1.1. Missing harnesses are auto-installed from vendor packages unless --no-install is set. MIT.

Repository

0xSero/harness-bridge

Charted

Related on the map

  • Claude for Siri

    SDK / Tool

    Answers macOS Spotlight and Siri prompts with your signed-in Claude Code account — an experimental macOS 27 model-delegation provider.

    • macos
    • siri
    • spotlight
    • model-delegation
    View

  • AI Coding Assistant Data Extractor

    SDK / Tool

    Extract your own local chat history from ten AI coding assistants into one normalized JSONL — for fine-tuning, analytics, or backing up years of conversations. Standard library only.

    • cli
    • data-export
    • jsonl
    • backup
    View

  • Data Maskit (数据面具)

    SDK / Tool

    A local privacy gateway for AI coding assistants — masks credentials, connection strings and PII into structured placeholders on the way out, restores them mid-stream on the way back.

    • privacy
    • gateway
    • pii
    • proxy
    View