Switchyard v0.5.0

Local-First Agent Platform · Zero-Model Core

Separate work.
One clear review.

Run autonomous coding agents in isolated Git worktrees, account for real-time token economics, and proxy LLM traffic through a local zero-telemetry gateway. Catch collisions before you merge.

100% Local-first · Zero telemetry · 60-day verified pricing · MIT Licensed

Fleet reviewSynthetic example
api
fleet/api · worktree active
Collision detected
auth
fleet/auth · validation stale
Validation stale
docs
fleet/docs · tests green
Review candidate
src/auth.ts has concurrent changes from api and auth.Inspect collision evidence →

One cohesive platform for multi-agent engineering.

Switchyard provides deterministic isolation, economic visibility, and local routing without relying on external agent clouds or proprietary control planes.

Spawn dedicated Git worktrees for concurrent agents. Check tree-diff intersections to catch collisions before merging.

# Spawn an isolated worktree with auto-injected gateway config
$ fleet spawn api --gateway
✓ Created worktree at .fleet/agents/api
✓ Checked out new branch fleet/api from main
✓ Provisioned isolated .env.fleet (OPENAI_BASE_URL=http://localhost:52425/v1)

# Compute index-tree collision evidence across all active worktrees
$ fleet check
[collision-engine] Scanning 3 active worktrees...
  • fleet/api  : 4 files modified (2 clean, 2 shared)
  • fleet/auth : 3 files modified (1 clean, 2 shared)
  • fleet/docs : 5 files modified (5 clean, 0 shared)

WARNING: Overlapping modifications detected on src/server.ts and src/types.ts
Run fleet diff --agent api to inspect exact conflicting hunk boundaries.

Architected for production agent workflows.

Three specialized tools designed to work in concert without cloud lock-in.

Pillar 01 · Isolation

Fleet Worktree Engine

Spawns isolated Git worktrees backed by atomic locks. Calculates index-tree diff intersections so you see exact file and line collisions before running a merge.

@switchyardhq/switchyard · Zero-model core
Pillar 02 · Observability

Context Economics

Calculates true token expenditure across Anthropic, OpenAI, Gemini, and DeepSeek. Accurately factors prompt cache write penalties, read discounts, and context bloat.

contextbill · 60-day verified tables
Pillar 03 · Control Plane

Gateway & Studio

Local reverse proxy at 127.0.0.1:52425 exposing OpenAI-compatible completions. Auto-provisions worktree credentials and maintains an immutable audit trail.

@switchyardhq/cortexai · Local-first proxy

How Switchyard coordinates agent execution.

A deterministic pipeline keeping agent operations sandboxed, observable, and ready for human review.

Step 01

Spawn Worktrees

fleet spawn <name> generates a linked Git worktree under .fleet/agents/ and checks out a private branch.

.fleet/agents/api
Step 02

Route & Audit

Worktree agent invokes localhost:52425/v1. Fleet Gateway proxies completions directly to your provider and records costs.

.fleet/audit.jsonl
Step 03

Collision Check

fleet check calculates index-tree diff intersections across all active worktrees to detect concurrent file overlaps.

fleet check --json
Step 04

Gate & Merge

fleet validate executes your repo test suites. fleet merge lands verified, collision-free code into main.

fleet merge api

From separate work
to a shared review.

Open the interactive review tool or export your existing CLI reports. The browser reads them locally and helps you prepare a deliberate handoff.

Try the review viewer →
  1. 01

    Inspect the evidence

    See agent changes, shared files, token bills, and validation states.

  2. 02

    Verify collision states

    Inspect blockers and run local commands that safely resolve overlapping diffs.

  3. 03

    Prepare a handoff

    Select agents, review cost impact, and download an executable integration plan.

Start in your repository.

The CLI runs locally. The report viewer reads JSON in your browser and never executes commands. It does not connect to third-party tracking servers or upload your code.

Node ≥18.17 · Git ≥2.31 · Python ≥3.10 · MIT

Read the complete documentation portal →
Install & isolate
npm install -g @switchyardhq/switchyard contextbill
# Inside an existing Git repository:
fleet init
fleet gateway --port 52425 &
fleet spawn api --gateway
fleet spawn auth --gateway
fleet check
fleet dashboard --once

Switchyard provides isolation and routing. It leaves agent cognition to your choice of LLM.