I built Intent because every new AI coding session starts from zero. The agent doesn't know what problem was
being solved, what was tried, or why a path was chosen.
Git tracks code changes. Commit messages help, but three things always fall through: goal continuity (which
commits belong to which task?), decision rationale (why JWT over cookies?), and work state (is this half-done or
finished?).
Intent adds a .intent/ directory to your repo — structured JSON metadata that sits alongside .git/. Two objects:
intent (the goal) and snap (a step taken, with rationale).
itt start "Migrate auth to JWT"
itt snap "Add refresh token" -m "Token rotation not done yet — security priority"
git commit -m "add refresh token"
itt done
Next session, any agent runs itt inspect and gets back structured JSON: active intent, last snap, rationale, and
a suggested next action. 10 seconds vs. minutes of re-explaining context.
- Works with any agent platform (Claude Code, Cursor, Copilot, etc.)
- Plain JSON files, no vendor lock-in
- pip install git-intent
GitHub: https://github.com/dozybot001/Intent