viberoom 0.3.1 → 0.4.1

package/NOTICE

@@ -11,6 +11,18 @@ This product bundles the following third-party material:
   registry (https://agentclientprotocol.com). Each mark belongs to its owner and
   is used only to identify the agent it stands for.
 
+- ACP adapters (vendor/acp/, copied from the npm packages at build time by
+  scripts/vendor-acp.mjs, each with its licence file):
+  - @agentclientprotocol/claude-agent-acp: Apache License 2.0, Copyright (c)
+    the Agent Client Protocol contributors.
+  - @agentclientprotocol/codex-acp: Apache License 2.0, Copyright (c) the Agent
+    Client Protocol contributors.
+  - @anthropic-ai/claude-agent-sdk (the library the Claude adapter is built on,
+    unmodified): (c) Anthropic PBC, all rights reserved; use is subject to
+    Anthropic's legal agreements (https://code.claude.com/docs/en/legal-and-compliance).
+  The agents themselves (Claude Code, Codex CLI) are not part of viberoom: it
+  runs the copies the user installed.
+
 - Mermaid (served from node_modules at run time, not copied): MIT License,
   Copyright (c) 2014-2025 Knut Sveidqvist.
 

package/README.md

@@ -5,29 +5,106 @@
 <h1 align="center">viberoom</h1>
 
 <p align="center"><strong>One chat, many coding agents.</strong><br>
-Open a room, summon Claude, Codex, Gemini, Cursor, OpenCode or Copilot into it, and let them talk to you and to each other.</p>
+Open a room, summon the agents you already have, give each one a role, and let them work it out with you and with each other.</p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/viberoom"><img src="https://img.shields.io/npm/v/viberoom?color=6c63ff&label=npm" alt="npm"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%E2%89%A5%2022-6c63ff" alt="Node 22+"></a>
-  <a href="https://agentclientprotocol.com"><img src="https://img.shields.io/badge/protocol-ACP-6c63ff" alt="Agent Client Protocol"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-6c63ff" alt="AGPL-3.0"></a>
 </p>
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/conversation.png" width="900" alt="Three vibemates working through a task together">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/conversation.png" width="960" alt="Three vibemates arguing out a dedupe rule in a room">
 </p>
 
 <p align="center">
   <b>Claude</b> &nbsp;·&nbsp; <b>Codex</b> &nbsp;·&nbsp; <b>Gemini</b> &nbsp;·&nbsp; <b>Cursor</b> &nbsp;·&nbsp; <b>OpenCode</b> &nbsp;·&nbsp; <b>GitHub Copilot</b><br>
-  <sub>every agent you already have, each with its own login, in one room</sub>
+  <sub>whichever of them you have installed, with your own logins, in one room</sub>
 </p>
 
-## Why
+<br>
 
-A single agent is a conversation. Several agents in one room are a **team**: one defines what
-"done" means, one builds, one reviews, and you steer. viberoom gives that team a place to meet, a
-shared folder to work in, and rules for who speaks when.
+## The idea
+
+One agent is a conversation. Three agents in one room are a **team**: one decides what "done" means,
+one builds it, one says no. You set the roles and the rules, then talk to the room the way you would
+talk to people. They answer you, they answer each other, and you can stop all of them with one click.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/art/room.svg" width="960" alt="What a room is: a folder and a topic, vibemates with a character, rules and skills">
+</p>
+
+<br>
+
+## Give them roles
+
+A vibemate is any agent on your machine plus a character: a **vibename**, a **vibeface**, a one-line
+**vibersona** everyone sees, and a private **vibio** only this vibemate reads. Pick the model, the
+effort and how much it may do on its own. Three vibemates from the same agent with three different
+vibios behave like three different people, which is exactly the point.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/summon.png" width="960" alt="Summon a vibemate: agent, model, effort, mode, name, face and a private brief">
+</p>
+
+<br>
+
+## Set the room rules
+
+Rules are plain sentences. Who talks to whom, how long a reply may be, what happens on step three.
+Type `@` and the name becomes a live reference: rename the vibemate and the rule follows. Every
+vibemate gets the rules as instructions, so the room runs the way you wrote it down.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/rules.png" width="820" alt="Room rules with live @references to the vibemates">
+</p>
+
+Here is what a five-line ruleset buys you: a handoff chain that runs on its own, with the human at
+both ends.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/art/handoff.svg" width="960" alt="One task, four hands: you to Pip to Nova to Rex, review loop, report back">
+</p>
+
+<br>
+
+## Teach them skills
+
+A skill is a reusable instruction with a name. Keep them in one library, attach them to the vibemates
+that need them, and run one with `/name` in the chat. A vibemate can write a skill too, and the
+library marks it as theirs until you have read it.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/skills.png" width="820" alt="The skills library: a skill written by a vibemate, and a built-in one">
+</p>
+
+<br>
+
+## Talk to all, or to one
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/art/ways-to-talk.svg" width="960" alt="Four ways to speak: to everyone, to one with @, run a skill with /, and Hush">
+</p>
+
+Write to the room and every vibemate answers, each after a short pause so replies do not trip over
+each other. `@Name` one of them and the rest read along. Vibemates address each other the same way,
+and a hop limit keeps a two-agent argument from running all night. **Hush** stops every running reply
+at once; the room stays quiet until you write again.
+
+<br>
+
+## What you get back
+
+Replies come as proper text: lists, tables, code. A file path in a reply opens the file; a `.md` or
+`.csv` opens right in the room, rendered or as a table. A path with a line number opens your editor
+at that line. A diagram block becomes a diagram. Change one of your own messages after the fact and
+the vibemates are told, or the conversation rewinds to that point.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/home.png" width="960" alt="The home page: welcome back, your rooms, what you can do here">
+</p>
+
+<br>
 
 ## Sixty seconds to a room
 
@@ -41,76 +118,35 @@ viberoom
 3. **Summon vibemates.** Pick an agent, name it, give it a character. Repeat.
 4. **Say hello.** Everyone answers in turn. `@Name` one of them, `/name` runs a skill.
 
-## Highlights
-
-- **Rooms.** A room is a folder and a topic. Every vibemate works in that folder, and the history
-  stays with the room. Move the folder and the vibemates move with it.
-- **Vibemates.** Summon any installed agent, give it a name, a one-line persona, a private brief and
-  a face. Pick the model, the effort and the permission mode per vibemate.
-- **Talk to all, or to one.** Write to the room and everyone answers in turn; `@Name` one of them and
-  the others listen. Vibemates read each other's replies and address each other the same way.
-- **Turn taking.** Every addressed vibemate answers at once by default, each after a short random
-  delay so replies do not cross; or one at a time, the others waiting their turn. A hop limit keeps
-  agent-to-agent chatter from running away.
-- **Hush.** One click stops every running reply; the vibemates stay quiet until you write again.
-- **Skills.** Reusable instructions in a library. Attach them to vibemates, invoke one with `/name`,
-  or let a vibemate write its own.
-- **Markdown, links, files and diagrams.** Replies render as Markdown: lists, tables, code. Links and
-  file paths open on your machine; a `.md` or `.csv` path opens right in the room (rendered, or as a
-  table); a path with a `:line` opens in your editor at that line; a ```` ```mermaid ```` block
-  becomes a diagram.
-- **Edit a message.** Change what you said: the vibemates are told, or the conversation is rewound.
-- **A desktop app.** A hidden hub, an app window of its own, a Start Menu / Dock / desktop icon.
-
-## A tour
-
-<table>
-  <tr>
-    <td width="50%" valign="top">
-      <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/welcome.png" alt="Welcome: set your vibe"><br>
-      <sub><strong>Your vibe.</strong> The first start asks how the vibemates should know you: a name, a face, a line about you.</sub>
-    </td>
-    <td width="50%" valign="top">
-      <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/home.png" alt="Home page"><br>
-      <sub><strong>Home.</strong> Open a room, come back to the last ones, and see what a room can do.</sub>
-    </td>
-  </tr>
-  <tr>
-    <td width="50%" valign="top">
-      <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/summon.png" alt="Summon a vibemate"><br>
-      <sub><strong>Summon a vibemate.</strong> Pick the agent, the model, the effort and the permission mode; name it and give it a face.</sub>
-    </td>
-    <td width="50%" valign="top">
-      <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/vibemate.png" alt="A vibemate's persona"><br>
-      <sub><strong>Its character.</strong> A public one-liner under the name, and a private brief only this vibemate reads.</sub>
-    </td>
-  </tr>
-</table>
-
-## Requirements
+The menu that appears can put an icon on your desktop, open viberoom in a window of its own, or open
+it in a browser tab. Later, `npm install -g viberoom@latest` and the next start picks up the new version.
 
-- Node.js 22 or newer.
-- At least one coding agent installed on this machine. viberoom bundles the ACP adapters for Claude
-  Code and Codex and finds Gemini CLI, Cursor, OpenCode and Copilot when they are installed. Each
-  agent uses its own login and subscription; viberoom never sees your keys.
-- A Chromium-based browser (Chrome, Edge, Brave) for the app window; any modern browser for a tab.
+<br>
 
-## Install
+## Small things you will like
 
-`npm install -g viberoom`, then `viberoom`. The menu that appears can install a desktop icon, open the app window, or open a browser tab
-(Start Menu on Windows, `~/Applications/viberoom.app` on macOS, an applications-menu entry on Linux).
-Upgrade with `npm install -g viberoom@latest`; the next start replaces the running hub.
+- **Rooms remember.** The history stays with the room. Move the folder and the vibemates move with it.
+- **The window remembers.** Where it was, how big, which screen. Unplug that screen and it walks back.
+- **Nothing leaves your machine** except what each agent sends to its own provider. viberoom never
+  sees your keys; every agent keeps its own login.
+- **Edit a message.** Fix what you said; the vibemates get the memo, or the conversation rewinds.
+- **Your messages on a timeline.** A thin strip on the chat's right edge, one mark per message of yours:
+  hover for the message with its neighbours, click to jump there.
+- **Pick a folder from a tree.** Browse the machine's folders when a room needs one; make a new one on the spot.
+- **Settings save themselves.** Change a setting and it is saved: on Enter, on leaving the field, on a pick.
+- **Search the room.** Everything anyone said, one search box.
+- **For geeks.** Every panel folds its technical settings behind a toggle. You never have to open it.
 
-From a clone instead:
+<br>
 
-```sh
-git clone https://github.com/todor-rusev/viberoom.git
-cd viberoom
-npm run install:global
-```
+## What you need
 
-`install:global` builds the project, links the `viberoom` command and creates the launcher; later,
-`npm run update` rebuilds and replaces the running hub.
+- Node.js 22 or newer.
+- At least one coding agent installed and logged in: Claude Code, Codex, Gemini CLI, Cursor, OpenCode
+  or GitHub Copilot. viberoom finds the ones you have and offers only those. It installs none of them.
+- A browser. Chrome, Edge or Brave for the app window; anything modern for a tab.
+
+<br>
 
 ## Use
 
@@ -124,38 +160,29 @@ viberoom logs       the background hub's log
 ```
 
 `Enter` sends, `Shift+Enter` is a new line, `@Name` addresses one vibemate, `/name` invokes a skill.
+Your data lives in `~/.viberoom` (or `$VIBEROOM_DATA_DIR`): settings, rooms with their history,
+skills and the log.
 
-Data lives in `~/.viberoom` (or `$VIBEROOM_DATA_DIR`): settings, rooms with their history, skills,
-transcripts and the hub log. Nothing leaves your machine except what each agent sends to its own
-provider.
-
-## Settings worth knowing
-
-- **Vibemates act without asking.** On by default: agents edit files and run commands in the room's
-  folder without a permission prompt. Turn it off to be asked, or change it per vibemate.
-- **Custom rules.** One rule per line in the room's panel, handed to every vibemate as instructions:
-  who speaks to whom, how long a reply may be, where code goes.
-- **Language.** Vibemates follow the language you write in, or a fixed one for the room.
-- **Reply delay.** With two or more vibemates in a room, each waits a random few seconds before it
-  answers. A vibemate can override it; alone it answers at once.
-- **Open files at a line.** Which editor gets `path:line` clicks: the first one found (VS Code,
-  Cursor, Windsurf, Zed, Sublime Text, Notepad++, JetBrains) or your own command.
-- **Diagrams.** Colours for Mermaid diagrams: multicolour boxes by default, or a single tone.
-- **For geeks.** Every panel folds its technical settings behind a "for geeks" toggle.
+<br>
 
 ## Development
 
 ```sh
+git clone https://github.com/todor-rusev/viberoom.git
+cd viberoom
 npm install
-npm run build        # TypeScript to dist/
-node dist/main.js    # run the hub in this terminal
+npm run build        # then: node dist/main.js
 ```
 
-The web UI in `ui/` is plain HTML, CSS and JavaScript served by the hub; reload the page to see a
-change. `scripts/render-icon.mjs` renders the app icon from `assets/icon-vector.svg`.
+`npm run install:global` builds, links the `viberoom` command and creates the launcher; later,
+`npm run update` rebuilds and replaces the running hub.
 
 ## License
 
-GNU Affero General Public License v3.0 or later. You may use, change and share viberoom; if you
-distribute a changed version, or run one as a service for others, share your changes under the same
-licence. See `LICENSE` and `NOTICE` (third-party fonts and icons).
+AGPL-3.0-or-later. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+
+<br>
+
+---
+
+<p align="center">🎬 &nbsp;Idea, screenplay and direction of viberoom: <strong>Silviya Ruzhina</strong></p>

package/dist/fsbrowse.js

@@ -0,0 +1,65 @@
+// viberoom - Copyright (c) 2026 Todor Rusev - AGPL-3.0-or-later; see LICENSE
+import { existsSync } from "node:fs";
+import { mkdir, readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
+export function listRoots(platform = process.platform, exists = existsSync) {
+    if (platform !== "win32")
+        return [{ name: "/", path: "/", hidden: false }];
+    const roots = [];
+    for (let code = "C".charCodeAt(0); code <= "Z".charCodeAt(0); code++) {
+        const drive = `${String.fromCharCode(code)}:\\`;
+        if (exists(drive))
+            roots.push({ name: drive.slice(0, 2), path: drive, hidden: false });
+    }
+    return roots;
+}
+export function homeFolder() {
+    return homedir();
+}
+export function normalizeFolder(input) {
+    let trimmed = input.trim().replace(/^["']|["']$/g, "");
+    if (/^[A-Za-z]:$/.test(trimmed))
+        trimmed += "\\";
+    if (!trimmed || !isAbsolute(trimmed))
+        throw new Error("an absolute folder path is needed");
+    const full = resolve(trimmed);
+    return /^[A-Za-z]:\\?$/.test(full) ? `${full.slice(0, 2)}\\` : full.replace(new RegExp(`\\${sep}+$`), "") || sep;
+}
+function isRoot(path) {
+    return path === sep || /^[A-Za-z]:\\?$/.test(path);
+}
+export async function listFolders(input) {
+    const path = normalizeFolder(input);
+    const entries = await readdir(path, { withFileTypes: true });
+    const dirs = [];
+    for (const entry of entries) {
+        let isDir = entry.isDirectory();
+        if (!isDir && entry.isSymbolicLink()) {
+            try {
+                isDir = (await readdir(join(path, entry.name), { withFileTypes: true })) !== undefined;
+            }
+            catch {
+                isDir = false;
+            }
+        }
+        if (!isDir)
+            continue;
+        dirs.push({ name: entry.name, path: join(path, entry.name), hidden: entry.name.startsWith(".") || entry.name.startsWith("$") });
+    }
+    dirs.sort((a, b) => (a.hidden === b.hidden ? a.name.localeCompare(b.name, undefined, { sensitivity: "base" }) : a.hidden ? 1 : -1));
+    return { path, parent: isRoot(path) ? null : dirname(path), dirs };
+}
+export function validFolderName(name) {
+    const n = name.trim();
+    return n.length > 0 && n.length <= 120 && n !== "." && n !== ".." && !/[\\/:*?"<>|\u0000-\u001f]/.test(n) && !/[. ]$/.test(n);
+}
+export async function createFolder(parent, name) {
+    if (!validFolderName(name))
+        throw new Error("a folder name cannot contain \\ / : * ? \" < > | and cannot end with a dot or a space");
+    const path = join(normalizeFolder(parent), name.trim());
+    if (existsSync(path))
+        throw new Error(`"${basename(path)}" already exists here`);
+    await mkdir(path);
+    return path;
+}

package/dist/hub.js

@@ -122,6 +122,24 @@ export class Hub extends EventEmitter {
             return defaults;
         }
     }
+    saveWindowPlacement(report) {
+        const num = (v) => typeof v === "number" && Number.isFinite(v);
+        if (!num(report.left) || !num(report.top) || !num(report.width) || !num(report.height))
+            throw new Error("left, top, width and height must be numbers");
+        const screen = report.screen;
+        const record = {
+            left: Math.round(report.left),
+            top: Math.round(report.top),
+            width: Math.round(report.width),
+            height: Math.round(report.height),
+            maximized: !!report.maximized,
+            savedAt: new Date().toISOString(),
+        };
+        if (screen && num(screen.left) && num(screen.top) && num(screen.width) && num(screen.height)) {
+            record.screen = { left: Math.round(screen.left), top: Math.round(screen.top), width: Math.round(screen.width), height: Math.round(screen.height) };
+        }
+        writeJson(join(this.dataDir, "window.json"), record);
+    }
     updateSettings(patch) {
         const next = { ...this.settings, roomDefaults: { ...this.settings.roomDefaults }, vendorPresets: { ...this.settings.vendorPresets } };
         if (patch.humanName !== undefined) {

package/dist/launcher.js

@@ -120,6 +120,28 @@ export function savedWindowPlacement(profileDir) {
         return null;
     }
 }
+export function windowFilePath(dataDir) {
+    return join(dataDir, "window.json");
+}
+export function recordedWindowPlacement(dataDir) {
+    try {
+        const o = JSON.parse(readFileSync(windowFilePath(dataDir), "utf8"));
+        const num = (v) => typeof v === "number" && Number.isFinite(v);
+        if (!num(o.left) || !num(o.top) || !num(o.width) || !num(o.height))
+            return null;
+        if (o.width < 200 || o.height < 150)
+            return null;
+        const placement = { left: o.left, top: o.top, width: o.width, height: o.height, maximized: !!o.maximized };
+        const s = o.screen;
+        if (s && num(s.left) && num(s.top) && num(s.width) && num(s.height) && s.width >= 200 && s.height >= 150) {
+            placement.workArea = { left: s.left, top: s.top, right: s.left + s.width, bottom: s.top + s.height };
+        }
+        return placement;
+    }
+    catch {
+        return null;
+    }
+}
 export function windowFlags(placement) {
     const wa = placement.workArea;
     if (placement.maximized && wa && wa.right - wa.left >= 200 && wa.bottom - wa.top >= 150) {

package/dist/main.js

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 import { Hub } from "./hub.js";
 import { Logger } from "./log.js";
 import { startServer } from "./server.js";
-import { appWindowArgs, savedWindowPlacement, findChromium, isProcessAlive, logFilePath, openUrlCommand, pidFilePath, readPidFile, rotateLog, splitCommand, tailFile, writePidFile, } from "./launcher.js";
+import { appWindowArgs, recordedWindowPlacement, savedWindowPlacement, findChromium, isProcessAlive, logFilePath, openUrlCommand, pidFilePath, readPidFile, rotateLog, splitCommand, tailFile, writePidFile, } from "./launcher.js";
 import { aumidSyncScript, installShortcuts, windowsShortcutPaths } from "./shortcuts.js";
 import { runMenu } from "./tui.js";
 function parseArgs(argv) {
@@ -177,10 +177,11 @@ function openWindow(url, options, log) {
         const fresh = !existsSync(profile);
         mkdirSync(profile, { recursive: true });
         reapHiddenBrowser(profile, log);
-        const placement = fresh ? null : savedWindowPlacement(profile);
+        const recorded = fresh ? null : recordedWindowPlacement(options.dataDir);
+        const placement = recorded ?? (fresh ? null : savedWindowPlacement(profile));
         const args = appWindowArgs(url, profile, fresh, placement);
         const where = placement
-            ? `last seen at ${placement.left},${placement.top} ${placement.width}x${placement.height}${placement.maximized ? " maximized" : ""}${placement.workArea ? ` on the screen ${placement.workArea.left},${placement.workArea.top}-${placement.workArea.right},${placement.workArea.bottom}` : ""}; flags ${args.filter((a) => a.startsWith("--window-")).join(" ")}`
+            ? `last seen (${recorded ? "window's own report" : "browser profile"}) at ${placement.left},${placement.top} ${placement.width}x${placement.height}${placement.maximized ? " maximized" : ""}${placement.workArea ? ` on the screen ${placement.workArea.left},${placement.workArea.top}-${placement.workArea.right},${placement.workArea.bottom}` : ""}; flags ${args.filter((a) => a.startsWith("--window-")).join(" ")}`
             : "no saved placement";
         log.info(`opening the app window with ${chromium}: ${where}`);
         try {

package/dist/persona.js

@@ -113,7 +113,7 @@ export function buildBrief(settings, persona, roster, previousNotes, skills) {
         .filter((l) => l.length > 0);
     if (custom.length) {
         lines.push("");
-        lines.push(`Custom rules of this room (set by ${human}):`);
+        lines.push(`Room rules (set by ${human}):`);
         for (const rule of custom)
             lines.push(`- ${rule}`);
     }

package/dist/recipes.js

@@ -4,6 +4,7 @@ import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 const isWindows = process.platform === "win32";
 function resolvePackageEntry(packageName, relativeEntry) {
     try {
@@ -102,8 +103,30 @@ function resolveCopilot() {
     }
     return null;
 }
-const claudeEntry = resolvePackageEntry("@agentclientprotocol/claude-agent-acp", join("dist", "index.js"));
-const codexEntry = resolvePackageEntry("@agentclientprotocol/codex-acp", join("dist", "index.js"));
+function resolveGlobalNpmBin(name) {
+    const root = resolveGlobalNpmRoot();
+    if (!root)
+        return null;
+    const candidates = isWindows ? [join(root, "..", `${name}.cmd`)] : [join(root, "..", "..", "bin", name)];
+    return candidates.find((c) => existsSync(c)) ?? null;
+}
+function resolveClaudeCode() {
+    const onPath = resolveOnPath(["claude"]);
+    if (onPath && !/\.(cmd|bat)$/i.test(onPath))
+        return onPath;
+    const native = join(homedir(), ".local", "bin", isWindows ? "claude.exe" : "claude");
+    if (existsSync(native))
+        return native;
+    return resolveGlobalPackageEntry("@anthropic-ai/claude-code", "cli.js");
+}
+function resolveCodex() {
+    return resolveGlobalNpmBin("codex") ?? resolveOnPath(["codex"]);
+}
+const vendorDir = join(dirname(fileURLToPath(import.meta.url)), "..", "vendor", "acp");
+const claudeAdapter = join(vendorDir, "claude-agent-acp", "dist", "index.js");
+const codexAdapter = join(vendorDir, "codex-acp", "dist", "index.js");
+const claudeExe = resolveClaudeCode();
+const codexExe = resolveCodex();
 const geminiEntry = resolvePackageEntry("@google/gemini-cli", join("bundle", "gemini.js")) ??
     resolveGlobalPackageEntry("@google/gemini-cli", join("bundle", "gemini.js"));
 const cursorAgent = resolveCursorAgent();
@@ -116,7 +139,7 @@ const recipes = [
         vendor: "Claude",
         icon: "/vendor-icons/claude.svg",
         tested: true,
-        note: "Adapter around the Claude Agent SDK; uses the machine's Claude Code login and settings.",
+        note: "Adapter around the Claude Agent SDK, driving the Claude Code installed on this machine with its login and settings.",
         modelPresets: ["haiku", "sonnet", "opus", "default"],
         defaultModel: "sonnet",
         effortPresets: ["low", "medium", "high", "default"],
@@ -124,13 +147,13 @@ const recipes = [
         modePresets: ["default", "acceptEdits", "plan", "auto", "bypassPermissions"],
         defaultMode: "default",
         bypassMode: "bypassPermissions",
-        unavailableReason: claudeEntry ? null : "@agentclientprotocol/claude-agent-acp is not installed",
-        installedAt: claudeEntry,
-        installHint: "npm install (bundled with viberoom); needs a Claude Code login on this machine",
+        unavailableReason: claudeExe ? null : "Claude Code not found",
+        installedAt: claudeExe,
+        installHint: "install Claude Code (npm install -g @anthropic-ai/claude-code, or the native installer) and log in with `claude`",
         build: ({ model }) => ({
             command: process.execPath,
-            args: [claudeEntry ?? ""],
-            env: model && model !== "default" ? { ANTHROPIC_MODEL: model } : undefined,
+            args: [claudeAdapter],
+            env: { CLAUDE_CODE_EXECUTABLE: claudeExe ?? "", ...(model && model !== "default" ? { ANTHROPIC_MODEL: model } : {}) },
         }),
     },
     {
@@ -139,7 +162,7 @@ const recipes = [
         vendor: "Codex",
         icon: "/vendor-icons/codex.svg",
         tested: true,
-        note: "Adapter around the Codex App Server (bundled Codex CLI); uses the machine's Codex login (~/.codex) or CODEX_API_KEY. Mode 'agent' edits the working directory without asking; 'read-only' for a chat-only participant.",
+        note: "Adapter around the Codex App Server of the Codex CLI installed on this machine; uses its login (~/.codex) or CODEX_API_KEY. Mode 'agent' edits the working directory without asking; 'read-only' for a chat-only participant.",
         modelPresets: ["gpt-5.4-mini", "gpt-5.5", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna"],
         defaultModel: "gpt-5.4-mini",
         effortPresets: ["low", "medium", "high", "xhigh"],
@@ -147,13 +170,13 @@ const recipes = [
         modePresets: ["read-only", "agent", "agent-full-access"],
         defaultMode: "read-only",
         bypassMode: "agent-full-access",
-        unavailableReason: codexEntry ? null : "@agentclientprotocol/codex-acp is not installed",
-        installedAt: codexEntry,
-        installHint: "npm install (bundled with viberoom); needs a Codex login (codex login) or CODEX_API_KEY",
+        unavailableReason: codexExe ? null : "Codex CLI not found",
+        installedAt: codexExe,
+        installHint: "install Codex (npm install -g @openai/codex) and log in with `codex login`",
         build: () => ({
             command: process.execPath,
-            args: [codexEntry ?? ""],
-            env: { NO_BROWSER: "1" },
+            args: [codexAdapter],
+            env: { CODEX_PATH: codexExe ?? "", NO_BROWSER: "1" },
         }),
     },
     {

package/dist/room.js

@@ -556,8 +556,9 @@ export class Room extends EventEmitter {
                 runtime.briefPending = `room rules: ${briefChanges.join(", ")}`;
             this.postSystem(`Room settings updated (${briefChanges.join(", ")}); agents get refreshed instructions on their next turn.`);
         }
-        if (unknownRefs.length) {
-            this.notice(`Custom rules mention ${unknownRefs.map((n) => `@${n}`).join(", ")}, who ${unknownRefs.length > 1 ? "are" : "is"} not in the room; left as plain text.`, "warn");
+        const missing = unknownRefs.filter((n) => n !== "Name");
+        if (missing.length) {
+            this.notice(`Room rules mention ${missing.map((n) => `@${n}`).join(", ")}, who ${missing.length > 1 ? "are" : "is"} not in the room; left as plain text.`, "warn");
         }
         return this.settings;
     }

package/dist/server.js

@@ -8,6 +8,7 @@ import { dirname, join } from "node:path";
 import { existsSync as fileExists } from "node:fs";
 import { classifyOpenTarget, describeOpen, detectEditor, editorCommand, isExecutablePath, openCommand } from "./open.js";
 import { parseCsv, viewerKind, VIEWER_MAX_BYTES } from "./viewer.js";
+import { createFolder, homeFolder, listFolders, listRoots } from "./fsbrowse.js";
 let editorFound;
 function currentEditor() {
     if (editorFound === undefined)
@@ -106,6 +107,26 @@ export function startServer(hub, port, log, info, onShutdownRequest) {
             req.on("close", () => clients.delete(res));
             return;
         }
+        if (req.method === "GET" && path === "/api/fs/dirs") {
+            const at = url.searchParams.get("path");
+            if (!at) {
+                sendJson(res, 200, { ok: true, roots: listRoots(), home: homeFolder() });
+                return;
+            }
+            try {
+                sendJson(res, 200, { ok: true, ...(await listFolders(at)) });
+            }
+            catch (error) {
+                const code = error.code;
+                if (code === "ENOENT" || code === "ENOTDIR")
+                    sendJson(res, 404, { error: `no such folder: ${at}` });
+                else if (code === "EACCES" || code === "EPERM")
+                    sendJson(res, 403, { error: `no access to ${at}` });
+                else
+                    throw error;
+            }
+            return;
+        }
         if (req.method === "GET" && path === "/api/file") {
             const target = classifyOpenTarget(url.searchParams.get("path") ?? "");
             if (!target || target.kind !== "path")
@@ -202,6 +223,15 @@ export function startServer(hub, port, log, info, onShutdownRequest) {
             sendJson(res, 200, { ok: true, settings: hub.updateSettings(body) });
             return;
         }
+        if (path === "/api/fs/mkdir") {
+            sendJson(res, 200, { ok: true, path: await createFolder(String(body.parent ?? ""), String(body.name ?? "")) });
+            return;
+        }
+        if (path === "/api/window") {
+            hub.saveWindowPlacement(body);
+            sendJson(res, 200, { ok: true });
+            return;
+        }
         if (path === "/api/open") {
             const target = classifyOpenTarget(String(body.target ?? ""));
             if (!target)