repo-roast
cognis-digital/repo-roast
An AI roasts (and then constructively fixes) your repo — local, free, savage
Instalação
npx convez-ai cognis-digital/repo-roast1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
repo-roast 🔥
Point an AI at your repo and let it roast you — then hand you 3 concrete fixes. Local, free, savage.
#developer-tools #ai #fun #code-review #llm
pip install cognis-repo-roast
repo-roast . # uses a local model (uncensored-fleet) if running
repo-roast . --no-llm # heuristic-only roast, no model needed
Usage — step by step
- Install the console script (PyPI name
cognis-repo-roast, commandrepo-roast):pip install cognis-repo-roast - Roast a repo. The single positional argument is a path (defaults to
.). With a local model running it uses the LLM; otherwise add--no-llm:repo-roast . # roast the current repo repo-roast ../some-project --no-llm # heuristic-only, no model - Get machine-readable output for scripting —
--format jsonprints the score and roast as JSON:repo-roast . --no-llm --format json > roast.json - Read the result. The JSON object contains
score(0–100) androast(the text + fixes). Pull the score out, e.g.:python -c "import json;print(json.load(open('roast.json'))['score'])" - Wire it into CI to track repo hygiene over time:
Point it at any OpenAI-compatible endpoint via- run: pip install cognis-repo-roast - run: repo-roast . --no-llm --format json | tee roast.jsonROAST_ENDPOINTto enable the LLM roast in CI.
Architecture
flowchart LR
R[Your repo] --> S[Signal scan<br/>README/tests/CI/license/docker]
S --> H[Heuristic score]
S --> L[LLM roast + fixes]
H --> O[Score /100]
L --> O2[🔥 Roast + 3 fixes]
Use it from any AI stack
Talks to any OpenAI-compatible endpoint (default: uncensored-fleet uncensored slot); set ROAST_ENDPOINT. Works MCP-side too via JSON.
Related
🤖 uncensored-fleet · 📝 readme tooling in the suite
⭐ Star it, then go fix your README.
Interoperability
repo-roast composes with the 300+ tool Cognis suite — JSON in/out and a shared
OpenAI-compatible /v1 backbone. See INTEROP.md for the
suite map, composition patterns, and reference stacks.
Integrations
Forward repo-roast's findings to STIX/MISP/Sigma/Splunk/Elastic/Slack/webhooks via
cognis-connect. See INTEGRATIONS.md.
License
COCL v1.0 — see LICENSE.