Run your Markdown
Transform static documentation into interactive, stateful workflows that enforce your process.
❯ npm install -g @rundown/cli
source.rundown.md
# Hello
## 1 This is Rundown
Rundown transforms markdown into an executable specification.
Headings become steps, code-blocks become executable commands.
Human-readable. Agent-readable. Machine-executable.
## 2 Guide agents (and humans) through your process
Rundown keeps agents on track by injecting precision context at the exact moment it’s needed.
## 3 Make complex workflows deterministic
- PASS: CONTINUE
- FAIL: GOTO RECOVER
Rundown works *with* agents, adding guardrails that enforce transitions and improve accuracy.
## 4 Execute the right commands at the right time
- PASS: CONTINUE
- FAIL: RETRY GOTO RECOVER
Embed commands for automatic execution. Catch failure, retry, and recover gracefully.
```bash
rd echo npm run test
```
## 5 Track progresss across agents and sessions
- PASS: CONTINUE
- FAIL: STOP
State-aware CLI ensures progress is never lost.
Save and resume complex processes at any time.
## 6 Ready to get started?
- PASS: COMPLETE
- FAIL: STOP
```bash
npm install -g @rundown/cli
```
## RECOVER Recover from errors
- PASS: GOTO 4
- FAIL: STOP
If you are here, an error occurred.
Named steps enable error handling and conditional logic. Run
Welcome to rundown
Initializing...
Initializing...
Step—/—
ExpectedCOMPLETE
Env idle