AI Time Tracker - Quick Start Guide

🚀 Quick Setup (5 Minutes)

Step 1: Install & Launch

1. Download and install AI Time Tracker
2. Launch the application
3. Grant two permissions when prompted:
   • ✅ Accessibility (tracks apps/windows)
   • ✅ Screen Recording (for OCR features)

Step 2: Optional - Connect TimeCamp

1. Get API token from TimeCamp → Settings → Integration → API
2. Enter token in TimeCamp Timesheet plugin
3. Done! Your entries will sync automatically

Step 3: Start Tracking

• The app tracks automatically in the background
• Use AI button (✨) to auto-fill gaps and get suggestions
• Edit entries with keyboard shortcuts (see below)

⌨️ Essential Keyboard Shortcuts

🤖 AI Features

What AI Can Do

• ✅ Suggest tasks based on your activities
• ✅ Generate descriptions from screen content
• ✅ Auto-fill gaps in your timesheet
• ✅ Learn from corrections to improve over time

How to Use

1. Click the ✨ AI button (bottom left) to auto-fill tracked gaps
2. Click ✨ on any entry to get AI task/description suggestions
3. Review and accept or edit as needed
4. Correct mistakes - AI learns from your changes!

⚠️ Daily Limits

• Free tier has daily AI usage limits
• If you hit the limit: "You've reached your daily AI limit"
• Solution: Manual entry still works; AI resumes tomorrow

📋 Main Features

Automatic Tracking

• ✅ Tracks all applications you use
• ✅ Records window titles
• ✅ Monitors active time
• ✅ Works in background automatically

TimeCamp Integration

• ✅ Sync entries to TimeCamp
• ✅ Pull tasks/projects
• ✅ Real-time updates
• ✅ Conflict detection

Smart Features

• ✅ Auto-refresh (last 7 days every 3 min)
• ✅ Overlap/gap detection
• ✅ Compact mode (tiny window)
• ✅ Keyboard-first workflow

⚙️ System Requirements

Required Permissions (macOS)

1. Accessibility → System Settings → Privacy → Accessibility
2. Screen Recording → System Settings → Privacy → Screen Recording

Storage

• Database: ~/.timecamp/timecamp.db
• Minimal disk space (~10-100MB typical)

Internet

• ✅ Required for AI features
• ✅ Required for TimeCamp sync
• ❌ Not required for tracking (works offline)

🔧 Troubleshooting

📚 MCP Server (For AI Assistants)

What It Does

Allows AI assistants (Claude, Cline) to access your activity data.

Quick Setup

# Install
npx -y ai-time-tracker-mcp

# Add to AI assistant config:
"ai-time-tracker-mcp": {
  "command": "npx",
  "args": ["-y", "ai-time-tracker-mcp"]
}

Use Cases

• "What did I work on yesterday?"
• "How much time in VS Code this week?"
• "Show activities related to Project X"

💡 Pro Tips

1. Keep app running - Add to login items for auto-start
2. Use meaningful window titles - Rename browser tabs for better AI
3. Review suggestions - Correct mistakes to improve AI
4. Organize projects - Clear structure in TimeCamp = better AI
5. Be patient - AI gets better over time

📖 Full Documentation

For complete details, see: AI Time Tracker Complete Guide

🆘 Need Help?

1. Check logs: ~/.timecamp/mcp.log (MCP server)
2. Review docs: /docs/ folder
3. GitHub Issues: Check existing issues or create new one

Quick Start Guide - Last Updated: January 2025