drift-tasks 0.1.0

Keep Claude planning conversations in sync with your codebase

Drift

Keep Claude planning conversations in sync with your codebase.

Drift is a CLI tool for solo devs who plan with Claude and build with Claude Code. It closes the gap between "what we decided" and "what exists in the repo."

Install

pip install drift-tasks

Commands

• drift import — Extract tasks from Claude Code session logs or pasted text into TODO.md
• drift check — Detect which tasks are likely done based on your repo
• drift next — Get the single most logical next action
• drift focus — Daily entry point: where you left off + what's next
• drift done <id> — Mark tasks done manually
• drift skip <id> — Move a task to Skipped
• drift sharpen <id> — Turn a vague task into an actionable one

Workflow

1. Plan in Claude chat. Have your design conversation as usual.
2. Ask for a summary at the end of the planning session.
3. drift import --paste — paste the summary, Drift extracts tasks into TODO.md.
4. Build in Claude Code. TODO.md at the repo root is picked up automatically.
5. drift focus at the start of each session. No re-reading old conversations.
6. drift check periodically to reconcile progress against the repo.

How it works

• Tasks live in a single TODO.md file at your repo root. No database, no config server.
• Each task has 2-3 completion signals — concrete, code-level indicators Drift uses to verify progress.
• Drift never auto-marks tasks done. It proposes, you confirm.
• The file is human-editable. Hand-edits are preserved across runs.

Requirements

• Python 3.10+
• Anthropic API key (set ANTHROPIC_API_KEY in your environment)

License

MIT