@jossuealcala/madre 0.7.1 → 1.0.0

package/README.md

@@ -16,23 +16,24 @@ MU/TH/UR 6000 · INTERFACE 2037 · MADRE IS READY
 
 <br>
 
-# Los agentes que ya tienes.<br>Una sala. Una memoria.
+# Todas tus IAs en un mismo chat.
 
-Codex, Claude Code, Gemini CLI y OpenCode trabajando sobre el mismo proyecto,
-en la misma conversación, recordando lo mismo.
+Codex, Claude Code, Gemini CLI y OpenCode trabajando sobre tus proyectos,
+en la misma conversación, recordando lo mismo. Todos tus proyectos en un lugar,
+y un Coordinador que los ve desde arriba.
 
 ```
-npx @jossuealcala/madre start
+npx @jossuealcala/madre
 ```
 
 Eso es todo. No hay cuenta que crear, ni nube que configurar, ni llave que pegar.
 MADRE usa las sesiones que esas CLIs ya tienen en tu máquina.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/room.png" alt="La sala de MADRE: Codex y Claude respondiendo en el mismo hilo sobre el mismo proyecto" width="100%">
+  <a href="https://github.com/jossuealcacao-exe/madre/blob/main/docs/media/1.0/madre-1-0.mp4"><img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/madre-1-0-video.webp" alt="Ver MADRE 1.0 en 90 segundos" width="100%"></a>
 </p>
 
-<p align="center"><sub>Una pregunta. Dos agentes. El segundo leyó al primero.</sub></p>
+<p align="center"><sub>MADRE 1.0 en 90 segundos: pantallas reales sobre proyectos de ejemplo. También en <a href="https://madre.run">madre.run</a>.</sub></p>
 
 <br>
 
@@ -40,36 +41,93 @@ MADRE usa las sesiones que esas CLIs ya tienen en tu máquina.
 
 <br>
 
+## Lo nuevo en 1.0
+
+- **Inicio**: todos tus proyectos en un lugar, abiertos o dormidos, con lo que pasó en cada uno.
+- **El Coordinador**: un agente que lee entre tus proyectos, firma conexiones y lleva órdenes de uno a otro.
+- **Conexiones**: un proyecto consulta lo que otro ya aprendió, solo si tú lo firmas.
+- **Permisos a tu manera**: de `#0` Incógnito a `#4` Acceso total, con la llave que tú eliges.
+- **Ajustes y Diagnóstico**: todo lo que configuras en una ventana, y el remedio cuando algo falla.
+- **Módulos como apps**, varias conversaciones a la vez y un editor de código en el visor.
+
+Si vienes de 0.7.2, tus proyectos, conversaciones, memoria y ajustes se quedan. El detalle, en el [CHANGELOG](CHANGELOG.md).
+
+<br>
+
 ## Una conversación, no cuatro terminales
 
-Escribes `@codex` y contesta Codex. Escribes `@claude` y contesta Claude, **leyendo lo que Codex acaba de decir**. Pides una mesa redonda y cada uno opina por turno sobre lo mismo.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-agentes.webp" alt="Todas tus IAs en un mismo chat: Claude contesta después de Codex, con la línea de traspaso que dice cuántos mensajes recibió" width="100%">
+</p>
+
+Escribes `@codex` y contesta Codex. Escribes `@claude` y contesta Claude, **leyendo lo que Codex acaba de decir**. Escribes «@madre, pregúntale al equipo…» y cada uno opina por turno sobre lo mismo; al final, @madre resume en qué coinciden y en qué no, citando cada respuesta.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/mesa-redonda.gif" alt="Una mesa redonda en MADRE 1.0: la pregunta, el plan de @madre y las respuestas de cada agente" width="100%">
+</p>
 
 Hoy eso son cuatro ventanas, cuatro contextos y tú copiando y pegando entre ellas. MADRE lo vuelve un hilo.
 
