Springfield
Local-state conductor for multi-agent code work, distributed as a Claude Code (and Codex) marketplace plugin.
Springfield turns a plan (file or prompt) into a sequential batch of agent runs, executes each slice in an isolated git worktree, captures per-slice evidence, and falls through agent_priority (default: Claude → opt-in Codex → opt-in Gemini) when a run is retryable. State lives under .springfield/ in the repo; install ships through Claude Code and Codex marketplace plugins.
Vendor economics: claude -p headless invocations count against the Claude Max/Pro subscription, so Springfield defaults to Claude (Codex and Gemini are opt-in). Anthropic briefly metered claude -p separately (2026-05-14) before reverting; Springfield keeps that response — a Codex-led default plus a springfield start billing warning — one flag flip away (ClaudeHeadlessMetered in internal/core/agents) for if it returns. --cost-cap $X aborts the batch when spend hits the threshold regardless.
"Plugin-distributed" here means Springfield is installed via the marketplace plugin flow. Springfield does not currently expose a plugin or extension API of its own.
When you run springfield start, the conductor will:
- Load the next plan from the compiled batch.
- Cut an isolated worktree on
springfield/<plan-id> so the host clone stays untouched.
- Dispatch the first id in
agent_priority (default: Claude; Codex/Gemini opt-in) against the plan envelope.
- Stream the agent's output to
.springfield/execution/plans/<plan-id>/evidence/iter-<N>/ and watch for the runner-sole-writer markers that signal pass/fail.
- Fast-forward merge the plan back into your base branch on success; fall through to the next agent on a retryable failure.
- Move to the next plan, repeating until the batch is complete or a fatal failure stops it.
Pre-1.0. Config and state layout may change without migration shims.
Prerequisites
- A git repository for the project Springfield runs against.
- At least one supported agent CLI installed and authenticated:
- macOS (amd64/arm64) for the
brew install path. Linux/Windows install the CLI via Alternate Install Paths.
- Go 1.26+ if you're building the CLI from source (
go install .); not needed for the brew install path.
Public CLI
springfield # Show help and next-step guidance
springfield init # Scaffold springfield.toml and .springfield/
springfield install # Sync local Claude Code/Codex host artifacts
springfield doctor # Check local agent CLI availability
springfield plan # Compile a work request into a runnable batch
springfield plans # Manage the registered plan-unit registry
springfield start # Execute the active batch from its saved cursor
springfield status # Inspect the active batch or work
springfield recover # Recover from a failed plan or orphaned batch
springfield version # Print build version
Supported agents (all fully executable):
- Claude Code
- Codex CLI
- Gemini CLI (opt-in via
--agents ...,gemini or by adding "gemini" to agent_priority; set GEMINI_API_KEY or sign in to the Gemini CLI before running headless)
Install
Springfield ships as two pieces: the CLI (the springfield binary that does all the work) and a plugin (the skills/slash-commands your agent runs). Install both.
1. CLI — Homebrew (macOS)
brew install brentguistwite/tap/springfield
springfield version
brew upgrade springfield is the one upgrade you normally think about — new features land in the CLI and arrive here. Linux/Windows: install via Alternate Install Paths.
2. Plugin — skills + slash commands
Claude Code:
/plugin marketplace add brentguistwite/springfield
/plugin install springfield@brentguistwite
Slash commands available after install: /springfield:plan, /springfield:plan-from-jira, /springfield:status, /springfield:recover. To execute a batch, run springfield start in a terminal. (For the Codex plugin, see Codex Plugin Directory.)
The plugin is a thin, stable shim over the CLI verbs (plan, start, status, recover), so it changes rarely. Plugin updates are manual on both platforms — run them only if a skill tells you to:
- Claude Code:
/plugin marketplace update springfield, then /plugin install springfield@brentguistwite
- Codex:
codex plugin marketplace upgrade brentguistwite
