@a-t-h-i/bot-lobby 0.7.8 → 0.7.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -48
- package/package.json +2 -2
- package/webui/dist/build.json +1 -1
package/README.md
CHANGED
|
@@ -3,6 +3,10 @@ Bot-lobby is a determenistic agentic coding engine. You can come up with a vague
|
|
|
3
3
|
|
|
4
4
|
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.
|
|
5
5
|
|
|
6
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/questionnaire-hero.gif" alt="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" width="100%">
|
|
7
|
+
|
|
8
|
+
<sub>Agents ask with real mockups. Expand one, pick it, move on.</sub>
|
|
9
|
+
|
|
6
10
|
AI written wall of text below:
|
|
7
11
|
## Install
|
|
8
12
|
|
|
@@ -11,66 +15,87 @@ pi install npm:@a-t-h-i/bot-lobby
|
|
|
11
15
|
```
|
|
12
16
|
|
|
13
17
|
Try it first with `pi -e npm:@a-t-h-i/bot-lobby`, or from a checkout with `pi -e ./src/index.ts`.
|
|
14
|
-
The questionnaire and web tools are built in, so don't also
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
## Use
|
|
18
|
-
|
|
19
|
-
1. In Pi, run `/bot-lobby` to open the lobby in your browser. `Ctrl+Shift+M` or `/bot-lobby on|off`
|
|
20
|
-
switches bot-lobby on or off; a new Pi session starts with it off.
|
|
21
|
-
2. Chat with the team in **Lobby**. Questions, code changes and small fixes happen right there: the
|
|
22
|
-
classifier hands each message to the agent whose area it is (a styling question to DESIGN, a
|
|
23
|
-
library question to RESEARCH, "where is this?" to a scout), and every reply is labelled with who
|
|
24
|
-
wrote it. Start a message with `@design`, `@dev`, `@qa`, `@research`, `@scout` or `@master` to pick
|
|
25
|
-
who answers yourself.
|
|
26
|
-
3. Type `/plan <idea>` to plan it with the panel in **Plan**, or `/task <request>` to start it as a
|
|
27
|
-
task for the team. Follow the agents in **Lobby** and **Tasks**; their steps fold into one line in
|
|
28
|
-
the conversation and open in place.
|
|
29
|
-
4. Type `/` to browse Pi commands, installed `/skill:name` skills, extension commands and prompt
|
|
30
|
-
templates. `/compact [instructions]` compacts this session directly (stop active work first).
|
|
31
|
-
Other native Pi commands are prepared in Pi’s terminal: press Enter there to run them. The
|
|
32
|
-
handoff preserves terminal drafts; sessions without a terminal show an explicit notice instead.
|
|
18
|
+
Needs **Pi 1.4.x** (1.4.0 or later). The questionnaire and web tools are built in, so don't also
|
|
19
|
+
install extensions with the same tool names.
|
|
33
20
|
|
|
34
|
-
`/bot-lobby
|
|
35
|
-
|
|
36
|
-
|
|
21
|
+
Then run `/bot-lobby` in Pi to open the lobby. `Ctrl+Shift+M` or `/bot-lobby on|off` turns it on or
|
|
22
|
+
off; a new Pi session starts with it off.
|
|
23
|
+
|
|
24
|
+
## What it does
|
|
25
|
+
|
|
26
|
+
### Chat with the whole team
|
|
27
|
+
|
|
28
|
+
Type `/` for commands: `/plan` to plan an idea with the panel, `/task` to hand it straight to the
|
|
29
|
+
team, plus Pi commands, your `/skill:name` skills and prompt templates.
|
|
30
|
+
|
|
31
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/slash-commands-light.gif" alt="Typing / opens a list of commands; the user picks /plan and types an idea" width="100%">
|
|
32
|
+
|
|
33
|
+
Start a message with `@` to choose who answers. Otherwise a classifier hands each message to the
|
|
34
|
+
agent whose area it is, and every reply carries its agent's name.
|
|
35
|
+
|
|
36
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/mentions-light.gif" alt="Typing @ opens the agent list; the user picks Design, sends a request, and Design replies" width="100%">
|
|
37
|
+
|
|
38
|
+
### Watch agents think and work
|
|
39
|
+
|
|
40
|
+
Each run of agent steps folds into one line in the chat. Open it to see every step, or open
|
|
41
|
+
**Thinking** to read what each agent is reasoning about, live.
|
|
42
|
+
|
|
43
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/thinking-light.gif" alt="Expanding the Worked line shows each agent's steps; expanding Thinking shows live reasoning cards per agent" width="100%">
|
|
44
|
+
|
|
45
|
+
### Plan in rounds
|
|
37
46
|
|
|
38
|
-
|
|
47
|
+
On **Plan**, a panel of agents asks what it needs to know, round by round. **View plan** (`V`)
|
|
48
|
+
opens the draft, and any line takes a comment that goes into the next round.
|
|
39
49
|
|
|
40
|
-
-
|
|
41
|
-
name; each run of agent steps shows inline, and **Thinking** holds their reasoning. Typing `@` or
|
|
42
|
-
`/` at the start of a message opens a list of agents or commands to pick from.
|
|
43
|
-
- **Plan**: plan with a panel of agents. **View plan** (`V`) opens the draft in a slide-out, where
|
|
44
|
-
any line takes a comment.
|
|
45
|
-
- **Tasks**: every task across sessions as a list or a board, with its steps, timings and **Resume**.
|
|
46
|
-
- **Knowledge**: what each agent has learned about the project, which you can edit, annotate or ask
|
|
47
|
-
about.
|
|
50
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/planning-light.gif" alt="The Plan tab shows the panel's questions; the draft plan slides out and the user comments on one line" width="100%">
|
|
48
51
|
|
|
49
|
-
|
|
50
|
-
(`P`) opens any folder on the machine running bot-lobby. Background sessions still run tasks;
|
|
51
|
-
follow their progress and use **Resume** in **Tasks**, without a separate Sessions conversation page.
|
|
52
|
+
### Follow every task
|
|
52
53
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
or external boards.
|
|
54
|
+
**Tasks** lists every task across sessions with its steps, timings, approvals and blockers.
|
|
55
|
+
**Resume** carries a stopped task on in the background, and a toast tells you it happened.
|
|
56
56
|
|
|
57
|
-
The
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
57
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/tasks-toast-light.gif" alt="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" width="100%">
|
|
58
|
+
|
|
59
|
+
### Read the changes, run commands
|
|
60
|
+
|
|
61
|
+
The code viewer shows what the agents changed, as a diff or side by side, and opens any file.
|
|
62
|
+
|
|
63
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/code-viewer-light.gif" alt="The code viewer lists a changed file, shows its diff, switches to side by side, then to the full file" width="100%">
|
|
64
|
+
|
|
65
|
+
The terminal drawer is a real shell in your project, one click away.
|
|
66
|
+
|
|
67
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/terminal-light.gif" alt="The terminal drawer opens under the chat and runs git commands" width="100%">
|
|
68
|
+
|
|
69
|
+
### Tune each agent
|
|
70
|
+
|
|
71
|
+
Pick each agent's model and effort, run agents on other coding tools (Codex CLI, Claude Code and
|
|
72
|
+
more), narrow their MCP tools and skills, and set the workflow and lint gate. Changes save as you
|
|
73
|
+
make them.
|
|
74
|
+
|
|
75
|
+
<img src="https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/settings-light.gif" alt="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" width="100%">
|
|
76
|
+
|
|
77
|
+
## The agents
|
|
61
78
|
|
|
62
79
|
| Agent | Does |
|
|
63
80
|
| --- | --- |
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
|
|
|
67
|
-
| QA | The final quality gate,
|
|
68
|
-
|
|
|
81
|
+
| Orchestrator | Your Pi session: questions, plan, delegation and approvals |
|
|
82
|
+
| Design | UI, frontend logic, styling and accessibility |
|
|
83
|
+
| Dev | Backend, APIs, data, security and integrations |
|
|
84
|
+
| QA | The final quality gate, as deep as the change's risk calls for |
|
|
85
|
+
| Research | Outside facts, with sources |
|
|
86
|
+
| Scout | Reads the code and explains how something works |
|
|
87
|
+
|
|
88
|
+
`/bot-lobby <request>` in Pi also starts a task. `--fast` / `--full` picks the workflow, and
|
|
89
|
+
`--branch` / `--worktree` isolates it in git. Workers never commit: the orchestrator commits only
|
|
90
|
+
the files the task changed, after the project's linter and a QA pass sized to the change's risk.
|
|
91
|
+
|
|
92
|
+
**Knowledge** holds what each agent has learned about your project, which you can edit, annotate
|
|
93
|
+
or ask about. The project switcher (`P`) opens any folder on the machine running bot-lobby.
|
|
69
94
|
|
|
70
95
|
## Keys
|
|
71
96
|
|
|
72
|
-
Every
|
|
73
|
-
|
|
97
|
+
Every button shows its key. `Alt+1`…`Alt+9` switch tabs, `j` / `k` move through lists, `/` focuses
|
|
98
|
+
search or the message box, `p` switches project, `d` flips the theme and `?` lists every key.
|
|
74
99
|
|
|
75
100
|
## Configuration
|
|
76
101
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@a-t-h-i/bot-lobby",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.9",
|
|
4
4
|
"description": "Structured multi-agent software engineering orchestrator for Pi",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
"extensions": [
|
|
38
38
|
"./src/index.ts"
|
|
39
39
|
],
|
|
40
|
-
"image": "https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main
|
|
40
|
+
"image": "https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/media/lobby.png"
|
|
41
41
|
},
|
|
42
42
|
"scripts": {
|
|
43
43
|
"typecheck": "tsc --noEmit && tsc -p webui --noEmit",
|