@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 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 install extensions with the same tool names.
15
- Requires **Pi 1.4.x** (1.4.0 or later).
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 <request>` in Pi also starts a task. `--fast` / `--full` picks the workflow, and
35
- `--branch` / `--worktree` isolates it in git. Workers never commit: the oracle commits only the
36
- files the task changed, after the project's linter and a QA pass sized to the change's risk.
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
- ## The lobby
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
- - **Lobby**: the team chat. The oracle and the agents answer here, each reply under its agent's
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
- The rail on the left holds settings, the key list, the theme and sounds. The project switcher
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
- Old `#/git` and `#/issues` bookmarks, and former Sessions and Excalidraw
54
- addresses, fall back to Lobby; Excalidraw integration is removed without deleting saved room links
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 composer appears only on **Lobby**, **Tasks**, **Plan** and **Knowledge**, including
58
- supported detail routes and Knowledge's Docs/Chat views. On Metrics and Settings it stays mounted
59
- but hidden and inert, preserving drafts and attachments (including uploads that finish while hidden)
60
- without taking space.
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
- | Oracle | Your Pi session: questions, plan, delegation and approvals |
65
- | DESIGN | UI, frontend logic, styling and accessibility |
66
- | DEV | Backend, APIs, data, security and integrations |
67
- | QA | The final quality gate, at the depth the change's risk calls for |
68
- | RESEARCH | External facts, with sources |
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 action button shows its key. `Alt+1`…`Alt+9` switch tabs, `j` / `k` move through lists, `/`
73
- focuses search or the message box, `p` switches project, `d` flips the theme and `?` lists every key.
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.8",
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/.github/screenshots/lobby.png"
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",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "hash": "4bc77983568790612f662ef1799cabbd87525ce606ee3c1770a3bf3c6a778df8",
3
- "builtAt": "2026-11-03T13:47:04.867Z",
3
+ "builtAt": "2026-11-03T16:19:18.846Z",
4
4
  "files": [
5
5
  {
6
6
  "path": "src/lobby/prompts.ts",