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

Notifications You must be signed in to change notification settings

Fork 0

Star 1

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

2 Commits

2 Commits

.github/workflows

.github/workflows

bin

bin

defaults

defaults

docs

docs

src

src

.gitignore

.gitignore

LICENSE

LICENSE

README.md

README.md

package-lock.json

package-lock.json

package.json

package.json

tsconfig.json

tsconfig.json

Repository files navigation

A team of AI coding agents that coordinates your work and learns from every task.

Requires opencode.

How you use it

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.

Tested on real projects

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.

What it looks like

$ 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=

After a session, agents stage lesson candidates:

$ 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

Commands

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 Override the model for one role.

legioni config list Show current provider and model assignments.

How it works

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.

License

MIT

About

A portable, maturing team of AI coding agents. My name is Legioni, for we are many.

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks

Report repository

Releases 1

legioni v0.4.2

Latest

Jun 15, 2026

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

TypeScript 99.9%

JavaScript 0.1%