Lanchu

<h1 align="center">Lanchu</h1>

<p align="center"> <b>The control panel and the limits for the AI agents you already have running.</b><br> Coordinate them without collisions. Watch them in real time. Trust what they do. </p>

<p align="center"> <a href="https://www.npmjs.com/package/lanchu"><img alt="npm version" src="https://img.shields.io/npm/v/lanchu"></a> <a href="https://www.npmjs.com/package/lanchu"><img alt="npm downloads" src="https://img.shields.io/npm/dm/lanchu"></a> <a href="https://github.com/lanchuske/lanchu/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/lanchuske/lanchu/actions/workflows/ci.yml/badge.svg"></a> <a href="https://lanchuske.github.io/lanchu/"><img alt="Website" src="https://img.shields.io/badge/website-lanchuske.github.io-0b7285"></a> <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue"></a> <img alt="Node" src="https://img.shields.io/badge/node-%E2%89%A522.5-brightgreen"> <img alt="Protocol" src="https://img.shields.io/badge/protocol-MCP-6E56CF"> <img alt="Runs locally" src="https://img.shields.io/badge/runs-100%25%20local-0b7285"> </p>

---

What problem does it solve?

More and more people use several AI agents (like Claude or Cursor) to build apps or automate their company. But when you put several agents to work at once, two pains show up:

They don't coordinate — and they get in each other's way:

• They step on each other's work — two agents do the same thing.
• They work blind — one doesn't know what the other did.

You can't control them — or trust them:

• They stray out of their lane — an agent touches something it shouldn't.
• The documentation goes stale — nobody keeps the knowledge up to date.
• You can't see anything — you don't know who did what, or what they spent.

Most tools only tackle coordination, and they're built for programmers. Lanchu adds what's missing: control and trust for whoever supervises.

Lanchu does not orchestrate your agents (it doesn't decide their plan). It gives them a shared workspace so they coordinate without colliding, sets scope limits on them, keeps the documentation up to date, and gives you a panel + history to see and trust what they do — even if you're not technical.

How it works (the idea)

1. You launch your agents as always (with the tool you already use).
2. Each agent registers in your organization and takes on a role.
3. From there, it only works on what it's responsible for: it claims tasks, reads the shared documentation, and Lanchu rejects and records any action outside its lane. The agents coordinate through Lanchu, not by talking to each other — that's why you can see and bound everything.
4. You watch the real-time panel: who's active, what they're working on, what documentation they create, and a history of everything they did.

Lanchu sets cooperative, auditable limits: it blocks what passes through it and leaves everything in plain sight. It's not a system cage — the trust comes from seeing it all.

How it fits

Agents coordinate through Lanchu (a shared blackboard), never directly with each other — so every action is visible and can be bounded.

flowchart TB
    A1["Agent A"] -->|MCP| L
    A2["Agent B"] -->|MCP| L
    subgraph L["Lanchu — local server"]
        S["Shared state · roles · audit log"]
    end
    L --> P["Supervisor panel<br/>(real-time + history)"]
    L -. resource updates .-> A1
    L -. resource updates .-> A2

Quick start

npx lanchu "fix the login"

Note: Early release (0.1.0). Requires Node >= 22.5. See DEFINITION.md for the full picture and CLI.md for the command surface.

What the first version includes

• Organizations and projects — group your agents and their work.
• Registration and roles — each agent knows who it is and what it can touch.
• Coordination with scope control — nobody duplicates or steps on each other; actions outside the role are rejected and recorded.
• Real-time panel — you see what each agent does and what it's on.
• History (audit log) — everything they did is recorded, so you can trust it.
• Shared, traceable documentation — the knowledge is always up to date.

What comes next (recurring functions, skills, cloud organizations…) is in the roadmap.

Who it's for

For anyone who supervises several agents working toward a common objective: to build an app, automate processes, or coordinate a company's work. Lanchu sits on top of or alongside the tools you already use to launch agents.

In this first version there are two roles: an operator (semi-technical) who does the initial setup —running a command, connecting your agents—, and a supervisor who watches and trusts from the panel, without needing to be a programmer.

Contributing

Lanchu is open source and contributions are welcome in a controlled way. Start with the project definition, then the contributing guide. Have an idea? Open a feature request or start a thread in Discussions › Ideas.

• Code of Conduct
• Security policy

License

MIT