1. Define your Process

Write simple Markdown to define steps, commands, and rules. The runbook is your single source of truth.

# 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 progress 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.

2. Run the CLI

The CLI executes your markdown, guiding agents (and humans) step-by-step through the process.

Welcome to rundown

Initializing...

Initializing...

Step/