Dust ✨

Flow state for AI coding agents.

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

Quick Start

npm install @joshski/dust
npx dust init

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

Adding Tasks

Use your AI coding CLI (Claude Code, Codex, etc.) to add and refine tasks:

claude "add a task to refactor the auth module"

Ideas (.dust/ideas/) are backlog items you may or may not do later. Tasks (.dust/tasks/) are ready to work on now. Both are markdown files that agents and humans can read and edit.

Running Agents

Start an agent on a single task:

claude "implement the next task"

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

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