proj

Project tracking and context management for AI-assisted development.

Overview

proj is a command-line tool that tracks project context, decisions, tasks, and sessions in a local SQLite database. It is designed to provide AI assistants with efficient access to project history without requiring expensive context window reloads.

Installation

From Source

git clone https://github.com/victorysightsound/aiproject
cd aiproject
cargo build --release
# Binary at target/release/proj

Homebrew (coming soon)

brew install victorysightsound/tap/aiproject

npm (coming soon)

npm install -g aiproject

Quick Start

# Initialize a new project
proj init

# Check project status (auto-starts session)
proj status

# Log a decision
proj log decision "database" "Using SQLite for local storage" "Simple, portable, no server required"

# Add a task
proj task add "Implement user authentication" --priority high

# End session with summary
proj session end "Set up project structure and made initial architecture decisions"

Commands

Core Commands

Logging

Task Management

Context & Search

Multi-Project

Utilities

For AI Assistants

Token-Efficient Context Loading

# Get JSON snapshot for AI context
proj resume --for-ai

# Check if anything changed since last load
proj delta

# Compress old sessions to reduce tokens
proj compress --auto

Direct Database Access

For maximum efficiency, AI assistants can query the SQLite database directly:

-- Get recent decisions
SELECT topic, decision, rationale
FROM decisions
WHERE status = 'active'
ORDER BY created_at DESC LIMIT 10;

-- Search all content
SELECT * FROM tracking_fts
WHERE tracking_fts MATCH 'authentication';

-- Get active tasks
SELECT description, status, priority
FROM tasks
WHERE status NOT IN ('completed', 'cancelled');

Database location: .tracking/tracking.db

Project Structure

.tracking/
  config.json     # Project configuration
  tracking.db     # SQLite database
  backups/        # Automatic backups

Extension Tables

Add domain-specific tables for specialized tracking:

proj extend --type book    # Book chapters and notes
proj extend --type sermon  # Sermons and points
proj extend --type api     # API endpoints and models
proj extend --type course  # Course modules and lessons

Environment Variables

Global Options

proj --no-color status  # Disable colors for this command
proj --version          # Show version
proj --help             # Show help

License

MIT