thufir

Thufir - AI-Powered Root Cause Analysis

Autonomous root cause analysis for production incidents. Integrates with Prometheus, GitHub, and GitLab to investigate alerts, analyze metrics, search code, and generate comprehensive RCA reports.

Quick Install

From Marketplace (Recommended)

# Add the marketplace
/plugin marketplace add evangelosmeklis/thufir

From GitHub

git clone https://github.com/evangelosmeklis/thufir.git
cc --plugin-dir ./thufir

Quick Start

1. Configure (Optional)

Create .claude/thufir.local.md:

---
prometheus:
  endpoint: "https://prometheus.example.com"

github:
  token: "ghp_your_token"
  default_repo: "owner/repo"

gitlab:
  token: "glpat_your_token"
  default_project: "group/project"
---

Get tokens:

• GitHub: https://github.com/settings/tokens (needs repo scope)
• GitLab: https://gitlab.com/-/profile/personal_access_tokens (needs api scope)

2. Use It

** Just write this in claude code**

/thufir

and a drop down will appear

Example Output

# Root Cause Analysis Report
Date: 2025-12-19
Alert: HighErrorRate - api-service

## Summary
95% error rate at 14:32 UTC due to database connection pool exhaustion

## Root Cause
File: src/database/connection.js:45
Commit: abc123 by John Doe on 2025-12-19
Issue: Connection pool reduced from 100 to 10 connections

## Fix
Revert pool size change or increase based on load testing

Requirements

• Claude Code CLI
• Git repository (for code analysis)
• Optional: Prometheus endpoint, GitHub/GitLab tokens

---

Made with Claude Code with ❤️ in Athens, Greece