+## Todos tus proyectos, en un lugar
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-inicio.webp" alt="Inicio de MADRE 1.0: el Coordinador con su resumen reciente, quién te espera, las conexiones y una tarjeta por proyecto" width="100%">
+</p>
+
+`madre` abre **Inicio**. La primera vez te acompaña en tres pasos: conectar tus agentes (una vez para todos tus proyectos), agregar tus carpetas y abrir las que vas a usar. Cada tarjeta dice si un agente trabaja, si alguien te espera y qué se decidió mientras no estabas.
+
+## Un Coordinador que ve todos tus proyectos
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-coordinador.webp" alt="El Coordinador responde qué se decidió en dos proyectos conectados, diciendo de cuál sacó cada dato" width="100%">
+</p>
+
+El **Coordinador** vive en Inicio. Lee lo que tus proyectos aprendieron —solo de los que conectas tú— y te contesta diciendo de qué proyecto sacó cada dato. Si lo permites, lleva tareas de un proyecto a otro, hasta `#2`; lo que pide más permiso llega como propuesta que tú desbloqueas. Desde cualquier proyecto le preguntas con `/bishop`.
+
+Una **conexión** dice qué tipos de nota cruzan (decisiones, hechos, preferencias, preguntas) y hasta cuándo. Nunca tus archivos ni tus conversaciones, y se revoca cuando quieras.
+
 ## Una memoria que sobrevive a la sesión
 
-Todo lo que se dice queda indexado. Cuando la conversación pasa de la ventana de contexto, cada agente recibe de vuelta lo que hace falta, citado. Cada diez intercambios, la sala destila lo dicho en notas con tipo: una decisión, un hecho, una preferencia, una pregunta abierta.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-memoria.webp" alt="El Mapa de memoria: memorias de colores alrededor de un núcleo de magma, unidas por sus enlaces" width="100%">
+</p>
 
-Preguntas *«¿por qué elegimos Postgres?»* tres semanas después y la sala contesta, aunque esa decisión la tomara otro agente en otra sesión.
+Todo lo que se dice queda indexado. Cuando la conversación pasa de la ventana de contexto, cada agente recibe de vuelta lo que hace falta, citado. Cada diez intercambios, el proyecto destila lo dicho en notas con tipo: una decisión, un hecho, una preferencia, una pregunta abierta.
 
