Projects · What I'm known for

Simple Project Tracker

Stable 2026 – now Author

CLI project tracker with Git repository discovery, search and filtering, bulk edits, undo, and a background update daemon.

I keep dozens of repositories in ~/programming, and I wanted one command that tells me what state each is in and what I was doing with it. t scans a directory for Git repositories, tracks them in a small database, and lets me attach statuses and notes.

Design choices#

  • Commands that read like sentences. The project can go before or after the command, and a command fuses with its action: t 12 es blocked edits the status of project 12, t sset ll 30 sets a setting. A bare word falls back to a project lookup.
  • Frecency-based name resolution, optionally fed by zoxide: t tra finds tracker because it's what I touch most, not because it sorts first.
  • Undo. The last change is always one t undo away, and undoing again puts it back.
  • A background daemon keeps Git state fresh so listings are instant, with doctor and fix commands to repair the database if it drifts.
  • Shell completion for bash, zsh and fish, a man page, and a todo list that lives beside the project database.

~10,500 lines across 35 modules, with 17 test modules and CI.