karmaIQ — Production Intelligence for Claude Code
Coding tools see your code. karmaIQ shows what that code does in production.
karmaIQ brings real-time service-mesh truth — error rates, latency, dependencies, root cause — directly into your Claude Code session. It closes the gap between the file in front of you and the system actually running in prod.
This repository is the karmaIQ plugin marketplace: a set of composable Claude Code plugins, each targeting a specific production-intelligence workflow.
What makes it different
- Live production signal, not static analysis — QPM, error %, p99 latency, amplification per edge, real callers
- Autonomous SRE subagents — incident, impact, architecture, and canary workflows run in isolated context, returning focused summaries instead of flooding your chat
- Path-scoped + event-driven — pre-warms on API mentions, hints blast radius on
git commit, surfaces canary verdicts before promotion
- Read-only by design — every subagent restricted to karmaIQ MCP tools. No Bash, Edit, or shell access. Safe to install.
Install
Inside Claude Code:
/plugin marketplace add codekarma-tech/codekarma-mcp-plugin
/plugins
Then install the plugins you need (see persona matrix below).
Plugins
| Plugin | For | What it does |
|---|
karmaiq-core | Everyone (install first) | MCP connection, domain picker, mesh exploration skill |
karmaiq-firefighter | On-call SRE | Autonomous incident diagnosis. Pre-warms service lookups on user prompts |
karmaiq-impact | Devs pre-commit | Blast-radius check before changing methods. Hints from staged diff on commit |
karmaiq-architect | Architects | Cycles, SPOFs, dead code, hot methods, fan analysis |
karmaiq-promotion-gate | CI/CD | Canary regression verdict — STABLE / WATCH / REGRESSION / INSUFFICIENT_DATA |
Install by persona
# SRE / on-call
/plugin install karmaiq-core@karmaiq
/plugin install karmaiq-firefighter@karmaiq
# Dev (pre-commit safety)
/plugin install karmaiq-core@karmaiq
/plugin install karmaiq-impact@karmaiq
# Architect (structural review)
/plugin install karmaiq-core@karmaiq
/plugin install karmaiq-architect@karmaiq
# CI/CD (canary gate)
/plugin install karmaiq-core@karmaiq
/plugin install karmaiq-promotion-gate@karmaiq
After installing karmaiq-core, run /karmaiq-core:setup to pick your active CodeKarma domain (cached across sessions).
Command cheatsheet
| Command | Plugin | What |
|---|
/karmaiq-core:setup | core | Pick active CodeKarma domain (one-time) |
/karmaiq-core:overview | core | Snapshot active domain — top services, top errors |
/karmaiq-core:domain [name] | core | Show or switch active domain |
/karmaiq-firefighter:fire <api> | firefighter | End-to-end RCA on a failing API |
/karmaiq-firefighter:rca <id> | firefighter | Upstream root-cause walk |
/karmaiq-firefighter:errors | firefighter | Top error-rate interfaces right now |
/karmaiq-impact:method <svc> <method> | impact | Blast radius of changing one method |
/karmaiq-impact:service <svc> | impact | What breaks if this service goes down |
/karmaiq-impact:path <from> <to> | impact | All paths between two services |
/karmaiq-architect:cycles | architect | Circular dependencies in the mesh |
/karmaiq-architect:spof | architect | Single points of failure |
/karmaiq-architect:deadcode <svc> | architect | Methods Nexus marked inactive |
/karmaiq-architect:hot <svc> | architect | Top CPU-consuming methods |
/karmaiq-architect:fan [in|out] | architect | Most-depended-on / most-fanning-out |
/karmaiq-promotion-gate:canary <svc> | promotion-gate | Canary regression verdict |
/karmaiq-promotion-gate:diff <a> <b> | promotion-gate | Cross-entity regression diff |
Many flows trigger automatically from natural-language prompts too — see EXAMPLES.md for the full journey.
First steps after install
See EXAMPLES.md for a guided user journey — copy-pasteable prompts with expected outputs, walking you through:
- 5-minute first-boot tour — pick domain, snapshot the mesh, test the pre-warm hook
- Journey 1 — SRE on-call: incident lands at 2 AM, firefighter subagent runs end-to-end RCA
- Journey 2 — Dev refactor safety: "is this method safe to delete?", pre-commit impact warnings
- Journey 3 — Architect quarterly review: full-domain risk register via the architect subagent
- Journey 4 — CI/CD canary gating: STABLE / WATCH / REGRESSION / INSUFFICIENT_DATA verdicts
- Crossover workflows + a pattern cheat sheet
Skip permission prompts for karmaIQ tools
