// Terminal AI Agents 2025 — framework comparison matrix
// Compares the most-cited agents from the survey across provider type,
// install ecosystem, key differentiator, and FreeBSD 14.3 compatibility.
// Build: dot -Tpng diagram-comparison.dot -o diagram-comparison.png
digraph terminal_agents_comparison {
    rankdir=TB;
    graph [bgcolor="white", fontname="Helvetica", fontsize=11,
           pad="0.3", nodesep="0.3", ranksep="0.4", compound=true];
    node  [shape=box, style="rounded,filled", fontname="Helvetica",
           fontsize=10];
    edge  [fontname="Helvetica", fontsize=9, color="#888888"];

    // Column legend (every row below uses this order)
    legend [label="{ Agent | Stars (Dec 2025) | Install | Key differentiator | FreeBSD 14.3 }",
            shape=record, fillcolor="#fafafa", color="#444444", fontcolor="#444444"];

    // Enterprise tier — "The Big Three"
    subgraph cluster_enterprise {
        label="Enterprise tier (vendor-backed)"; labeljust="l";
        style="rounded,filled"; color="#1d4ed8";
        fontcolor="#1d4ed8"; bgcolor="#eff6ff";

        cc [label="{ Claude Code | 48,023 | npm i -g @anthropic-ai/claude-code | MCP, 5 permission modes, SWE-bench 72%+ | works }",
            shape=record, fillcolor="#dbeafe", color="#1d4ed8", fontcolor="#1d4ed8"];
        gem [label="{ Gemini CLI | 88,306 | npm i -g @google/gemini-cli | 1k req/day free, 1M-token context | works }",
             shape=record, fillcolor="#dbeafe", color="#1d4ed8", fontcolor="#1d4ed8"];
        cdx [label="{ OpenAI Codex CLI | 54,514 | npm i -g @openai/codex | ChatGPT subscription, lightweight | fails (explicit FreeBSD check) }",
             shape=record, fillcolor="#dbeafe", color="#1d4ed8", fontcolor="#1d4ed8"];
    }

    // Open-source champions
    subgraph cluster_oss {
        label="Open-source champions"; labeljust="l";
        style="rounded,filled"; color="#15803d";
        fontcolor="#15803d"; bgcolor="#f0fdf4";

        oh  [label="{ OpenHands | 65,846 | (containerized) | end-to-end software-engineering agent | n/a (container) }",
             shape=record, fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        oi  [label="{ Open Interpreter | 61,209 | uv tool install open-interpreter | exec() loop for Python/JS/shell | works (44 min build) }",
             shape=record, fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        cln [label="{ Cline | 56,318 | (VS Code extension) | autonomous coding in editor | n/a }",
             shape=record, fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        aid [label="{ Aider | 39,129 | pip install aider-chat | git-native, 84.9% polyglot accuracy | fails (tree-sitter parser.h) }",
             shape=record, fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        cnt [label="{ Continue | 30,453 | npm i -g @continue/cli | TUI + headless, custom assistants | not tested }",
             shape=record, fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
    }

    // Specialist / niche tier
    subgraph cluster_niche {
        label="Specialist tier"; labeljust="l";
        style="rounded,filled"; color="#6b21a8";
        fontcolor="#6b21a8"; bgcolor="#f5f3ff";

        gse [label="{ Goose | 24,922 | (Block/Square) | enterprise workflows | issues (langfuse.decorators) }",
             shape=record, fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
        amp [label="{ Amp | n/a | binary from ampcode.com | Sourcegraph agent, Go binary | works }",
             shape=record, fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
        ghc [label="{ GitHub Copilot CLI | n/a | gh extension install github/gh-copilot | command suggest + explain via gh | works }",
             shape=record, fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
        gpt [label="{ gptme | 4,089 | pip install gptme | shell + Python + browser + vision | not tested }",
             shape=record, fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
        efr [label="{ Efrit | 338 | (Emacs package) | pure Elisp, Steve Yegge | works }",
             shape=record, fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
    }

    // Cross-cutting protocol callout
    proto [label="Emerging protocols\nMCP (Anthropic) — Claude Code, Cursor, Cline, Continue\nACP (Zed)  — Apache-licensed editor/agent standard",
           shape="note", fillcolor="#fef9c3", color="#a16207",
           fontcolor="#a16207"];

    // Invisible edges keep legend → enterprise → oss → niche → protocols stacked
    legend -> cc  [style=invis, lhead=cluster_enterprise];
    cc     -> oh  [style=invis, lhead=cluster_oss,   ltail=cluster_enterprise];
    oh     -> gse [style=invis, lhead=cluster_niche, ltail=cluster_oss];
    gse    -> proto [style=invis, ltail=cluster_niche];
}

// Terminal AI agents 2025 -- vendor clusters with shared protocol bridges
digraph terminal_ai_ecosystem {
    rankdir=LR;
    graph [bgcolor="white", fontname="Helvetica", fontsize=11,
           pad="0.3", nodesep="0.3", ranksep="0.55"];
    node  [shape=box, style="rounded,filled", fontname="Helvetica",
           fontsize=10, fillcolor="#dbeafe", color="#888", fontcolor="#555"];
    edge  [color="#888", fontcolor="#555"];

    subgraph cluster_anthropic {
        label="Anthropic"; style="rounded"; color="#b91c1c"; fontcolor="#b91c1c";
        claude_code [label="Claude Code", fillcolor="#fee2e2", color="#b91c1c", fontcolor="#b91c1c"];
    }

    subgraph cluster_openai {
        label="OpenAI"; style="rounded"; color="#b45309"; fontcolor="#b45309";
        codex_cli [label="Codex CLI", fillcolor="#fef3c7", color="#b45309", fontcolor="#b45309"];
    }

    subgraph cluster_google {
        label="Google"; style="rounded"; color="#1d4ed8"; fontcolor="#1d4ed8";
        gemini_cli [label="Gemini CLI", fillcolor="#dbeafe", color="#1d4ed8", fontcolor="#1d4ed8"];
    }

    subgraph cluster_oss {
        label="Open Source"; style="rounded"; color="#15803d"; fontcolor="#15803d";
        aider      [label="Aider",            fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        cline      [label="Cline",            fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        continue   [label="Continue",         fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        openhands  [label="OpenHands",        fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        oi         [label="Open Interpreter", fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        goose      [label="Goose (Block)",    fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
        gptme      [label="gptme",            fillcolor="#dcfce7", color="#15803d", fontcolor="#15803d"];
    }

    subgraph cluster_protocols {
        label="Shared Protocols"; style="rounded"; color="#6b21a8"; fontcolor="#6b21a8";
        mcp [label="MCP\n(Model Context Protocol)", fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
        acp [label="ACP\n(Agent Client Protocol)",  fillcolor="#ede9fe", color="#6b21a8", fontcolor="#6b21a8"];
    }

    claude_code -> mcp;
    cline       -> mcp;
    continue    -> mcp;
    codex_cli   -> mcp;
    goose       -> mcp;
    gemini_cli  -> mcp;

    continue -> acp;
    cline    -> acp;
    aider    -> acp [style=dashed];
}