Dust

Flow state for AI coding agents.

Dust provides a CLI that agents use to systematically blaze through your backlog.


Quick Start

``bash
npm install @joshski/dust
npx dust init
`

This creates a .dust directory and adds an instruction to your AGENTS.md file.

Running Agents

Start an agent on a single task:

`bash
claude "implement the next task"
`

Or let dust run agents continuously in a sandbox with the loop command:

`bash
npx dust loop claude
`

This runs Claude Code in a ralph loop, picking up tasks until they are all done.

Learn More

Details live in the .dust/facts directory:

- Directory Structure — how .dust/` is organized
- Configuration — settings and quality checks
- CLI Commands — full command reference