Bach CLI (npm)

Obfuscated binary distribution of the Bach SDK control plane.

Install

npm install -g @bach/cli
bach version

npm automatically pulls the correct platform binary via optional dependencies.

Quick Start

# 1. See your providers (zero config — reads ~/.cc-switch)
bach providers

# 2. Expose tools to Claude Code / Codex
bach tool-server

# 3. Start the control room
bach daemon run --evolution-state ~/.bach-state

Connect to Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "bach": {
      "command": "bach",
      "args": ["tool-server"]
    }
  }
}

Your agent can now call list_providers, get_provider_health, and switch_route.

Connect to Codex

Add to ~/.codex/config.toml:

[mcp_servers.bach]
command = "bach"
args = ["tool-server"]

CLI Commands

bach providers              # list imported providers
bach tool-server [--allow]  # MCP stdio server
bach serve [--port N]       # local HTTP API
bach daemon run             # control room daemon
bach gc --state DIR         # garbage-collect shared assets
bach version

Supported Platforms

| OS | Arch | npm subpackage | |---|---|---| | macOS | arm64 | @bach/cli-darwin-arm64 | | macOS | x64 | @bach/cli-darwin-x64 | | Linux | arm64 | @bach/cli-linux-arm64 | | Linux | x64 | @bach/cli-linux-x64 | | Windows | x64 | @bach/cli-win32-x64 |

Documentation

• Full README
• CLI Guide
• SDK Usage

Claude Sidecar

The Claude Code TypeScript sidecar is distributed separately. For Claude runtime support:

export BACH_CLAUDE_DRIVER_ENTRY=/path/to/claude-driver/src/main.ts

For Codex-only usage, no sidecar is needed.