Legion

Built for Cursor. Works in VS Code. A full AI agent army for any codebase.

Compounding entity-graph wiki. Module narrative docs. Cognitive-layer reviews.
Auth, DB, DevOps, payments, security, UX, design-system, SEO/AEO audits.
Fourteen guardians. One sidebar.

_{The God Protocol's flagship extension — engineered around Cursor's subagent model first, packaged for the VS Code Marketplace so it installs in either editor.}

Install in Cursor  ·  Install in VS Code  ·  Source  ·  Sponsor  ·  Linktree

Why Legion

What it does

Quickstart

In Cursor (recommended)

1. Open Cursor → Extensions panel (Ctrl/Cmd + Shift + X)
2. Search for Legion (publisher: thenotoriousllama)
3. Click Install — Cursor reads the same VS Code Marketplace, so the extension you see is this one
4. Open the Command Palette (Ctrl/Cmd + Shift + P) → Legion: Initialize Repository → then Legion: Document Repository

Why Cursor first? Legion's guardians are subagents that talk to each other through Cursor's native subagent runtime. They run in VS Code too (via the same cursor agent CLI bridge or direct Anthropic API mode), but Cursor is where the architecture lights up — fan-out, parallel reasoning, and shared chat context all just work.

In VS Code

1. Install from the Marketplace (or ext install thenotoriousllama.legion from the Command Palette)
2. Set legion.agentInvocationMode to direct-anthropic-api and add your legion.anthropicApiKey (or set LEGION_ANTHROPIC_API_KEY) — this bypasses the Cursor CLI requirement
3. Same Command Palette flow: Legion: Initialize Repository → Legion: Document Repository

That's it. The wiki lives at library/knowledge-base/wiki/. Commit it. Your future self thanks you.

Output structure

The shape Legion writes into your repo on first Initialize:

your-repo/
├── .legionignore                      # gitignore-style patterns to skip
├── .legion/                            # extension state (do not commit)
│   ├── config.json
│   ├── file-hashes.json               # hash manifest for delta tracking
│   ├── queue/                          # invocation queue (queue-file mode)
│   ├── git-cache/                      # cached git log/blame outputs
│   └── chunks/                         # in-progress scan state
├── .cursor/
│   ├── agents/
│   │   ├── wiki-guardian.md            # the entity cartographer
│   │   └── library-guardian.md         # the module-narrative author
│   └── skills/
│       ├── wiki-weapon/
│       └── library-weapon/
└── library/                            # the wiki itself (commit this)
    ├── knowledge-base/
    │   ├── <module>/                   # library-guardian writes module narratives here
    │   └── wiki/                       # wiki-guardian writes entity stubs here
    │       ├── index.md
    │       ├── hot.md
    │       ├── log.md
    │       ├── overview.md
    │       ├── entities/
    │       ├── concepts/
    │       ├── decisions/
    │       ├── comparisons/
    │       ├── questions/
    │       └── meta/
    ├── notes/
    ├── qa/
    └── requirements/
        ├── issues/
        └── features/

Companion plugins

Legion for Obsidian Brings Legion's wiki operational state into Obsidian — status panel, contradiction inbox, human annotations, entity color coding, and a one-click trigger for incremental scans. Built for the non-developers on your team. Read the Obsidian docs →

Settings

About the author

Mario Aldayuz Marine Corps veteran. Creative-Director-turned-AI-founder. Automation architect. After ~10 years as Creative Director at Blue Ridge Media Company, I traded calibration tools and brand systems for code — building intelligent systems that help businesses operate at peak performance. Today I'm the founder of OllieBot.ai (omnichannel AI customer-service agent) and ManageN8N (the ultimate N8N instance manager), and I run elite automation consulting through Wise Guys Consulting. Legion is the tool I wish I'd had every time I dropped into a new codebase cold. Off the clock — fine bourbon, a good cigar, and Harley the dog. marioaldayuz.com  ·  Linktree  ·  GitHub

Support

If Legion saved you a weekend, buy me a coffee — or a finger of bourbon.

Connect

• Linktree — linktr.ee/marioaldayuz
• Website — marioaldayuz.com
• GitHub — @thenotoriousllama
• Issues — github.com/thenotoriousllama/legion/issues

License

Legion is distributed under the Legion Source-Available License v1.0 (LSAL). Copyright (c) 2026 Mario Aldayuz. All rights reserved.

TL;DR — what you can do

• Install, run, and use Legion for personal use or for your own organization's internal operations, on any number of devices you own or control.
• Read and modify the source for your own internal use.
• Publish, share, and distribute the Output Legion generates (wiki pages, exports, PR comments, dashboards, etc.) — anywhere, in any medium.

Attribution is required. Every published Output must keep a visible attribution and link, and any blog post, talk, demo, video, or screenshot featuring Legion must credit it. Use this string (or its functional equivalent in your medium):

Built with Legion by Mario Aldayuz

What you can't do — redistribute the Software (modified or unmodified), host it as a service for third parties, build a competing product on top of it, remove attribution, or use the Legion name and logo beyond reasonable nominative use.

Read the full terms in LICENSE. For commercial licensing, OEM redistribution, hosted offerings, or any permissions beyond the LSAL, reach out.