@a-t-h-i/bot-lobby

中文文档
0.7.9发布于 2026/11/04Apache-2.0ES Module零依赖近 30 天下载 1.1万

Structured multi-agent software engineering orchestrator for Pi

原始使用文档
文档目录11 节
  1. Install
  2. What it does
  3. Chat with the whole team
  4. Watch agents think and work
  5. Plan in rounds
  6. Follow every task
  7. Read the changes, run commands
  8. Tune each agent
  9. The agents
  10. Keys
  11. Configuration

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.

An agent asks a question with two clickable UI mockups; the user expands one, picks an option, answers the next question, and a toast confirms it was sent

Agents ask with real mockups. Expand one, pick it, move on.

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. Needs Pi 1.4.x (1.4.0 or later). The questionnaire and web tools are built in, so don't also install extensions with the same tool names.

Then run /bot-lobby in Pi to open the lobby. Ctrl+Shift+M or /bot-lobby on|off turns it on or off; a new Pi session starts with it off.

What it does

Chat with the whole team

Type / for commands: /plan to plan an idea with the panel, /task to hand it straight to the team, plus Pi commands, your /skill:name skills and prompt templates.

Typing / opens a list of commands; the user picks /plan and types an idea

Start a message with @ to choose who answers. Otherwise a classifier hands each message to the agent whose area it is, and every reply carries its agent's name.

Typing @ opens the agent list; the user picks Design, sends a request, and Design replies

Watch agents think and work

Each run of agent steps folds into one line in the chat. Open it to see every step, or open Thinking to read what each agent is reasoning about, live.

Expanding the Worked line shows each agent's steps; expanding Thinking shows live reasoning cards per agent

Plan in rounds

On Plan, a panel of agents asks what it needs to know, round by round. View plan (V) opens the draft, and any line takes a comment that goes into the next round.

The Plan tab shows the panel's questions; the draft plan slides out and the user comments on one line

Follow every task

Tasks lists every task across sessions with its steps, timings, approvals and blockers. Resume carries a stopped task on in the background, and a toast tells you it happened.

The Tasks tab: opening a running task with its steps and sub-agents, then resuming a stopped task and a toast rising from the composer

Read the changes, run commands

The code viewer shows what the agents changed, as a diff or side by side, and opens any file.

The code viewer lists a changed file, shows its diff, switches to side by side, then to the full file

The terminal drawer is a real shell in your project, one click away.

The terminal drawer opens under the chat and runs git commands

Tune each agent

Pick each agent's model and effort, run agents on other coding tools (Codex CLI, Claude Code and more), narrow their MCP tools and skills, and set the workflow and lint gate. Changes save as you make them.

Settings: changing an agent's effort and model, toggling auto-compact with a Settings saved toast, then the Harnesses, Tools and skills, and Workflow tabs

The agents

AgentDoes
OrchestratorYour Pi session: questions, plan, delegation and approvals
DesignUI, frontend logic, styling and accessibility
DevBackend, APIs, data, security and integrations
QAThe final quality gate, as deep as the change's risk calls for
ResearchOutside facts, with sources
ScoutReads the code and explains how something works

/bot-lobby <request> in Pi also starts a task. --fast / --full picks the workflow, and --branch / --worktree isolates it in git. Workers never commit: the orchestrator commits only the files the task changed, after the project's linter and a QA pass sized to the change's risk.

Knowledge holds what each agent has learned about your project, which you can edit, annotate or ask about. The project switcher (P) opens any folder on the machine running bot-lobby.

Keys

Every 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, compaction, and MCP tools and skills.

版本与发布记录

@a-t-h-i/bot-lobby 共发布 97 个版本,首次发布于 2026/09/25;过去 12 个月发布了 97 个版本。

版本发布日期距今
0.7.9latest2026/11/042 天前
0.7.82026/11/032 天前
0.7.72026/11/032 天前
0.7.62026/11/032 天前
0.7.52026/11/032 天前
0.7.42026/11/032 天前

关于 @a-t-h-i/bot-lobby 的常见问题

@a-t-h-i/bot-lobby 是什么?

Structured multi-agent software engineering orchestrator for Pi

如何安装 @a-t-h-i/bot-lobby?

在项目目录运行 npm install @a-t-h-i/bot-lobby,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(*)、@earendil-works/pi-ai(>=1.4.0 <1.5.0)、@earendil-works/pi-tui(>=1.4.0 <1.5.0)、@earendil-works/pi-coding-agent(>=1.4.0 <1.5.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@a-t-h-i/bot-lobby 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/a-t-h-i__bot-lobby 是否存在。

@a-t-h-i/bot-lobby 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@a-t-h-i/bot-lobby 可以商用吗?

@a-t-h-i/bot-lobby 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@a-t-h-i/bot-lobby 的下载量有多少?

根据 npm 官方下载统计,@a-t-h-i/bot-lobby 在 2026/10/05 – 2026/11/03 这 30 天内被下载 11,002 次,日均约 367 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@a-t-h-i/bot-lobby 还在维护吗?

最新版本 0.7.9 发布于 2026/11/04(2 天前);至今共发布 97 个版本,其中过去 12 个月发布了 97 个;首次发布于 2026/09/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。