Skip to main content

Tracks v0.1.0: CLI Foundation Complete

· 4 min read
Aaron Ross
Aaron Ross
Creator of Tracks, Owner of Anomalous Ventures

Tracks v0.1.0 is now available! This first release completes the CLI infrastructure foundation with a robust, extensible command-line tool ready for project generation.

What's in v0.1.0

Status: Phase 0 - Foundation (Epic 1: CLI Infrastructure ✅)

Available Now:

  • Full CLI with Cobra framework integration
  • Multiple output modes (Console, JSON, TUI-ready)
  • Smart environment detection (TTY, CI, piped output)
  • Theme system with Lip Gloss styling
  • Comprehensive test coverage
  • Complete documentation

Try It:

# macOS
brew install anomalousventures/tap/tracks

# Any platform with Go
go install github.com/anomalousventures/tracks/cmd/tracks@v0.1.0

# Verify installation
tracks version

What's Working​

Core CLI Commands​

The tracks CLI is now fully operational with:

tracks version       # Display version information
tracks --help        # Show help for any command
tracks --json <cmd>  # Machine-readable JSON output

All commands support global flags for controlling output format and verbosity.

Multiple Output Modes​

Tracks automatically detects your environment and chooses the best output format:

$ tracks version
Tracks v0.1.0
Commit: abc123def
Built: 2025-10-25T08:00:00Z

The CLI supports Console (human-readable), JSON (machine-readable), and TUI (Phase 4) modes. It intelligently switches based on TTY detection, CI environment, and flags like --json. See the Output Modes documentation for details.

Architecture & Testing​

The CLI uses a clean Renderer pattern separating business logic from output formatting, making it easy to add new modes without touching command logic. All flags can be configured via TRACKS_* environment variables.

The codebase includes comprehensive unit and integration tests with 90%+ coverage in critical paths.

Documentation​

Full documentation is available at go-tracks.io:

What's Next​

With the CLI foundation complete, development moves to Epic 2: Template Engine & Embedding.

Phase 0 - Next Steps​

Epic 2: Template Engine (Starting Soon)

  • Embed file system for project templates
  • Template variable interpolation
  • File structure generation
  • Template validation and testing

Epic 3: Project Generation (After Epic 2)

  • tracks new <project> command
  • Interactive project configuration
  • Database driver selection (postgres, sqlite, libsql)
  • Authentication method selection (session, jwt, oauth)

See the complete Roadmap for details on all planned features.

Installation​

From Source​

# Clone repository
git clone https://github.com/anomalousventures/tracks.git
cd tracks

# Build CLI
make build

# Binary available at ./bin/tracks
./bin/tracks version

From Release​

Package Managers:

# macOS (Homebrew)
brew install anomalousventures/tap/tracks

# Windows (Scoop)
scoop bucket add anomalousventures https://github.com/anomalousventures/scoop-bucket
scoop install tracks

# Go install
go install github.com/anomalousventures/tracks/cmd/tracks@v0.1.0

Docker:

docker run --rm ghcr.io/anomalousventures/tracks:0.1.0 version

Direct Downloads:

Pre-built binaries for Linux, macOS, and Windows are available on the GitHub Releases page.

Contributing​

Tracks is open source and welcomes contributions! The project is in active development with clearly defined epics and tasks.

Ways to contribute:

Acknowledgments​

v0.1.0 wouldn't be possible without these excellent projects:

Have questions or feedback? Find us on GitHub or open a Discussion.

Tracks is part of Anomalous Ventures, building tools to make developers more productive.