Sprint Agent stops your AI agent from re-reading 50 files at every session. Drops a tiny .sprint/ folder in your repo, and the agent picks up exactly where it left off.
$ pip install sprint-agent
Your agent rebuilds context from scratch. Same 12k tokens. Same 8–15 minutes. Every. Single. Time.
.sprint/Single command creates a .sprint/ folder with backlog, current sprint, and the right config file for your agent.
No background server, no SQLite, no Docker. Just files your agent reads and your editor opens.
Measured on a B2B SaaS with 5M+ company records. 10 production sessions. Tokens at ~4 bytes/token.
One .sprint/ folder. Markdown files. Version-controlled. Diff-able. Greppable. Editable in any editor.
One ticket per session. Forces shipping over polishing.
One command, one template. Score, document, plan next.
Pure Python stdlib. Single 700-line file. Pip or curl, your choice.
Auto-generates the config file each agent expects on disk. Pick yours.
Real numbers from six months building DataFrancePro — a B2B SaaS with 5M+ company records, daily 30-min sessions with Claude Code.
CLAUDE.md alone wasn't enough — I needed structure: backlog, current sprint, what's blocked, what shipped yesterday. So I built one tiny CLI that drops a .sprint/ folder in the repo. After 6 months and 70+ tickets shipping DataFrancePro with this workflow, it works. Sharing the source.Files diff in git, open in any editor, survive every tool change. Zero migrations, zero servers.
Not a team tool. Opinionated 30-min daily, single ticket per session. Trades flexibility for shipping velocity.
Pure Python stdlib. ~700 lines. Single file. Nothing weird running in the background.
CLAUDE.md tells the agent what the project is. Sprint Agent adds where you are in the work — current sprint, today's ticket, what's blocked, what shipped yesterday. The agent picks up mid-sprint instead of starting fresh.
Markdown is readable by humans and AI agents without parsers. It diffs cleanly in git, opens in any editor, survives every tool change. Zero dependencies, zero migrations, zero servers.
Yes. Sprint Agent never makes a network call. It just reads and writes local files in .sprint/. Your AI agent reads them on its next session.
Sprint Agent is designed for solo dev + AI pairs. Teams should keep using Linear, Jira, GitHub Projects. The opinionated 30-min daily and single-ticket-per-session model breaks at team scale.
Yes. Any agent that reads project files works — just point it at .sprint/AGENT.md at session start. Works out of the box for Claude Code, Cursor, Copilot, Codex, Gemini, Aider, Windsurf.
Bug reports and feature requests via GitHub Issues. Discussions in Discussions. Pull requests welcome — read CONTRIBUTING.md first.
Install in two minutes. Free, open-source, MIT-licensed.
$ pip install sprint-agent && sprint-agent init
$ curl -O https://raw.githubusercontent.com/miloudbelarebia/sprint-agent/main/sprint_agent.py