Skip to content

flying-dice/abtree

Repository files navigation

abtree

abtree

Hoping. Behaving.
Treat agent instructions like the software they are. Clear steps, predictable behavior, real answers when something goes wrong.

Docs · Get started · How it works


What it does

abtree is a runtime for agent workflows. Author a tree as JSON, YAML, or compile it from the TypeScript DSL. Ship it through any transport your team already uses — abtree never sees the distribution; it only reads the file at the path you point it at. Your agent drives execution through three commands (next, eval, submit) and only ever sees the next step.

A behaviour tree walking the SRP refactor loop — one failed pass, one clean retry

The trace above is a Refactor_Loop sequence with three actions. Green nodes ran and succeeded, red ran and failed, the pink ring marks the cursor. The runtime regenerates the diagram after every state change, so what the agent did and what it skipped is on disk by the time it finishes.

Install

macOS / Linux

curl -fsSL https://github.com/flying-dice/abtree/releases/latest/download/install.sh | sh

Windows (PowerShell)

irm https://github.com/flying-dice/abtree/releases/latest/download/install.ps1 | iex

Read the docs

Concepts, guides, CLI reference, and a five-minute walkthrough all live at abtree.sh.

Get started in five minutes

About

Behaviour trees for AI agents. Define agentic workflows in YAML, drive deterministic agent runs from a CLI works with any agent, Claude, Codex, Copilot, Gemini etc.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors