🤖 Warp AI Usage Tracker

A simple shell script to track your Warp AI usage directly from your terminal, without needing to visit the web app every time. Perfect for monitoring your AI requests to avoid overuse!

🚀 Features

• 📊 Complete Usage Statistics: Total requests, daily breakdown, weekly summary
• 📈 All-Time Records: Track your usage since day one
• 🔥 Top Usage Days: See your most active coding days
• ⚡ Quick Check: One-liner status for fast monitoring
• ⚠️ Smart Warnings: Alerts when daily usage gets high
• 🧠 Model Breakdown: See which AI models you're using
• 📱 Easy Aliases: Simple commands like warp-usage and warp-quick

🎯 Why This Exists

Warp AI is awesome but it's paid, so you want to keep track of your usage without constantly checking the web app. This script reads directly from Warp's local SQLite database to give you instant insights.

📦 Installation

Option 1: Quick Install (Recommended)

# Clone the repo
git clone https://github.com/MatchaBear/warp-ai-usage-tracker.git
cd warp-ai-usage-tracker

# Run the installer
./install.sh

Option 2: Manual Install

# Copy scripts to your home directory
cp warp_usage_checker.sh ~/
cp warp_quick_check.sh ~/

# Make them executable
chmod +x ~/warp_usage_checker.sh
chmod +x ~/warp_quick_check.sh

# Add aliases to your shell config
echo 'alias warp-usage="~/warp_usage_checker.sh"' >> ~/.zshrc
echo 'alias warp-quick="~/warp_quick_check.sh"' >> ~/.zshrc
source ~/.zshrc

🎮 Usage

Full Report

warp-usage

Output Example:

🤖 Warp AI Usage Report
=======================

📊 Total AI Requests: 400
🎯 Pertama kali pake Warp AI: 2025-04-06
🕐 Terakhir pake: 2025-06-01
⏱️  Total hari menggunakan: 57 hari
📈 Rata-rata requests per hari: 6.9

📅 Requests Hari Ini: 51
📆 Requests 7 Hari Terakhir: 51

📈 All-Time Breakdown Per Hari:
-------------------------------
   2025-06-01: 51 requests
   2025-05-20: 1 requests
   2025-05-18: 210 requests
   ...

🔥 Top 5 Hari Paling Aktif:
---------------------------
   2025-05-18: 210 requests
   2025-04-08: 98 requests
   ...

Quick Check

warp-quick

Output Example:

🤖 Warp AI Usage: Total 400 | Hari ini 51 | 7 hari 51 | Avg/hari 6.9
⚠️  Warning: Usage hari ini udah 51 requests, lumayan tinggi nih!

🛠️ How It Works

The script reads from Warp's local SQLite database located at:

~/Library/Application Support/dev.warp.Warp-Stable/warp.sqlite

It queries the ai_queries table to get:

• Request timestamps
• Model usage
• Conversation data
• Usage patterns

📋 Requirements

• macOS (where Warp runs)
• Warp Terminal installed
• SQLite3 (pre-installed on macOS)
• Bash/Zsh shell

🚨 Privacy & Security

• ✅ Local only: No data sent anywhere, everything stays on your machine
• ✅ Read-only: Scripts only read from the database, never modify
• ✅ No sensitive data: Only counts and timestamps, no actual query content

🎨 Customization

You can modify the scripts to:

• Change warning thresholds
• Add more statistics
• Customize output format
• Add different time ranges

🤝 Contributing

Contributions welcome! Feel free to:

• Add new features
• Improve the output format
• Add support for other platforms
• Fix bugs or improve performance

📄 License

MIT License - feel free to use, modify, and share!

🙏 Credits

Made with ❤️ for the Warp community. Keep coding and stay aware of your AI usage!

---

Pro tip: Run warp-quick at the start of your coding sessions to check your usage before diving deep into AI-assisted development! 💡