marionette documentation
A compiler and runtime for plain-text project trajectories.
Write stages and transitions in a .mar file, validate the
graph, then traverse it from the CLI or NDJSON runtime. Choices can be
conditional, repeatable, or restricted to a human decision.
- source
plan.mar- compile
marionette validate plan.mar- execute
marionette brief plan.mar --json
Browser playground
The editor runs the repository's compiler and walker in the browser. Select an example, edit the source, inspect the graph, and record a transition. Human-only choices are refused, as they are by the CLI.
Reference sections
- Getting startedInstall the CLI, write your first plan, and set it up with Claude Code, Codex, or OpenCode.
- Language & CLIOne structured page for the whole tool: write, check, run, change, and look anything up.
- ExamplesProgress from one-step plans to loops, human approval, and production migrations.
- Execution guideConnect an agent or another program to Marionette.