Skip to content

v0.1.0 - Initial Release

Choose a tag to compare

View all tags
@joel-pcg joel-pcg released this 15 Mar 17:48
· 2 commits to main since this release
v0.1.0
90693a0

TODO Tracker CLI v0.1.0

First public release of TODO Tracker CLI — a terminal-native tool for tracking TODO comments across codebases.

Features

Core Functionality

  • Regex-based scanning — Language-agnostic TODO extraction (Go, TypeScript, Python, Rust, etc.)
  • Git integration — Automatic git blame enrichment for author tracking
  • SQLite persistence — Fast local database with indexed queries
  • Branch filtering — Show only TODOs added/modified in a specific branch
  • Zero configuration — Works out-of-the-box on any codebase

Commands

  • todo list — List all TODOs with filters (--branch, --json)
  • todo show <id> — Show TODO details with code context
  • todo done <id> — Mark TODO as completed
  • todo stats — Aggregate statistics (by priority, author)
  • todo tui — Interactive terminal UI (see below)

Interactive TUI

  • Color-coded priorities — Red (critical), Orange (high), Yellow (medium), Green (low)
  • Details panel — Split view showing full TODO context (toggle with `i`)
  • Search & filter — Search with `/`, filter by priority (1-4 keys)
  • Help panel — Press `?` for all keybindings
  • Vim-style navigation — j/k, g/G for movement
  • Dynamic status bar — Shows stats and active filters

Installation

From Source

```bash
go install github.com/joel-pcg/todo-tracker-cli/cmd/todo@latest
```

Build Locally

```bash
git clone https://github.com/joel-pcg/todo-tracker-cli
cd todo-tracker-cli
go build -o todo ./cmd/todo
```

TODO Format

Supports standard TODO formats:
```go
// TODO: Basic task
// TODO(alice): Task with owner
// TODO: [HIGH] Task with priority
// TODO(bob): [CRITICAL] Combined format
```

Keywords: `TODO`, `FIXME`, `HACK`, `XXX`, `BUG`

Technical Stack

Built with:

  • Go 1.23+
  • Cobra (CLI framework)
  • Bubbletea (TUI framework)
  • Lipgloss (terminal styling)
  • SQLite (persistence)

Stats

  • 📁 32 files
  • 📝 4,527 lines of code
  • ✅ 88+ tests passing
  • 📊 90.9% test coverage
  • 🎯 Built with Spec-Driven Development using 7 specialized agent teams

Documentation

Assets 2
Loading