-Con [Ollama](https://ollama.com) corriendo, esa memoria además **habla**: `@madre` es un quinto agente, local, gratis, que responde desde todo el archivo con citas y no escribe nada.
+Preguntas *«¿por qué elegimos Postgres?»* tres semanas después y el proyecto contesta, aunque esa decisión la tomara otro agente en otra sesión.
 
-Y la puedes **ver**. En NOSTROMO el archivo es un cerebro en tres dimensiones que giras con el ratón: cada memoria es una estrella cuyo brillo dice cuánto la usa la sala y cuya superficie cuenta si la confirmaste, si nadie la ha revisado o si se está enfriando. En MEMORIA, un tablero te dice qué tan bien está contestando el archivo y qué conviene hacer después.
+Con [Ollama](https://ollama.com) corriendo, esa memoria además **habla**: `@madre` es un quinto agente, local, gratis, que responde desde todo el archivo con citas y no escribe nada. Y la puedes **ver**: el **Mapa de memoria** es un cerebro en tres dimensiones que giras con el ratón, donde cada memoria es una estrella del color de su tipo.
 
 ## Leen por defecto. Escriben cuando tú lo dices.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-permisos.webp" alt="El menú de modos de MADRE 1.0, de #0 Incógnito a #4 Acceso total" width="100%">
+</p>
+
 Cada mensaje sale con un modo de permiso, y tu modo es el techo de todo lo que ese mensaje arranque.
 
 | | | |
 |---|---|---|
-| `#1` | **EXCHANGE** | Leer y coordinar. El predeterminado. |
-| `#2` | **CREATE** | Añadir archivos nuevos. Lo que ya existía se restaura al terminar. |
-| `#3` | **CONTROL** | Editar el proyecto. Checkpoint antes, lista de cambios y `UNDO` después. |
-| `#4` | **AIRLOCK** | Comandos, `git push`, deploys. Pide dos llaves. |
+| `#1` | **SOLO CONVERSAR** | Leer y coordinar. El predeterminado. |
+| `#2` | **CREAR** | Añadir archivos nuevos. Lo que ya existía se restaura al terminar. |
+| `#3` | **EDITAR** | Editar el proyecto. Punto de restauración antes, lista de cambios y `DESHACER` después. |
+| `#4` | **ACCESO TOTAL** | Comandos, `git push`, deploys. Pide la llave dos veces. |
+
+También hay `#0 INCÓGNITO`, para lo que no debe quedar en ninguna parte.
+
+Subir a `#3` o `#4` es deliberado: MADRE te pide tu llave —por defecto, el nombre de la carpeta del proyecto; en Ajustes › Permisos puedes elegir una frase tuya— y la comprueba el propio proyecto. Ningún agente puede concederse un permiso escribiéndolo en su respuesta.
 
-También hay `#0 GHOST`, para lo que no debe quedar en ninguna parte.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-deshacer.webp" alt="Claude cambió tres archivos en #3 Editar y el botón Deshacer regresa el proyecto al punto de restauración" width="100%">
+</p>
 
-Subir a `#3` o `#4` es una ceremonia deliberada: MADRE te pide el nombre de la carpeta del proyecto, escrito por ti. Ningún agente puede concederse un permiso escribiéndolo en su respuesta.
+## Tu espacio, a tu medida
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jossuealcacao-exe/madre/main/docs/media/1.0/ksp-espacio.webp" alt="La conversación a la izquierda y el editor de código al lado, en modo Editar" width="100%">
+</p>
+
+Cada panel se abre al lado o en una ventana que mueves. Varias conversaciones trabajan a la vez, el visor edita código, los servidores de tu proyecto se abren dentro de MADRE y la barra se arma con clic derecho. **Ajustes** (⌘ ,) reúne todo lo que configuras, con buscador, y **Diagnóstico** te da el remedio cuando algo falla.
 
 <br>
 
@@ -79,9 +137,9 @@ Subir a `#3` o `#4` es una ceremonia deliberada: MADRE te pide el nombre de la c
 
 ## Hazla tuya
 
-MADRE trae ocho módulos. El noveno lo escribes tú — o se lo pides a un agente.
+MADRE trae doce módulos —Ahorro de tokens, Intenciones, IA local, GitHub, Continuidad y más—, en un tablero como de apps. El siguiente lo escribes tú, o se lo pides a un agente.
 
-**Un módulo es un archivo.** Sin build, sin dependencias, sin registrarse en ningún lado. Lo copias a una carpeta, pulsas RELOAD y aparece con su interruptor, sus ajustes y su ficha. Con uno puedes añadir un comando `/loquesea` que la sala entiende, darle a los agentes una herramienta que antes no tenían, cambiar cómo se comporta la sala, o conectarla con algo que ya usas.
+**Un módulo es un archivo.** Sin build, sin dependencias, sin registrarse en ningún lado. Lo copias a una carpeta, recargas y aparece con su interruptor, sus ajustes y su ficha. Con uno puedes añadir un comando `/loquesea` que el proyecto entiende, darle a los agentes una herramienta que antes no tenían, cambiar cómo se comporta MADRE, o conectarla con algo que ya usas.
 
 **O no lo escribes tú.** En la caja de texto:
 
@@ -93,9 +151,9 @@ El agente lee el SDK, escribe el archivo, y MADRE te enseña una tarjeta para re
 
 **Conectarla con un servicio de fuera** es lo que más se pide, y la respuesta corta es *casi siempre sí*: el límite no es MADRE, es cómo ese servicio deja que entregues tu propia llave. Vale la pena cuando la consigues en menos de cinco minutos sin ser desarrollador y la puedes revocar sola — GitHub, Linear, Notion, Jira, Slack, Telegram, Stripe, Shopify, Odoo, cualquier base de datos. Donde hay muro es donde el proveedor exige revisar tu app antes de dejarte pasar: Gmail en lectura, Meta, banca.
 
-Tu módulo declara qué llave necesita y MADRE dibuja el campo; declara a dónde llega y el registro de salidas responde por él; declara qué herramientas suyas **mandan** algo, y la sala se las retira a los agentes salvo en el peldaño `#4`. Nada de eso lo programas: lo declaras.
+Tu módulo declara qué llave necesita y MADRE dibuja el campo; declara a dónde llega y el registro de salidas responde por él; declara qué herramientas suyas **mandan** algo, y el proyecto se las retira a los agentes salvo en el peldaño `#4`. Nada de eso lo programas: lo declaras.
 
-**[Escribir un módulo →](docs/SDK.md)** · con dos ejemplos completos que funcionan tal cual: [el mínimo](docs/sdk/hello-module.mjs) y [un conector](docs/sdk/connector-module.mjs).
+**[Escribir un módulo →](docs/SDK.md)** · con dos ejemplos completos que funcionan tal cual: [el mínimo](docs/sdk/hello-module.mjs) y [una integración](docs/sdk/connector-module.mjs).
 
 <br>
 
@@ -109,11 +167,11 @@ Esto importa más que cualquier función.
 
 **No hay nube.** MADRE no tiene servidor, ni cuenta, ni backend. Corre en `127.0.0.1` y se muere cuando cierras la terminal.
 
-**Tus llaves, donde hacen falta y en ningún otro lado.** Cuando das la llave de un agente, MADRE la escribe en el archivo donde ese CLI la busca, cerrada a tu usuario, y no conserva copia. Un conector no tiene CLI al que dársela, así que esa —y solo esa— la guarda MADRE, en su propia bodega de tu máquina, con permisos de solo tu usuario, aceptada únicamente desde esta computadora. Nunca en su config, ni en su registro, ni en sus logs, ni en lo que lee un agente: la ficha solo muestra que hay una guardada y cuántos caracteres tiene.
+**Tus llaves, donde hacen falta y en ningún otro lado.** Cuando das la llave de un agente, MADRE la escribe en el archivo donde ese CLI la busca, cerrada a tu usuario, y no conserva copia. Una integración no tiene CLI al que dársela, así que esa —y solo esa— la guarda MADRE, en su propia bodega de tu máquina, con permisos de solo tu usuario, aceptada únicamente desde esta computadora. Nunca en su config, ni en su registro, ni en sus logs, ni en lo que lee un agente: la ficha solo muestra que hay una guardada y cuántos caracteres tiene.
 
-**Nada sale por su cuenta.** Lo que un agente lee viaja a *su* proveedor, con tu cuenta y tus límites — como si lo hubieras corrido en tu terminal, porque eso es exactamente lo que MADRE hace. Los dos únicos envíos propios están bajo tu interruptor: una consulta diaria a npm por si hay versión nueva, y los reportes de fallos, apagados por defecto.
+**Nada sale por su cuenta.** Lo que un agente lee viaja a *su* proveedor, con tu cuenta y tus límites — como si lo hubieras corrido en tu terminal, porque eso es exactamente lo que MADRE hace. Lo que MADRE consulta por su cuenta está declarado, con lo que lo apaga: la consulta diaria de versiones nuevas (npm y GitHub), la cuota de tu plan de Claude, los embeddings e imágenes de Gemini si los activas, y los reportes de fallos, apagados por defecto.
 
-**Y te deja leerlo.** Dentro de la sala puedes abrir el documento exacto que MADRE escribe en tu nombre cada turno, el comando exacto con el que lo entrega, y el registro de cada llamada que salió de esta máquina. No es una promesa: es una pantalla.
+**Y te deja leerlo.** Toca el núcleo del Mapa de memoria y se abre «Lo que se envía»: el documento exacto que MADRE escribe en tu nombre cada turno, el comando exacto con el que lo entrega, y el registro de cada llamada que salió de esta máquina. No es una promesa: es una pantalla.
 
 **Cero dependencias.** Node y nada más.
 
@@ -127,18 +185,24 @@ Esto importa más que cualquier función.
 
 Necesitas **Node 22.5** o superior y al menos una de estas CLIs con sesión iniciada: Codex, Claude Code, Gemini CLI u OpenCode.
 
+```
+npx @jossuealcala/madre
+```
+
+Desde cualquier carpeta, abre **Inicio** en `http://127.0.0.1:4317/salas`: todos tus proyectos en un lugar, con el Coordinador arriba. La primera vez te acompaña en tres pasos: **conectar tus agentes** (instalar y firmar cada CLI ahí mismo, una vez para todos tus proyectos), **agregar tus proyectos** (eliges las carpetas; agregarlas no las abre) y **abrir** los que vas a usar. Cada proyecto corre por su cuenta, con su propia memoria.
+
+Si prefieres entrar directo a un proyecto, como antes:
+
 ```
 cd tu-proyecto
 npx @jossuealcala/madre start
 ```
 
-La sala abre en `http://127.0.0.1:4317`. **Si no tienes ninguna CLI, ábrela igual**: lo primero que ves es el puente, con un botón para instalar y firmar cada agente ahí mismo. MADRE enseña el comando antes de correrlo y transmite cada línea a la pantalla.
-
 ```
 npx @jossuealcala/madre doctor    # qué hay instalado, quién tiene sesión
 ```
 
-La sala habla **español**. El botón `EN` la pasa a inglés.
+MADRE habla **español**. En Ajustes › Apariencia la pasas a inglés.
 
 <br>
 
@@ -157,7 +221,7 @@ Beta pública. El núcleo está probado y bajo CI en macOS y Linux con Node 22 y
 
 Una versión se cierra cuando está en npm. El detalle de cada una en [CHANGELOG.md](CHANGELOG.md); lo que viene, en el [roadmap](https://github.com/jossuealcacao-exe/madre/blob/main/docs/ROADMAP.md).
 
-Problemas: desde MU/TH/UR (`✎ FEEDBACK`) o en [issues](https://github.com/jossuealcacao-exe/madre/issues).
+Problemas: desde cada remedio de Diagnóstico («¿No se arregló?») o en [issues](https://github.com/jossuealcacao-exe/madre/issues).
 Seguridad: [SECURITY.md](SECURITY.md) · Contribuir: [CONTRIBUTING.md](CONTRIBUTING.md)
 
 MADRE es gratis y seguirá siéndolo. Si te ahorra tiempo y quieres que siga creciendo,

package/SECURITY.md

@@ -15,6 +15,7 @@ Please include the MADRE version (`madre doctor --json`), the platform, which ag
 
 - In `#3 CONTROL`, `.env` files, `.pulse/`, `.madre/` and `.claude/settings.local.json` are made read-only for the length of the turn and restored from the checkpoint afterwards; `.git/` stays writable because the CLIs need it and is only restored after the turn. An agent that changes permissions on purpose is caught by that restoration, not prevented.
 - `#4 AIRLOCK` runs commands with the CLIs and sessions already on the machine: tests, builds, `git push`, deploys. Files come back with `UNDO`; **what leaves the machine does not**. Arming it asks for two keys — the project designation and the word `AIRLOCK` — and the agent's `MAX MODE` in CONNECTIONS must already reach it, which is a separate deliberate act. No agent can raise its own ceiling, and a permission an agent writes into its own answer is not a permission. Treat `#4` as handing that agent your shell.
+- **Runs** (a module, off until you switch it on) lets an agent below `#4` ask you to run a command. Nothing runs until you press its button, and the server runs the line it recorded the agent asking for, never one sent by the page. Each line runs alone from the project root with no shell, so the line you read is the argv that runs; lines that would need a shell (`|`, `&&`, redirections, variables, globs) are shown and refused. A checkpoint is taken first and `UNDO` restores files; what the command sends off the machine does not come back. Read a command before you press it as you would before pasting it into a terminal.
 - Everything said outside `#0 GHOST` is kept in the room's memory and reaches every agent of that room. Use GHOST for what must not be remembered.
 
 NOBODY DELETES MOTHER'S MEMORY. EVERYTHING ELSE IS FAIR GAME.

package/bin/madre.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
-import { resolve } from 'node:path';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
 import { execFileSync } from 'node:child_process';
 import { readFile, stat } from 'node:fs/promises';
 import { openUrl, startPulse } from '../src/server.mjs';
@@ -10,6 +11,7 @@ import { probeAll } from '../src/auth-probe.mjs';
 import { applyConfigToEnv, loadConfig } from '../src/config.mjs';
 import { isOnline, runSetup } from '../src/setup.mjs';
 import { parseArgs } from '../src/cli-args.mjs';
+import { ensureSalasProject, isSalasRoom, projectRootFor } from '../src/salas.mjs';
 import { createServer } from 'node:net';
 
 const cli = parseArgs(process.argv.slice(2));
@@ -77,7 +79,15 @@ async function openRoom(options) {
   process.exit(2);
 }
 
-const projectRoot = resolve(option('--project', process.cwd()));
+const stateRoot = process.env.PULSE_HOME;
+// Which project this run is about (src/salas.mjs, docs/MACROVERSO.md D-S09): the one named with
+// --project; the room of Salas for `madre salas`, and for a bare `madre` from the home folder;
+// anywhere else, the folder MADRE was run from. The notebook of Salas lives under MADRE's own
+// state, `~/.pulse/salas` unless PULSE_HOME says where that state is.
+const salasHome = stateRoot ?? join(homedir(), '.pulse');
+const projectRoot = projectRootFor({ command, named: cli.named, project: option('--project', null), cwd: process.cwd(), home: homedir(), stateRoot: salasHome });
+// The lobby opens on its list of projects; a project's room on its conversation.
+const openPath = isSalasRoom(projectRoot, salasHome) ? '/salas' : '';
 const [nodeMajor, nodeMinor] = process.versions.node.split('.').map(Number);
 if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 5)) {
   console.error(`\n  MOTHER › MADRE needs Node 22.5 or newer (found ${process.version}): the room's memory runs on node:sqlite.\n`);
@@ -91,8 +101,10 @@ if (has('--version') || has('-v') || command === 'version') {
   console.log(`madre ${pkg.version}${commit ? ` · ${commit}` : ''} · node ${process.version}`);
   process.exit(0);
 }
-const stateRoot = process.env.PULSE_HOME;
 if (command !== 'help') {
+  // The notebook of Salas is MADRE's own folder: made here, empty, the first time it is opened
+  // (D-S08). If it cannot be made, the check below says so, as for any folder that is not there.
+  if (isSalasRoom(projectRoot, salasHome)) await ensureSalasProject(salasHome).catch((error) => console.error(`  MOTHER › could not make the folder of Salas at ${projectRoot}: ${error.message}`));
   const stats = await stat(projectRoot).catch(() => null);
   if (!stats?.isDirectory()) {
     console.error(`\n  MOTHER › project folder not found: ${projectRoot}\n  Pass an existing directory with --project, or run MADRE from inside the project.\n`);
@@ -107,7 +119,7 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
   const query = option('--catalog', '') || option('--conditions', '') || '';
   const platform = PLATFORMS[process.platform] ? process.platform : 'linux';
   const list = query && !query.startsWith('--') ? searchConditions(query) : CONDITIONS;
-  console.log(`\nMU/TH/UR · KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[platform].label.toUpperCase()} / ${PLATFORMS[platform].shell.toUpperCase()}\n`);
+  console.log(`\nDIAGNOSTICS · KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[platform].label.toUpperCase()} / ${PLATFORMS[platform].shell.toUpperCase()}\n`);
   for (const condition of list) {
     console.log(`▌ ${condition.title}`);
     console.log(`  ${condition.id} · ${condition.severity}${condition.agent ? ` · @${condition.agent}` : ''}`);
@@ -178,11 +190,13 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
 } else if (command === 'setup') {
   const { action, online } = await runSetup({ projectRoot, stateRoot });
   if (action === 'start') {
-    await openRoom({ port: Number(option('--port', '4317')), projectRoot, openBrowser: !has('--no-open') });
+    await openRoom({ port: Number(option('--port', '4317')), projectRoot, openBrowser: !has('--no-open'), openPath });
   } else {
     process.exitCode = action === 'report' && !online ? 1 : 0;
   }
-} else if (command === 'start') {
+} else if (command === 'start' || command === 'salas' || command === 'lobby') {
+  // `madre salas` is `madre start` on the notebook of Salas (projectRoot, above): the same look
+  // for a room already open, the same walk up the ports, the same browser unless --no-open.
   const port = Number(option('--port', '4317'));
   const noOpen = has('--no-open');
   // First contact happens in the room, not here: MADRE opens even with nobody online and the
@@ -195,20 +209,26 @@ if (command === 'doctor' && (has('--catalog') || has('--conditions'))) {
   // A room for this project may already be open. Show that one instead of starting a second.
   const running = await roomAlreadyOpen(port, projectRoot);
   if (running) {
-    console.log(`\nMADRE is already open for this project\n\n  ${running.url}\n  Project: ${projectRoot}\n  Close that room first if you want a fresh one.\n`);
-    if (!noOpen) openUrl(running.url);
+    console.log(`\nMADRE is already open for this project\n\n  ${running.url}${openPath}\n  Project: ${projectRoot}\n  Close that room first if you want a fresh one.\n`);
+    if (!noOpen) openUrl(`${running.url}${openPath}`);
     process.exit(0);
   }
-  await openRoom({ port, projectRoot, openBrowser: !noOpen });
+  await openRoom({ port, projectRoot, openBrowser: !noOpen, openPath });
 } else if (command === 'help') {
   console.log(`MADRE
 
+  madre       [--port 4317] [--no-open]
+              Opens Home: every project on this computer, in one place.
   madre start [--project PATH] [--port 4317] [--no-open] [--setup]
+              Opens the project in this folder (or PATH) directly.
               Without --port, a busy 4317 falls through to the next free port.
+  madre lobby [--port 4317] [--no-open]   (also: madre salas; opens Home)
   madre setup [--project PATH] [--port 4317] [--no-open]
   madre doctor [--project PATH] [--json]
 
-  start   Opens the project room. With nobody online, runs setup first.
+  (none)  Opens Home. From there you add projects, connect the agents
+          and enter any project. The Coordinator lives there.
+  start   Opens the project in this folder. From your home folder, Home.
   setup   Detects the agents on this computer, shows who has a session,
           and runs each agent's own sign-in from here.
   doctor  Prints the same diagnosis without the wizard.