ticket-tracker

You can track software tickets inside a git repository by storing them as human-readable markdown files while a local SQLite engine enforces workflow rules and state consistency. This approach keeps ticket data version-controlled alongside your source code without requiring external services.

Multi-agent repository workflows can be managed entirely in-repo without a server or SaaS tool. The system supports an agent roster for role registration, dependency linking, conflict detection, and commit enrichment to coordinate work across multiple contributors.

Generating a changelog from markdown tickets linked to git commits is supported natively. The tracker enriches git commits with ticket status updates and compiles them into a changelog, ensuring your release notes reflect actual work completed within the repository.

In-repo ticket tracking requires a Python 3.8+ environment using only the standard library. You need to install the provided CLI tool to manage ticket lifecycles, enforce dependency gating, and maintain markdown round-tripping with the local SQLite database.

Preventing code-surface conflicts during multi-agent edits is handled by built-in conflict detection. The tracker monitors assigned ticket surfaces and alerts agents to overlapping modifications before they occur, reducing integration issues and maintaining workflow consistency.

Using markdown files with SQLite backing combines human-readable, git-friendly ticket storage with strict workflow enforcement. Markdown round-tripping ensures tickets remain editable in git, while SQLite guarantees state consistency, dependency gating, and lifecycle validation.