Gittrack

AI-powered Git activity tracker and project lifecycle manager

Gittrack is a powerful Git repository tracker and project lifecycle manager that:

• 🔍 Discovers Projects: Scan your system for Git repositories with interactive selection
• 🤖 Auto-commits Changes: Automatically commits your work before generating reports
• 📊 Tracks Project Status: Monitor activity, inactivity, and project health
• 📝 Generates Reports: Daily markdown reports with AI-powered insights
• 🎯 Lifecycle Management: Track projects from initialization to completion
• � Monitors Uncommitted Work: See what's staged, unstaged, and untracked
• 🌳 Supports Nested Repos: Finds Git repositories within Git repositories
• � AI Suggestions: Get intelligent next steps using GitHub Copilot, OpenAI, Anthropic, or Ollama
• 📁 Organized Reports: All reports saved in ~/Gittracker/ folder

Key Features

🔍 Project Discovery

• Interactive Scanning: gittrack scan finds all Git repos in a directory
• Multi-select UI: Choose which projects to track with an intuitive interface
• Nested Repository Support: Discovers repos within repos
• Smart Filtering: Shows which projects are already tracked
• Helpful Instructions: Clear guidance on navigation and selectioning** - Analyzes working directory changes, staged files, and modifications in progress
• 🤖 AI-Powered Suggestions - Uses LLMs (GitHub Copilot, OpenAI, Anthropic, Ollama) to generate intelligent next-step recommendations based on commits AND uncommitted work
• 📝 Daily Reports - Generates markdown reports summarizing your development activity, including work-in-progress
• 🔄### 📊 Project Status Tracking
• Activity Indicators: 🟢 Active / 🟡 Low Activity / 🔴 Inactive
• Last Updated: Shows when the last commit was made ("just now", "2 hours ago", etc.)
• Total Commits: Lifetime commit count per project
• Days Inactive: Automatic calculation of inactivity
• Complete History: Shows ALL commits since .git initialization

📝 Comprehensive Reports

• Project Status Section: See health at a glance
• Recent Changes: All commits with dates and descriptions
• Uncommitted Work: Track staged, unstaged, and untracked files
• AI Suggestions: Intelligent next steps for each project
• Trend Analysis: 4-week commit activity visualization
• Saved Location: All reports in ~/Gittracker/ folder

Installation

# Clone the repository
git clone <repository-url>
cd gittrack

# Install dependencies
npm install

# Build the project
npm run build

Quick Start

1. Initialize a Project

Run in your project directory:

cd /path/to/your/project
gittrack init

This will:

• Initialize a Git repository (if not already initialized)
• Create an initial commit
• Add the project to Gittrack's tracking list

2. Configure LLM Provider

Run the setup wizard:

npm run dev -- setup

Choose your preferred AI provider and model.

3. Work on Your Project

Make changes to your files as usual. No need to manually commit!

Discover and Add Projects

# Scan for Git repositories interactively
gittrack scan ~/Projects

# Scan with custom depth
gittrack scan ~/Code -d 3

# Scan home directory (default)  
gittrack scan

# Instructions shown:
# 📌 Use ↑↓ arrows to navigate, Space to select, Enter to confirm, Ctrl+C to cancel

Generate Reports

# Sync all tracked projects and generate report
gittrack sync

# View the report
cat ~/Gittracker/2026-02-06.md

What happens during sync:

1. 🔄 Auto-commits uncommitted changes in each repo
2. 📊 Analyzes all commits since repo initialization
3. 🔍 Detects uncommitted work (staged, unstaged, untracked)
4. 💡 Generates AI-powered suggestions
5. 📝 Creates markdown report in ~/Gittracker/tion

Configuration

Configuration is stored in ~/.gittrack/config.yaml:

scan_paths: []
use_tracked_projects: true
report_dir: /home/user/gittrack-reports
llm:
  provider: github  # or openai, anthropic, ollama, grok
  model: gpt-4o

GitHub Copilot Integration

Gittrack automatically uses OpenClaw's Copilot credentials if available. To set up:

1. Install and configure OpenClaw
2. Run openclaw onboard and choose GitHub Copilot
3. Gittrack will automatically use the same credentials!

No additional setup needed - just make sure OpenClaw's token is fresh.

Commands

Project Management

gittrack scan [path]           # Scan for Git repos and select which to track
npm run dev -- add <path>      # Add a project to track
npm run dev -- remove <path>   # Remove a project
npm run dev -- list            # List all tracked projects
npm run dev -- init            # Initialize current directory

Reporting

npm run dev -- sync            # Scan repos and generate report
npm run dev -- report          # Show path to latest report
npm run dev -- doctor          # Check configuration health

Configuration

npm run dev -- setup           # Run setup wizard
npm run dev -- config          # Show current configuration

Report Format

Reports are generated as markdown files in your configured report directory:

# gittrack Report — 2026-02-05

**Summary:** 3 active repos · 12 commits in period

---

## /home/user/my-project

**Activity:** 5 commits in period

**Recent commits:**
- feat: Add user authentication (2 hours ago)
- fix: Resolve login bug (3 hours ago)
...

**Next steps (AI)**
1. Implement password reset functionality
2. Add unit tests for authentication flow
3. Set up CI/CD pipeline
...

How It Works

1. Repository Scanning - Gittrack scans your configured Git repositories for recent activity
2. Commit Analysis - Analyzes commit messages, authors, and timestamps
3. Uncommitted Changes Detection - Scans working directory for staged and unstaged modifications
4. AI Processing - Sends repository context (commits + uncommitted work) to your chosen LLM provider
5. Report Generation - Creates a markdown report with AI-generated suggestions
6. Daily Tracking - Maintains history and tracks progress over time

Development

# Run in development mode
npm run dev -- <command>

# Build for production
npm run build

# Run tests (if available)
npm test

Troubleshooting

"No access to model" errors

If using GitHub Copilot:

1. Ensure OpenClaw is installed and configured
2. Run openclaw onboard to refresh your Copilot token
3. Verify you have an active Copilot subscription

Empty reports

• Check that your projects have recent commits
• Verify LLM provider credentials are valid
• Run npm run dev -- doctor to diagnose issues

Token expired

GitHub Copilot tokens expire periodically. Refresh by running:

cd /path/to/openclaw
openclaw onboard

License

[Add your license here]

Contributing

Contributions welcome! Please open an issue or submit a pull request.

Credits

• Built with TypeScript and Node.js
• Integrates with OpenClaw for GitHub Copilot support
• Uses various LLM providers for AI-powered suggestions