toil-radar 0.1.0

Detect, visualize, and reduce DevOps toil

Toil Tracker

🔧 Detect, visualize, and reduce DevOps toil - Installable CLI tool for tracking repetitive operational work

🚀 Quick Install

pip install git+https://github.com/amrutp24/toil-tracker

📱 Usage

Scan a repository for toil:

toil-tracker scan /path/to/your/repo
toil-tracker scan /path/to/repo --days 60

View toil summary:

toil-tracker summary
toil-tracker summary --days 30

Launch web dashboard:

toil-tracker dashboard

🎯 What it Detects

Automatically scans Git commit messages for toil patterns:

• manual_deploy - Manual deployment activities
• manual_fix - Emergency fixes and hotfixes
• revert - Rollbacks and reverts
• env_setup - Environment configuration work
• restart - Service restarts/reboots

📊 Example Output

Scanning /myproject for toil patterns...
✅ Found 15 toil events

Breakdown:
  manual_deploy: 6
  manual_fix: 4
  restart: 3
  env_setup: 2

Toil Summary (last 30 days):
----------------------------------------
manual_deploy: 6 total
  HIGH: 3
  MEDIUM: 2
  LOW: 1
manual_fix: 4 total
  HIGH: 2
  MEDIUM: 1
  LOW: 1

🌟 Why This Matters

30% of engineering time is spent on toil - manual, repetitive work that provides no lasting value. This tool helps you:

1. Identify where your engineering time is going
2. Discover automation opportunities
3. Quantify operational overhead
4. Make informed DevOps decisions

🎯 What It Actually Does

Detects & Visualizes:

• Manual deployment patterns
• Repetitive fixes and hotfixes
• Environment setup work
• Service restarts/reboots
• Rollbacks and reverts

Then you decide where to automate based on the insights.

🛠️ Development Install

git clone https://github.com/amrutp24/toil-tracker
cd toil-tracker
pip install -e .

📈 Next Steps

1. Scan your repos - Find your team's toil patterns
2. Share findings - Show colleagues the automation opportunities
3. Automate the top 3 - Tackle highest-frequency toil first
4. Track improvement - Use dashboard to measure progress

🤝 Contributing

Found a toil pattern we missed? Open an issue or PR!

• Add detection patterns to toil_detector.py
• Improve visualizations in dashboard.py
• Share your toil reduction stories!

📄 License

MIT License - see LICENSE file

---

⚡ Stop wondering where your engineering time goes. Start making data-driven DevOps decisions.