Skip to main content

​
Issue tracking built for AI agents

Track dependencies, coordinate multiple agents, and find ready work automatically. Git-friendly storage keeps everything in sync.

Get StartedCommand Reference

​
Quick start

Get up and running with Tracer in under a minute

1

Install Tracer

Install via Cargo from the GitHub repository:
cargo install --git https://github.com/Abil-Shrestha/tracer
Requires Rust toolchain. See installation guide for other methods.
2

Initialize in your project

Navigate to your project directory and initialize Tracer:
tracer init
This creates a .trace directory with a SQLite database for tracking issues.
3

Create your first issue

Create an issue with priority and type:
tracer create "Implement user authentication" -p 1 -t feature

✓ Created issue bd-1 Implement user authentication
4

Find ready work

Check what’s ready to work on (no blockers):
tracer ready
Your new issue appears in the ready list. Start work by updating its status:
tracer update bd-1 --status in_progress

​
Explore by topic

Learn about Tracer’s core features and capabilities

Core concepts

Understand issues, statuses, priorities, and issue types

Dependencies

Track relationships between tasks with four dependency types

Multi-agent

Coordinate multiple AI agents with comments and auto-assignment

Ready work

Find unblocked tasks automatically

Git integration

JSONL export/import for git-friendly storage

JSON output

Programmatic access for AI agents

​
Key features

What makes Tracer powerful for AI agent workflows

​
Dependency tracking

Four relationship types: blocks, parent-child, related, and discovered-from. Prevent work on blocked tasks.

​
Multi-agent coordination

Comments for communication, auto-assignment when work starts, and visibility into who’s working on what.

​
Ready work detection

Automatically find tasks with no open blockers. Filter by priority and limit results for focused work.

​
JSON output

Every command supports —json flag for programmatic access. Perfect for AI agents and automation.

​
Git-friendly storage

JSONL export/import format. One issue per line for easy git diffs. Auto-sync after pull.

​
SQLite storage

Fast local database with auto-discovery. Full audit trail. No external dependencies.

​
Ready to get started?

Install Tracer and start tracking your AI agent workflows in minutes

View Installation Guide

Build docs developers (and LLMs) love

Get started for freeTalk to us