@a-t-h-i/bot-lobby0.6.54
Structured multi-agent software engineering orchestrator for Pi
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
Bot-Lobby
Bot-lobby is a determenistic agentic coding engine. You can come up with a vague description of what you want to create, the agents (Oracle, Dev, Design, QA and Research) ask you a series of questions to help you form a clear picture from the vague description you've provided. The agents can even generate UI mockups that you can pick from. Once you come to an agreement with the agents, they will then get to work, and the harness will enforce the agreed upon plan. The agents are required to follow it faithfully.
I came up with the name bot-lobby from my 6+ years worth of experience in playing online FPS games. The name is normally used as a joke or to mock the other players by stating that you're playing in a bot lobby (playing with robots) because of how incompetent they appear to be. The contrary is true for the bots in bot-lobby though, they are quite smart and capable... Well, depending on the models you choose of course.
AI written wall of text below:
Install
pi install npm:@a-t-h-i/bot-lobby
Try it first with pi -e npm:@a-t-h-i/bot-lobby, or from a checkout with pi -e ./src/index.ts.
The questionnaire and web tools are built in, so don't also install extensions with the same tool names.
Requires Pi 1.3.x (1.3.0 or later).
Use
- In Pi, run
/bot-lobby add a login page. The lobby opens in your browser.Ctrl+Shift+Mor/bot-lobby on|offswitches bot-lobby on or off; a new Pi session starts with it off. - Answer the oracle's questions and approve its plan, or agree on one with the panel in Plan first.
- Follow the agents in Lobby and Tasks. Their steps fold into one line in the conversation and open in place.
Small changes go to Quick fix. --task forces a full task, --fast / --full picks the workflow,
and --branch / --worktree isolates it in git. Workers never commit: the oracle commits only the
files the task changed, after the project's linter and a QA pass sized to the change's risk.
The lobby
- Lobby: the conversation with the oracle, each run of agent steps inline, and Thinking for their reasoning.
- Plan: plan with a panel of agents. View plan (
V) opens the draft in a slide-out, where any line takes a comment. - Tasks: every task across sessions as a list or a board, with its steps, timings and Resume.
- Git: use the Pull requests / Issues switch to review pull requests or browse open issues
through
gh. Issues retain descriptions, existing comments, File issue and Plan it; pull-request reviews remain read-only and post nothing. - Knowledge: what each agent has learned about the project, which you can edit, annotate or ask about.
The rail on the left holds settings, the key list, the theme and sounds. The project switcher
(P) opens any folder on the machine running bot-lobby. Background sessions still run tasks;
follow their progress and use Resume in Tasks, without a separate Sessions conversation page.
Git opens pull requests at #/git and #/git/<number>, and issues at #/git/issues and
#/git/issues/<number>. Old #/issues bookmarks redirect to Git. Former Sessions and Excalidraw
addresses fall back to Lobby; Excalidraw integration is removed without deleting saved room links
or external boards.
The composer appears only on Lobby, Tasks, Plan, Quick fix and Knowledge, including supported detail routes and Knowledge's Docs/Chat views. On Git, Metrics and Settings it stays mounted but hidden and inert, preserving drafts and attachments (including uploads that finish while hidden) without taking space.
| Agent | Does |
|---|---|
| Oracle | Your Pi session: questions, plan, delegation and approvals |
| DESIGN | UI, frontend logic, styling and accessibility |
| DEV | Backend, APIs, data, security and integrations |
| QA | The final quality gate, at the depth the change's risk calls for |
| RESEARCH | External facts, with sources |
Keys
Every action button shows its key. Alt+1…Alt+9 switch tabs, j / k move through lists, /
focuses search or the message box, p switches project, d flips the theme and ? lists every key.
Configuration
Settings live in ~/.pi/bot-lobby/config.json (BOT_LOBBY_CONFIG_DIR moves them), and
/bot-lobby config shows what is in effect. Most are also in the lobby's Settings. Tasks and
project knowledge stay in .pi/bot-lobby/ inside your project.
The guide covers the rest: delivery and commits, crash recovery, knowledge and shared scripts, the classifier, delegation, time limits, compaction and MCP tools.