Tracer

Tracer is a blazing-fast, lightweight issue tracker specifically designed for AI coding agents. This innovative tool allows users to efficiently track their work, manage dependencies among tasks, and quickly discover actionable items—all through an intuitive command-line interface (CLI).

Key Features

• Centralized Task Management: Keep all tasks organized without scattered TODO lists, making tracking effortless.
• Dependency Linking: Clearly define relationships, such as when one task cannot begin until another is completed.
• Instant Preparation Insights: Instantly identify tasks that are ready for work, improving productivity and focus.
• AI Agent Optimization: Tailored for AI agents, enabling them to autonomously track their tasks across different sessions.
• Git-Integration: All data is stored in a simple JSON format, making it easy to sync via Git while leveraging version control benefits.

Usage Scenarios

For example, when developing a login system, you might need to first design a database schema before implementing the API and subsequently building the user interface. Tracer efficiently manages these task dependencies, allowing users to always see what tasks can be started without blockage.

Performance

Tracer is designed for speed, with operations averaging around 5 milliseconds each. It efficiently handles dependencies and task queries, ensuring that using it does not slow down the workflow.

Installation and Getting Started

To quickly get started with Tracer, it can be installed using:

cargo install --git https://github.com/Abil-Shrestha/tracer

After installation, initializing the project can be accomplished easily:

tracer init

Users can also explore interactive tutorials using:

tracer learn

Example Workflow with Dependencies

Here’s how one might manage a feature development workflow:

# Create an epic feature
tracer create "User authentication system" -t epic

# Create subtasks
tracer create "Design database schema" -t task
tracer create "Build login API" -t task
tracer create "Create login UI" -t task

# Link task dependencies
tracer dep add test-3 test-2 --type blocks

# Check available tasks to work on
tracer ready
# → Displays tasks that are ready like test-2 (Design database schema)
# → Hides test-3 as it is blocked by test-2

# Update task status to in progress
tracer update test-2 --status in_progress

Why Choose Tracer?

• Speed: Quick operations enhance productivity without hindrance.
• AI Compatibility: Designed with programmability in mind, using JSON output to facilitate integration with AI agents.
• Smart Dependency Management: Automatic detection of available work based on task dependencies.
• Git-native Structure: Easily manage and track all changes in a version-controlled manner.
• Distributed System: Allows seamless sharing of tasks among multiple agents.
• Audit Trail: Every alteration is recorded, maintaining detailed logs of changes.

Comprehensive Command Set

Users can utilize a variety of commands for core operations, dependency tracking, and data management. For instance:

# Create a new task
tracer create "Task Title" [-p priority] [-t type]
# List open tasks
tracer list [--status open] [--priority 1]

Documentation and Contribution

For additional resources, including a Quick Start Guide and AI Integration Documentation, consult the comprehensive documentation. Contributions to the project are encouraged; guidelines can be found in the CONTRIBUTING.md file.

Explore Tracer on GitHub here for further information or to report any issues.