Show HN: Legioni – a bunch of AI agents always with you

Legioni, a team of AI coding agents that coordinates work and learns from every task, has been released as an open-source tool. The agents plan, implement, review, and test code, with lessons from each session being promoted to improve future performance. Legioni requires the opencode tool and supports multiple programming languages and frameworks.

A team of AI coding agents that coordinates your work and learns from every task. Requires opencode https://github.com/anomalyco/opencode . one-time install needed for promote, install, upgrade-team npm install -g legioni cd your-project legioni init detects stack, compiles agents Or without installing anything: cd your-project npx legioni init Then start opencode and type your task: opencode @orchestrator add a truncate text, max len, suffix='...' function with tests That's it. The orchestrator plans the work, delegates to specialist agents, and loops until tests pass. You watch. orchestrator → architect → plan.md → implementer → code + tests → reviewer → passes or fails → test-strategist → edge cases + full suite ← done: code is written, tested, and reviewed After the session, the agents propose lessons from what they learned: legioni promote review each lesson, approve or reject legioni install recompile agents with the approved lessons Next task, those lessons are active. The team gets better each time. | Project | Language | Tests | What happened | |---|---|---|---| | Apache Commons Compress | Java / Maven | 1890 | All pass, reviewer ran real mvn test | | Apache Commons Text | Java / Maven | 1890 | All pass, orchestrator fixed corrupted existing code, reviewer verified | | truncate function | Python / pytest | 13 | Architect's spec had arithmetic errors, reviewer caught them, implementer fixed | | slugify + Unicode | Python / pytest | 50 | Implementer missed Nordic letters, reviewer failed it, implementer fixed on cycle 2. Lesson promoted. Next project, caught on first pass. | bash $ legioni init Running project recon ... done → .legioni/project.md Compiling team → opencode agents ... done → ~/.config/opencode/agent/architect.md → ~/.config/opencode/agent/implementer.md → ~/.config/opencode/agent/orchestrator.md → ~/.config/opencode/agent/reviewer.md → ~/.config/opencode/agent/test-strategist.md → ~/.config/opencode/agent/db-expert.md legioni init complete. On a real project, recon detects your stack: .legioni/project.md auto-generated Stack - Language: Java - Framework: Maven Commands - Build: mvn compile - Test: mvn test - Targeted test: mvn test -Dtest=<TestClass After a session, agents stage lesson candidates: bash $ legioni promote Reading staged lessons from .legioni/lessons.staging. .md ... ──────────────────────────────────────────────────────────── Role: reviewer Slug: nordic-char-limitation-in-nfkd ──────────────────────────────────────────────────────────── Situation: Reviewing a Unicode normalization implementation that used pure NFKD + ASCII encoding. Decision: Flagged as failure because ø, Ø, æ, Æ have no NFKD decomposition — they get dropped entirely. Why: A manual transliteration table is needed before NFKD. ──────────────────────────────────────────────────────────── Promote? y/n/q y → Promoted to ~/.legioni/lessons/reviewer/ nordic-... .md ──────────────────────────────────────────────────────────── Role: orchestrator Slug: task-brief-precision ──────────────────────────────────────────────────────────── Situation: The codebase had no Hex class — the complete class had to be created from scratch. Decision: Wrote a detailed task brief with acceptance criteria covering null handling and hex alphabet. ──────────────────────────────────────────────────────────── Promote? y/n/q n | Command | What it does | |---|---| legioni init | Setup. Scaffolds team store, picks provider, detects stack, compiles agents. | legioni install | Recompile agents after promoting lessons or changing config. | legioni update | Re-detect stack and recompile. Use when the project changed. | legioni promote | Review staged lesson candidates interactively. | legioni upgrade-team | Diff defaults against your team store and upgrade changed roles. | legioni config set-provider | Change model provider interactive menu . | legioni config set-model <role <model | Override the model for one role. | legioni config list | Show current provider and model assignments. | legioni init copies role definitions into ~/.legioni/roles/ . The store is portable across machines. legioni install reads each role, appends promoted lessons, applies model overrides, writes agent files to ~/.config/opencode/agent/ . legioni init also detects your stack and writes .legioni/project.md , registered in opencode.json .- During a session, agents write workspace artifacts plan, review, test results and stage lesson candidates. legioni promote lets you review and promote lessons. They get injected into agent prompts on next compile. legioni upgrade-team syncs your store with newer defaults from legioni releases. MIT