# Gambit

> Gambit is an open-source agent harness framework by Bolt Foundry for building, running, and verifying LLM workflows using typed decks.

Gambit is an open-source agent harness framework by Bolt Foundry for building, running, and verifying LLM workflows. It introduces the concept of "decks" — small, typed units with explicit inputs, outputs, and guardrails — that compose together into reliable AI pipelines. Decks can mix LLM calls and plain compute tasks interchangeably, feeding models only the context they need at each step instead of dumping entire documents into a single prompt.

Gambit runs locally via CLI (npx or Deno) and ships with a built-in Debug UI for streaming traces, inspecting transcripts, and reproducing failures without relying on provider logs. The framework supports REPL mode for interactive development, test-bot personas for automated testing, and session grading for evaluation.

- **Typed Decks** - Define workflows as small composable units with Zod-validated input and output schemas, written in Markdown or TypeScript.
- **Local-First Debugging** - Stream traces, inspect transcript lanes, and reproduce failures using the built-in simulator UI at localhost.
- **Mixed LLM and Compute** - Combine model-powered steps and pure TypeScript compute steps within the same deck tree.
- **CLI Tooling** - Run decks, start REPLs, launch the debug server, and grade sessions from the command line via npx or Deno.
- **Test Bot and Grading** - Run persona decks against your workflows and grade saved sessions to evaluate LLM behavior systematically.
- **Action Decks** - Attach child decks as tool actions that LLM-powered parent decks can call, enabling agent-style tool use.
- **Schema-Driven UI** - The Debug UI auto-renders input forms from deck schemas with defaults and a raw JSON tab.
- **Session Persistence** - Save and replay sessions with trace files and state snapshots stored locally under `.gambit/`.

## Features
- Typed deck-based workflow composition with Zod schemas
- Local-first CLI execution via npx or Deno
- Built-in Debug UI with streaming traces and transcript lanes
- REPL mode for interactive deck development
- Mixed LLM and compute task steps in a single deck tree
- Test bot personas for automated workflow testing
- Session grading for LLM behavior evaluation
- Action decks for agent-style tool use
- Schema-driven input forms in the Debug UI
- Session persistence with local trace and state files
- Markdown and TypeScript deck authoring
- OpenRouter API integration for model access

## Integrations
OpenRouter, GitHub, GitHub Actions, Deno, Node.js

## Platforms
WEB, API, DEVELOPER_SDK

## Pricing
Open Source

## Version
0.7.0

## Links
- Website: https://github.com/bolt-foundry/gambit
- Documentation: https://github.com/bolt-foundry/gambit
- Repository: https://github.com/bolt-foundry/gambit
- EveryDev.ai: https://www.everydev.ai/tools/gambit