tickgit is a tool to help you manage latent work in a codebase. Use the tickgit command to view pending tasks, progress reports, completion summaries and historical data (using git history).
It's not meant to replace full-fledged project management tools such as JIRA or Trello. It will, hopefully, be a useful way to augment those tools with project management patterns that coexist with your code. As such, it's primary audience is software engineers.
tickgit will scan a codebase and identify any TODO items in the comments. It will output a report like so:
# tickgit ~/Desktop/facebook/react
...
TODO:
=> packages/scheduler/src/__tests__/SchedulerBrowser-test.js:85:9
=> added 1 month ago by Andrew Clark <[email protected]> in a2e05b6c148b25590884e8911d4d4acfcb76a487
TODO: Scheduler no longer requires these methods to be polyfilled. But
=> packages/scheduler/src/__tests__/SchedulerBrowser-test.js:77:7
=> added 1 month ago by Andrew Clark <[email protected]> in a2e05b6c148b25590884e8911d4d4acfcb76a487
TODO: Scheduler no longer requires these methods to be polyfilled. But
=> packages/scheduler/src/forks/SchedulerHostConfig.default.js:77:7
=> added 1 month ago by Andrew Clark <[email protected]> in a2e05b6c148b25590884e8911d4d4acfcb76a487
TODO: useTransition hook instead.
=> fixtures/concurrent/time-slicing/src/index.js:110:11
=> added 3 weeks ago by Sebastian Markbåge <[email protected]> in 3ad076472ce9108b9b8a6a6fe039244b74a34392
128 TODOs Found 📝
Check out an example of the TODOs tickgit will surface for the Kubernetes codebase.
- Blame - get a better sense of how old TODOs are, when they were introduced and by whom
- Context - more visibility into the lines of code around a TODO for greater context
- More
TODOtype phrases to match, such asFIXME,XXX,HACK, or customized alternatives. - More configurability (e.g. custom ignore paths)
- Markdown parsing
- More thorough historical stats
brew tap augmentable-dev/tickgit
brew install tickgit
The most up to date usage will be the output of tickgit --help.
To find information about using the tickgit API, see this file.