🦜

Iago

Greptile-style Mermaid diagrams for AI code reviews — but driven by your own agent.
Iago perches on top of a /review comment and squawks a visual summary of the change: sequence, flow, class, or entity-relation.

"Awk! Awk! Add a diagram!"

See it

Iago turns a PR diff into a diagram and posts it on top of your /review comment:

flowchart TD
    Start([read line]) --> Empty{empty?}
    Empty -- yes --> Start
    Empty -- no --> Norm[normalize unicode]
    Norm --> G2P{lang == ru?}
    G2P -- yes --> Vosk[vosk-tts-rs]
    G2P -- no --> Misaki[misaki-rs G2P → Kokoro]
    Vosk --> Encode[/opus encode/]
    Misaki --> Encode
    Encode --> Out([write stdout])

Loading

• A skill, not a SaaS — your coding agent draws the diagram with the LLM it already runs. No API key, no third-party reviewer.
• Works across agents — Claude Code, Codex, Copilot, Gemini: the same SKILL.md.
• Type auto-detected — sequence, flow, class, or entity-relation, picked from the diff. Override with /iago <type>.

Quick start

Requirements: bun + authenticated gh.

bunx @drakulavich/iago install --force        # installs the skill into your agent(s)

Claude Code user? Install the plugin instead: /plugin marketplace add drakulavich/iago then /plugin install iago@iago-marketplace.

Then, in your agent, run /review on a PR and follow with:

/iago        # or /squawk — appends the diagram to the /review comment

→ All install options: docs/install.md · Usage & diagram types: docs/usage.md

Why?

Greptile and CodeRabbit auto-add Mermaid diagrams to every PR; Claude Code's and Codex's /review don't draw. Iago fills that gap — using the agent you already run, without locking you into a SaaS reviewer.

Docs

• Install — all agents & options
• Usage, diagram types & /review hookup
• Diagram-selection rubric
• Contributing — repo layout, build & test
• Agent config: AGENTS.md → CLAUDE.md

License

Made with 🦜 squawks and zero SaaS lock-in, under the MIT License.