piu-piu-cli 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to piu-piu. Versions follow [semver](https://semver.org).
 
+## 0.2.0 (2026-10-09)
+
+The office redesign, real people, and a studio to choose how each persona looks.
+
+- **A new office:** warm oak, built after a reference render.
+  - The open space has lit desk benches with rounded oak waterfall tops, slim chairs, laptops that open and close, and real oak parquet.
+  - There are meeting booths with sliding glass doors (olive in the main space, mustard in Studio B) and a boardroom with a boat-shaped oak table.
+  - The kitchen, lounge and library have real CC0 plants and furniture from Poly Haven.
+- **Real people:** personas are Microsoft Rocketbox avatars (MIT), driven by piu-piu's own poses. Their hands and feet are checked in every pose.
+- **Persona studio:** a full page to choose how a persona looks, from New persona or a persona's menu (Change look…).
+  - Turn the person round on an oak plinth and try them in a few poses.
+  - Filter 30 people and outfits by woman / man and business / smart casual, or keep the automatic look.
+- **Office life:**
+  - Idle personas play ping pong, baby-foot, darts and the arcade, chat in booths, make coffee, and use the sofas, always in their own suite and never walking through furniture.
+  - Waiting personas get an amber desk lamp.
+  - Long tasks bring headphones out.
+  - Claude agents on call chat on the phone.
+- **Celebrations:** confetti, a pill and a soft bell when a commit or a merge goes through (Settings → Sounds).
+- **Model picker:** the chat's model button, next to the mode, opens Claude Code's own `/model` list. The choice is kept per persona and applies straight away.
+- **Quieter name tags:** in a busy office seen from afar, only the people who need you keep their tag; people at work show a green dot instead. Zoom in or hover to see names.
+- **Dashboard:**
+  - room picker;
+  - denser, foldable panels;
+  - collapsible side panel (`\`);
+  - map controls: drag to pan, Ctrl-drag to rotate, zoom to cursor, double-click to focus.
+- **Fix:** removed the ambient light hidden in each avatar file, which over-brightened the office as more people came in.
+- Claude Code's built-in agents (Explore, Plan…) no longer take desks.
+- The license is now MIT.
+
+## 0.1.1 (2026-10-05)
+
+- Fix piu-piu setup failing with launchd "Bootstrap failed: 5" when the service was already loaded
+
 ## 0.1.0 (2026-10-05)
 
 First release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 alphousseyni sy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://unpkg.com/piu-piu-cli@0.1.0/docs/banner.svg" alt="piu-piu: a 3D office for your Claude Code agents" width="100%">
+  <img src="https://unpkg.com/piu-piu-cli@0.2.0/docs/banner.svg" alt="piu-piu: a 3D office for your Claude Code agents" width="100%">
 </p>
 
 <p align="center">
@@ -13,18 +13,23 @@
   <img alt="Vite" src="https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white">
   <img alt="pnpm" src="https://img.shields.io/badge/pnpm-F69220?style=for-the-badge&logo=pnpm&logoColor=white">
   <img alt="macOS" src="https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white">
+  <img alt="MIT" src="https://img.shields.io/badge/License-MIT-E2B45C?style=for-the-badge">
 </p>
 
 # piu-piu
 
 piu-piu shows every Claude Code session on your machine as a person in a 3D isometric office.
 
-- **People:** each session sits at a desk and types while it works. It raises a hand when it needs you, and takes a break in the lounge when it's idle.
-- **Specialists:** your Claude Code agents (`~/.claude/agents`, plugins, built-ins) are people with their own desks. They get to work whenever a session calls them.
-- **Control:** you talk to any agent from the office. From there you can approve or deny its tool calls, answer its questions, run slash commands and switch modes. You can also resume old conversations, or open the **real Claude Code** in a terminal inside the page.
+- **Personas:** each Claude Code session is a persona: a person at a desk who types while it works. It raises a hand when it needs you, and takes a break in the lounge when it's idle.
+- **Claude agents:** your real Claude Code agents (`~/.claude/agents`, plugins, built-ins) are people with their own desks. They get to work whenever a persona calls them.
+- **Control:** you talk to any persona from the office. From there you can approve or deny its tool calls, answer its questions, run slash commands and switch modes. You can also resume old conversations, or open the **real Claude Code** in a terminal inside the page.
 
 It runs locally. One daemon on `127.0.0.1:7777` watches `~/.claude` and serves the office web app. Nothing leaves your machine.
 
+<p align="center">
+  <img src="https://unpkg.com/piu-piu-cli@0.2.0/docs/marketing/hero.jpg" alt="A tour of the piu-piu office: the dashboard, an approval in the chat, the Claude Code terminal, the meeting room, the games, the desks, the booth, the kitchen and Studio B" width="100%">
+</p>
+
 ```bash
 npm i -g piu-piu
 piu-piu setup
@@ -40,7 +45,7 @@ piu-piu setup
 - [Commands](#commands)
 - [Connect your terminal sessions](#connect-your-terminal-sessions)
 - [Using the office](#using-the-office)
-- [Agents, specialists and skills](#agents-specialists-and-skills)
+- [Personas, Claude agents and skills](#personas-claude-agents-and-skills)
 - [Configuration](#configuration)
 - [Running Claude in a VM, office on the host](#running-claude-in-a-vm-office-on-the-host)
 - [How it works](#how-it-works)
@@ -63,7 +68,7 @@ piu-piu setup
 | Raised hand and amber light | Waiting for you: a permission prompt or a question |
 | Head in hands | The session hit an error |
 | Lounge, ping-pong, baby-foot | Idle for 5+ minutes. Games need at least 2 people on a break; anyone alone gets the sofa and a coffee |
-| Dashed coloured line between two people | A specialist (subagent) working for the session it's linked to |
+| Dashed coloured line between two people | A Claude agent (subagent) working for the persona it's linked to |
 | `using devops-mz` badge | The session is running that skill this turn |
 
 ### Talk and control
@@ -125,8 +130,8 @@ pnpm piu-piu setup        # same CLI, running from the checkout
 |---|---|
 | `piu-piu setup` | Hooks, channel and background service, then opens the office |
 | `piu-piu open` | Opens the office in your browser |
-| `piu-piu status` | Sessions open, working and waiting; specialists at work; approvals; terminals |
-| `piu-piu start` · `stop` · `restart` | The background service. `stop` and `restart` refuse while an agent is working in the office; add `--force` to go ahead anyway |
+| `piu-piu status` | Sessions open, working and waiting; Claude agents at work; approvals; terminals |
+| `piu-piu start` · `stop` · `restart` | The background service. `stop` and `restart` refuse while a persona is working in the office; add `--force` to go ahead anyway |
 | `piu-piu run` | Runs in the foreground instead of as a service |
 | `piu-piu logs [-f]` | Shows or follows the log |
 | `piu-piu hooks install` · `uninstall` | Claude Code hooks only |
@@ -170,15 +175,15 @@ Messages you send from the office arrive in that terminal session, and Claude an
 |---|---|
 | Open someone's conversation | Click their figure, or pick them in **Team** |
 | Jump to any agent | `⌘K` / `Ctrl+K` |
-| Rotate / pan / zoom | Drag / right-drag / scroll |
+| Move / rotate / zoom | Drag / Ctrl-click drag / scroll (or + −) |
 | Dock the sidebar beside the office | Dock button in the sidebar header |
 | Close the switcher, collapse full screen, close the sidebar | `Esc` (in that order) |
 | Lighting | Auto (follows your clock), day, sunset, night |
 
 ### Sidebar
-- **Team:** everyone, grouped by team, with filters for Working, Waiting and On a break. Specialists are listed at the bottom.
+- **Team:** everyone, grouped by team, with filters for Working, Waiting and On a break. Claude agents are listed at the bottom.
 - **Inbox:** every approval and question waiting for you, across all agents.
-- **Activity:** a live feed of prompts, tools, turns, and specialists being called.
+- **Activity:** a live feed of prompts, tools, turns, and Claude agents being called.
 - **Conversation:**
   - The project bar shows the folder, git branch and path.
   - The status strip shows the context window and session cost.
@@ -199,16 +204,18 @@ Messages you send from the office arrive in that terminal session, and Claude an
 
 ---
 
-## Agents, specialists and skills
+## Personas, Claude agents and skills
+
+piu-piu has two kinds of people: **personas** (your Claude Code chat sessions) and **Claude agents** (real Claude Code agent definitions, called by personas as subagents). In the code and API, Claude agents are still called *specialists*.
 
 | Kind | What it is | How it shows |
 |---|---|---|
-| **Agent** | A folder you work in: from `agents.yaml`, created in the office, or a "freelancer" for any other folder with a session | A person at a desk. One figure per agent; a second figure only for a parallel busy terminal |
-| **Specialist** | A Claude Code agent definition: `~/.claude/agents/*.md`, `<project>/.claude/agents/*.md`, enabled plugin agents, and built-ins (Explore, Plan, general-purpose, claude-code-guide, statusline-setup, fork) | A person with a home desk, wearing the agent's `color`. Gets a desk once called in the last 30 days; the rest are listed "on call" |
+| **Persona** | A Claude Code session in a folder you work in: from `agents.yaml`, created in the office, or a "freelancer" for any other folder with a session | A person at a desk. One figure per persona; a second figure only for a parallel busy terminal |
+| **Claude agent** | A Claude Code agent definition: `~/.claude/agents/*.md`, `<project>/.claude/agents/*.md`, enabled plugin agents, and built-ins (Explore, Plan, general-purpose, claude-code-guide, statusline-setup, fork) | A person with a home desk, wearing the agent's `color`. Gets a desk once called in the last 30 days; the rest are listed "on call" |
 | **Skill** | `~/.claude/skills/<name>` or a project skill. It runs **inside** the calling session | A `using <skill>` badge on that session |
 
-**Specialists in practice**
-- **When a session calls one** (`Task` / `Agent` tool), the specialist works at their own desk. A dashed line in their colour runs to the caller, and their label reads `For Lamine · Read: src/app.ts`.
+**Claude agents in practice**
+- **When a persona calls one** (`Task` / `Agent` tool), the Claude agent works at their own desk. A dashed line in their colour runs to the caller, and their label reads `For Lamine · Read: src/app.ts`.
 - **Parallel calls** of the same agent bring in colleagues ("Explore · 2") at free desks.
 - **Each call opens read-only in the sidebar:** the caller's brief, the tools it used and the answer it handed back. A caller's chat shows a **Helping now** strip, and its `Agent:` tool rows link to the call.
 - **Home rooms** come from the agent's name and description:
@@ -235,7 +242,7 @@ agents:
       Prefer small PRs.
     permissionMode: default    # optional starting mode: default | acceptEdits | plan
 
-# optional: seat specialists in a specific room
+# optional: seat Claude agents in a specific room
 specialists:
   mazestudio-docs: library
   devops-agent: server-room
@@ -311,8 +318,8 @@ Local only. Browser requests must come from the office's own origin (see [Securi
 |---|---|
 | `GET /api/state` | Snapshot: roster, sessions, events, approvals, running agents, terminals, specialists, recent subagent runs |
 | `GET /api/sessions/:id/transcript?before=<offset>` | A session's own conversation, paged by byte offset |
-| `GET /api/subagents/:id/transcript` | A specialist call's own conversation |
-| `GET /api/specialists/:type/runs` | Recent calls of one specialist |
+| `GET /api/subagents/:id/transcript` | A Claude agent call's own conversation |
+| `GET /api/specialists/:type/runs` | Recent calls of one Claude agent |
 | `GET /api/agents/:id/chat` | Office chat history |
 | `POST /api/agents/:id/messages` `{text}` | Send a message (or `/command`) to an agent |
 | `POST /api/agents/:id/stop` · `/reset` | Stop the current task · start a new conversation |
@@ -353,7 +360,7 @@ Local only. Browser requests must come from the office's own origin (see [Securi
 | Can't type to an open terminal session | Start it with `--dangerously-load-development-channels server:piu-piu`, or close it and continue from the office |
 | Terminal shows "Do you trust this folder?" | That's Claude Code's first-run prompt for that folder. Answer it once |
 | `posix_spawnp failed` when opening a terminal | Reinstall (`npm i -g piu-piu-cli`): the install step fixes node-pty's spawn-helper permissions |
-| A specialist stays "working" | Runs end on handback, on SubagentStop, or after 10 minutes without activity. Install hooks for instant updates |
+| A Claude agent stays "working" | Runs end on handback, on SubagentStop, or after 10 minutes without activity. Install hooks for instant updates |
 | Logs | `piu-piu logs -f` |
 
 ---
@@ -404,3 +411,9 @@ piu-piu uninstall        # service, hooks and channel
 npm rm -g piu-piu
 rm -rf ~/.piu-piu        # your data, if you want it gone too
 ```
+
+---
+
+## License
+
+[MIT](LICENSE)

package/bin/piu-piu.mjs

@@ -33,6 +33,22 @@ const fail = (msg) => {
   process.exit(1);
 };
 const quiet = (cmd, args) => spawnSync(cmd, args, { stdio: 'pipe', encoding: 'utf8' });
+const sleepSync = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+
+// launchd unloads asynchronously: loading again too soon fails with
+// "Bootstrap failed: 5". Unload, wait until it's gone, then load (retrying once).
+function launchdUnload(target) {
+  quiet('launchctl', ['bootout', target]);
+  for (let i = 0; i < 40 && quiet('launchctl', ['print', target]).status === 0; i++) sleepSync(250);
+}
+function launchdLoad(domain, plist) {
+  let r = quiet('launchctl', ['bootstrap', domain, plist]);
+  for (let i = 0; i < 3 && r.status !== 0; i++) {
+    sleepSync(1000);
+    r = quiet('launchctl', ['bootstrap', domain, plist]);
+  }
+  return r;
+}
 
 function claudeBinary() {
   for (const p of [join(homedir(), '.local', 'bin', 'claude'), '/opt/homebrew/bin/claude', '/usr/local/bin/claude']) if (existsSync(p)) return p;
@@ -138,9 +154,9 @@ function serviceInstall() {
   if (MAC) {
     const domain = `gui/${process.getuid()}`;
     // the pre-rename service, if this Mac still has it
-    quiet('launchctl', ['bootout', `${domain}/${LEGACY_LABEL}`]);
+    launchdUnload(`${domain}/${LEGACY_LABEL}`);
     rmSync(join(homedir(), 'Library', 'LaunchAgents', `${LEGACY_LABEL}.plist`), { force: true });
-    quiet('launchctl', ['bootout', `${domain}/${LABEL}`]);
+    launchdUnload(`${domain}/${LABEL}`);
     const env = [['PATH', servicePath()], ['HOME', homedir()], ...passEnv()].map(([k, v]) => `    <key>${esc(k)}</key><string>${esc(v)}</string>`).join('\n');
     mkdirSync(dirname(PLIST), { recursive: true });
     mkdirSync(dirname(LOG), { recursive: true });
@@ -170,8 +186,8 @@ ${env}
 </plist>
 `,
     );
-    const r = quiet('launchctl', ['bootstrap', domain, PLIST]);
-    if (r.status !== 0) fail(`launchctl could not start the service: ${r.stderr}`);
+    const r = launchdLoad(domain, PLIST);
+    if (r.status !== 0) fail(`launchctl could not start the service: ${r.stderr.trim()}. Try: piu-piu start`);
   } else {
     if (quiet('systemctl', ['--user', '--version']).status !== 0) fail('No systemd user session here. Run the office in the foreground instead: piu-piu run');
     mkdirSync(dirname(UNIT), { recursive: true });
@@ -204,7 +220,7 @@ WantedBy=default.target
 
 function serviceUninstall() {
   if (MAC) {
-    quiet('launchctl', ['bootout', `gui/${process.getuid()}/${LABEL}`]);
+    launchdUnload(`gui/${process.getuid()}/${LABEL}`);
     rmSync(PLIST, { force: true });
   } else {
     quiet('systemctl', ['--user', 'disable', '--now', 'piu-piu.service']);
@@ -231,7 +247,7 @@ function open() {
 async function start() {
   if (await state()) return say(c.ok('✓'), `piu-piu is running at ${c.b(URL)}`);
   if (!serviceInstalled()) serviceInstall();
-  else if (MAC) quiet('launchctl', ['bootstrap', `gui/${process.getuid()}`, PLIST]);
+  else if (MAC) launchdLoad(`gui/${process.getuid()}`, PLIST);
   else quiet('systemctl', ['--user', 'start', 'piu-piu.service']);
   if (!(await waitUp())) fail(`piu-piu didn't come up. Check the logs: piu-piu logs`);
   say(c.ok('✓'), `piu-piu is running at ${c.b(URL)}`);
@@ -239,7 +255,7 @@ async function start() {
 
 async function stop() {
   await guardBusy('Stopping');
-  if (MAC) quiet('launchctl', ['bootout', `gui/${process.getuid()}/${LABEL}`]);
+  if (MAC) launchdUnload(`gui/${process.getuid()}/${LABEL}`);
   else quiet('systemctl', ['--user', 'stop', 'piu-piu.service']);
   say(c.ok('✓'), 'piu-piu stopped. Start it again with: piu-piu start');
 }

package/dist/daemon.mjs

@@ -25,7 +25,8 @@ var config = {
   // "Working" with no activity for this long means the session stalled or was
   // killed without telling us; show it as idle.
   stalledMs: 10 * 60 * 1e3,
-  maxEvents: 2e3
+  maxEvents: 1e5
+  // a week of busy days; older events are pruned too
 };
 var ROSTER_TEMPLATE = `# piu-piu roster. Sessions whose folder is inside an agent's cwd sit at that agent's desk;
 # anything else gets a "freelancer" desk named after its folder.
@@ -89,12 +90,15 @@ function loadAppAgents() {
 function saveAppAgents(agents) {
   writeFileSync2(appAgentsPath(), JSON.stringify(agents.map(({ managed: _m, ...a }) => a), null, 2) + "\n");
 }
-function renameYamlAgent(id, name, path = config.rosterPath) {
+function updateYamlAgent(id, fields, path = config.rosterPath) {
   const doc = parseDocument(readFileSync2(path, "utf8"));
   const list = doc.get("agents");
   const item = list?.items?.find((it) => it.get("id") === id);
   if (!item) return false;
-  item.set("name", name);
+  for (const [k, v] of Object.entries(fields)) {
+    if (v === void 0) item.delete(k);
+    else item.set(k, v);
+  }
   writeFileSync2(path, doc.toString());
   return true;
 }
@@ -740,7 +744,7 @@ var AgentRuntime = class extends EventEmitter4 {
       resume = closed?.sessionId ?? this.store.agentSession(agentId);
       if (resume) this.store.setAgentSession(agentId, resume);
     }
-    this.terminals.start(agentId, { cwd, resume, mode: this.mode(agentId) }, cols, rows);
+    this.terminals.start(agentId, { cwd, resume, mode: this.mode(agentId), model: this.model(agentId) }, cols, rows);
     this.say(
       agentId,
       "status",
@@ -853,6 +857,27 @@ var AgentRuntime = class extends EventEmitter4 {
     }
     await l.query.setPermissionMode(mode);
   }
+  // The model picked in the office, if any (otherwise Claude Code's default).
+  model(agentId) {
+    return this.store.agentModel(agentId);
+  }
+  // Like /model in the terminal; applies to the running conversation too.
+  async setModel(agentId, model) {
+    this.agent(agentId);
+    const value = model && model !== "default" ? model : void 0;
+    if (value === this.model(agentId)) return;
+    this.store.setAgentModel(agentId, value);
+    const l = this.live.get(agentId);
+    if (!l) return;
+    await l.query.setModel(value);
+    const name = this.commandCache.get(agentId)?.models.find((m) => m.value === (model ?? "default"))?.displayName ?? model ?? "the default model";
+    this.say(agentId, "status", `Switched to ${name}.`);
+  }
+  // The models this agent's sessions can use, as Claude Code's /model lists them.
+  async models(agentId) {
+    await this.commands(agentId);
+    return this.commandCache.get(agentId)?.models ?? [];
+  }
   // The slash commands this agent's sessions support (built-ins, skills,
   // custom commands), minus the ones that only make sense in a terminal.
   // Loading them starts Claude Code without sending any message.
@@ -869,8 +894,9 @@ var AgentRuntime = class extends EventEmitter4 {
       options: { cwd: this.cwdOverride.get(agentId) ?? a.cwd, settingSources: ["user", "project", "local"] }
     });
     try {
+      const models = (await q.supportedModels()).map((m) => ({ value: m.value, displayName: m.displayName, description: m.description, resolvedModel: m.resolvedModel }));
       const list = (await q.supportedCommands()).filter((c) => !this.terminalOnly.has(c.name) && !c.name.startsWith("_")).map((c) => ({ name: c.name, description: c.description, argumentHint: c.argumentHint || void 0 })).sort((x, y) => x.name.localeCompare(y.name));
-      this.commandCache.set(agentId, { at: Date.now(), list });
+      this.commandCache.set(agentId, { at: Date.now(), list, models });
       return list;
     } finally {
       release();
@@ -1023,6 +1049,7 @@ var AgentRuntime = class extends EventEmitter4 {
         systemPrompt: { type: "preset", preset: "claude_code", append: instructions },
         settingSources: ["user", "project", "local"],
         permissionMode: this.mode(agentId),
+        model: this.model(agentId),
         // only processes started in "Allow all" may bypass permissions in the CLI;
         // switching to it later is honoured by ask()
         allowDangerouslySkipPermissions: this.mode(agentId) === "bypassPermissions",
@@ -1169,6 +1196,7 @@ var Terminals = class extends EventEmitter5 {
     else if (opts.resume) args.push("--resume", opts.resume);
     if (opts.mode === "bypassPermissions") args.push("--dangerously-skip-permissions");
     else if (opts.mode === "plan" || opts.mode === "acceptEdits") args.push("--permission-mode", opts.mode);
+    if (opts.model) args.push("--model", opts.model);
     ensureSpawnHelper();
     const proc = pty.spawn(claudeBinary(), args, {
       name: "xterm-256color",
@@ -1228,6 +1256,7 @@ var Terminals = class extends EventEmitter5 {
 
 // ../../apps/daemon/src/server.ts
 import { existsSync as existsSync4 } from "node:fs";
+import { userInfo } from "node:os";
 import { join as join7 } from "node:path";
 import fastifyStatic from "@fastify/static";
 import fastifyWebsocket from "@fastify/websocket";
@@ -1534,6 +1563,17 @@ async function startServer(office2, runtime2, store2, terminals2, specialists2,
     subagents: subagents2.recent()
   });
   app2.get("/api/state", async () => snapshot());
+  app2.get("/api/stats", async (req) => {
+    const hours = Math.min(48, Math.max(1, Number(req.query.hours) || 12));
+    const midnight = /* @__PURE__ */ new Date();
+    midnight.setHours(0, 0, 0, 0);
+    const name = userInfo().username;
+    return {
+      user: name.charAt(0).toUpperCase() + name.slice(1),
+      spentToday: store2.spentSince(midnight.getTime()),
+      activity: store2.activity(hours)
+    };
+  });
   app2.get("/api/sessions/:id/transcript", async (req, reply) => {
     const path = office2.transcriptPaths.get(req.params.id);
     if (!path) return reply.code(404).send({ error: "No transcript for that session yet." });
@@ -1583,7 +1623,9 @@ async function startServer(office2, runtime2, store2, terminals2, specialists2,
     const base = name.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "agent";
     let id = base;
     for (let i = 2; office2.roster.some((a) => a.id === id); i++) id = `${base}-${i}`;
-    const agent = { id, name, role: req.body?.role?.trim() || "dev", room, cwd: expandHome(cwd) };
+    const avatar = req.body?.avatar?.trim();
+    if (avatar && !/^[a-z0-9_]{1,40}$/.test(avatar)) return reply.code(400).send({ error: "Unknown look." });
+    const agent = { id, name, role: req.body?.role?.trim() || "dev", room, cwd: expandHome(cwd), ...avatar ? { avatar } : {} };
     runtime2.forget(agent.id);
     saveAppAgents([...appAgents(), agent]);
     if (req.body?.adopt?.startsWith("freelancer:")) store2.moveAgent(req.body.adopt, agent.id);
@@ -1591,13 +1633,23 @@ async function startServer(office2, runtime2, store2, terminals2, specialists2,
     return reply.code(201).send(agent);
   });
   app2.patch("/api/agents/:id", async (req, reply) => {
-    const name = req.body?.name?.trim();
-    if (!name) return reply.code(400).send({ error: "The name can\u2019t be empty." });
+    const fields = {};
+    if (req.body?.name !== void 0) {
+      const name = req.body.name.trim();
+      if (!name) return reply.code(400).send({ error: "The name can\u2019t be empty." });
+      fields.name = name;
+    }
+    if (req.body?.avatar !== void 0) {
+      const avatar = req.body.avatar.trim();
+      if (avatar && !/^[a-z0-9_]{1,40}$/.test(avatar)) return reply.code(400).send({ error: "Unknown look." });
+      fields.avatar = avatar || void 0;
+    }
+    if (!("name" in fields) && !("avatar" in fields)) return reply.code(400).send({ error: "Nothing to change." });
     const mine = appAgents();
-    if (mine.some((a) => a.id === req.params.id)) saveAppAgents(mine.map((a) => a.id === req.params.id ? { ...a, name } : a));
-    else if (!renameYamlAgent(req.params.id, name)) return reply.code(404).send({ error: "Unknown agent." });
+    if (mine.some((a) => a.id === req.params.id)) saveAppAgents(mine.map((a) => a.id === req.params.id ? { ...a, ...fields } : a));
+    else if (!updateYamlAgent(req.params.id, fields)) return reply.code(404).send({ error: "Unknown agent." });
     reloadRoster();
-    return { ok: true, name };
+    return { ok: true, ...fields };
   });
   app2.delete("/api/agents/:id", async (req, reply) => {
     const mine = appAgents();
@@ -1629,10 +1681,21 @@ async function startServer(office2, runtime2, store2, terminals2, specialists2,
   });
   app2.get("/api/agents/:id/commands", async (req, reply) => {
     try {
-      return { commands: await runtime2.commands(req.params.id), mode: runtime2.mode(req.params.id) };
+      const id = req.params.id;
+      return { commands: await runtime2.commands(id), mode: runtime2.mode(id), models: await runtime2.models(id), model: runtime2.model(id) ?? "default" };
+    } catch (err) {
+      return reply.code(404).send({ error: err.message });
+    }
+  });
+  app2.post("/api/agents/:id/model", async (req, reply) => {
+    const model = req.body?.model;
+    if (typeof model !== "string" || !/^[\w.\[\]-]{1,80}$/.test(model)) return reply.code(400).send({ error: "model must be a model name or alias" });
+    try {
+      await runtime2.setModel(req.params.id, model);
     } catch (err) {
       return reply.code(404).send({ error: err.message });
     }
+    return { model };
   });
   app2.post("/api/agents/:id/mode", async (req, reply) => {
     const mode = req.body?.mode;
@@ -1719,10 +1782,12 @@ var Store = class {
       PRAGMA journal_mode = WAL;
       CREATE TABLE IF NOT EXISTS sessions (id TEXT PRIMARY KEY, last_activity INTEGER, json TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS events (id INTEGER PRIMARY KEY AUTOINCREMENT, ts INTEGER, session_id TEXT, json TEXT NOT NULL);
+      CREATE INDEX IF NOT EXISTS events_ts ON events (ts);
       CREATE TABLE IF NOT EXISTS chat (id INTEGER PRIMARY KEY AUTOINCREMENT, agent_id TEXT NOT NULL, ts INTEGER NOT NULL, role TEXT NOT NULL, text TEXT NOT NULL);
       CREATE INDEX IF NOT EXISTS chat_agent ON chat (agent_id, id);
       CREATE TABLE IF NOT EXISTS agent_sessions (agent_id TEXT PRIMARY KEY, session_id TEXT NOT NULL, updated INTEGER NOT NULL);
       CREATE TABLE IF NOT EXISTS agent_modes (agent_id TEXT PRIMARY KEY, mode TEXT NOT NULL);
+      CREATE TABLE IF NOT EXISTS agent_models (agent_id TEXT PRIMARY KEY, model TEXT NOT NULL);
     `);
   }
   saveSession(s) {
@@ -1735,6 +1800,23 @@ var Store = class {
   addEvent(e) {
     this.db.prepare("INSERT INTO events (ts, session_id, json) VALUES (?, ?, ?)").run(e.ts, e.sessionId, JSON.stringify(e));
   }
+  // Tool calls per hour for the last `hours` hours, oldest first (for the overview chart).
+  activity(hours) {
+    const hourMs = 60 * 60 * 1e3;
+    const end = Math.floor(Date.now() / hourMs) * hourMs + hourMs;
+    const start = end - hours * hourMs;
+    const rows = this.db.prepare("SELECT CAST(ts / 3600000 AS INTEGER) * 3600000 AS hour, COUNT(*) AS n FROM events WHERE ts >= ? AND json_extract(json, '$.kind') = 'tool_start' GROUP BY hour").all(start);
+    const byHour = new Map(rows.map((r) => [Number(r.hour), Number(r.n)]));
+    return Array.from({ length: hours }, (_, i) => {
+      const hour = start + i * hourMs;
+      return { hour, tools: byHour.get(hour) ?? 0 };
+    });
+  }
+  // What the sessions active since `since` cost, including ones already closed.
+  spentSince(since) {
+    const rows = this.db.prepare("SELECT json FROM sessions WHERE last_activity >= ?").all(since);
+    return rows.reduce((sum, r) => sum + (JSON.parse(r.json).costUSD ?? 0), 0);
+  }
   recentEvents(limit) {
     const rows = this.db.prepare("SELECT json FROM events ORDER BY id DESC LIMIT ?").all(limit);
     return rows.map((r) => JSON.parse(r.json)).reverse();
@@ -1754,11 +1836,20 @@ var Store = class {
   setAgentMode(agentId, mode) {
     this.db.prepare("INSERT INTO agent_modes (agent_id, mode) VALUES (?, ?) ON CONFLICT(agent_id) DO UPDATE SET mode = excluded.mode").run(agentId, mode);
   }
+  // The model picked for an agent in the office (none: Claude Code's default).
+  agentModel(agentId) {
+    return this.db.prepare("SELECT model FROM agent_models WHERE agent_id = ?").get(agentId)?.model;
+  }
+  setAgentModel(agentId, model) {
+    if (!model) this.db.prepare("DELETE FROM agent_models WHERE agent_id = ?").run(agentId);
+    else this.db.prepare("INSERT INTO agent_models (agent_id, model) VALUES (?, ?) ON CONFLICT(agent_id) DO UPDATE SET model = excluded.model").run(agentId, model);
+  }
   // An agent was removed (or an id is being reused): drop its saved mode and
   // conversation link, so a later agent with the same id starts clean rather
   // than inheriting, say, Allow all.
   forgetAgent(agentId) {
     this.db.prepare("DELETE FROM agent_modes WHERE agent_id = ?").run(agentId);
+    this.db.prepare("DELETE FROM agent_models WHERE agent_id = ?").run(agentId);
     this.db.prepare("DELETE FROM agent_sessions WHERE agent_id = ?").run(agentId);
   }
   // A freelancer became a named agent: their office chat and conversation follow.
@@ -1766,6 +1857,7 @@ var Store = class {
     this.db.prepare("UPDATE chat SET agent_id = ? WHERE agent_id = ?").run(to, from);
     this.db.prepare("UPDATE OR REPLACE agent_sessions SET agent_id = ? WHERE agent_id = ?").run(to, from);
     this.db.prepare("UPDATE OR REPLACE agent_modes SET agent_id = ? WHERE agent_id = ?").run(to, from);
+    this.db.prepare("UPDATE OR REPLACE agent_models SET agent_id = ? WHERE agent_id = ?").run(to, from);
   }
   // The SDK session each roster agent continues when you message them.
   agentSession(agentId) {
@@ -1778,6 +1870,7 @@ var Store = class {
   }
   prune() {
     this.db.prepare("DELETE FROM events WHERE id <= (SELECT MAX(id) FROM events) - ?").run(config.maxEvents);
+    this.db.prepare("DELETE FROM events WHERE ts < ?").run(Date.now() - 7 * 24 * 60 * 60 * 1e3);
     this.db.prepare("DELETE FROM sessions WHERE last_activity < ?").run(Date.now() - 7 * 24 * 60 * 60 * 1e3);
   }
 };
@@ -1786,6 +1879,40 @@ var Store = class {
 import { open as open4, stat as stat4 } from "node:fs/promises";
 import { basename as basename5 } from "node:path";
 import chokidar3 from "chokidar";
+
+// ../../apps/daemon/src/observe/gitEvents.ts
+function gitIntent(command) {
+  if (typeof command !== "string") return void 0;
+  const cmd = command.replace(/<<-?\s*['"]?(\w+)['"]?[\s\S]*?\n\s*\1\b/g, " ").replace(/"(?:[^"\\]|\\.)*"|'[^']*'/g, " ").replace(/\s+/g, " ");
+  if (/\bgh pr merge\b/.test(cmd) || /\bgit (?:-C \S+ )?merge\b(?! --abort)/.test(cmd)) return "merge";
+  if (/\bgit (?:-C \S+ )?commit\b/.test(cmd) && !/--dry-run/.test(cmd)) return "commit";
+  return void 0;
+}
+function gitOutcome(intent, output, isError, command = "") {
+  if (isError) return void 0;
+  if (intent === "commit") {
+    const m = /^\[[^\]\n]*?\b[0-9a-f]{7,40}\] (.+)$/m.exec(output);
+    if (m) return { kind: "commit", detail: m[1].trim().slice(0, 140) };
+    if (output.trim() === "" && /\bcommit\b[^|;&]*(?:-q\b|--quiet\b|-\w*q\w*m\b)/.test(command)) {
+      const msg = /-\w*m\s+(?:"((?:[^"\\]|\\.)*)"|'([^']*)')/.exec(command);
+      const first = (msg?.[1] ?? msg?.[2] ?? "").split("\n")[0].trim();
+      return { kind: "commit", detail: first ? first.slice(0, 140) : void 0 };
+    }
+    return void 0;
+  }
+  if (/\b(?:fail|error|conflict|not mergeable|aborting)\b/i.test(output) && !/\bMerged\b/.test(output)) return void 0;
+  const pr = /Merged pull request #?(\d+)|Merged #?(\d+)/i.exec(output);
+  if (pr) return { kind: "merge", detail: `Pull request #${pr[1] ?? pr[2]} merged` };
+  if (/Fast-forward|Merge made by/.test(output)) return { kind: "merge", detail: "Branch merged" };
+  return /\bgh pr merge\b/.test(output) || output.trim() === "" ? { kind: "merge", detail: "Pull request merged" } : void 0;
+}
+function resultText(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) return content.map((c) => typeof c?.text === "string" ? c.text : "").join("\n");
+  return "";
+}
+
+// ../../apps/daemon/src/observe/transcripts.ts
 function watchTranscripts(office2) {
   const cursors = /* @__PURE__ */ new Map();
   const queue = /* @__PURE__ */ new Map();
@@ -1798,7 +1925,7 @@ function watchTranscripts(office2) {
     const { size, mtimeMs } = await stat4(path);
     let cur = cursors.get(path);
     if (!cur) {
-      cur = { offset: 0, partial: "", pending: {}, replaying: true };
+      cur = { offset: 0, partial: "", pending: {}, replaying: true, gitCalls: /* @__PURE__ */ new Map() };
       cursors.set(path, cur);
       if (Date.now() - mtimeMs > config.replayWindowMs) {
         cur.offset = size;
@@ -1904,6 +2031,8 @@ function watchTranscripts(office2) {
         patch.currentTool = block.name;
         patch.currentToolDetail = detail;
         if (block.name === "Skill" && skillOf(block.input)) patch.activeSkill = skillOf(block.input);
+        const intent = block.name === "Bash" ? gitIntent(block.input?.command) : void 0;
+        if (intent) cur.gitCalls.set(block.id, { kind: intent, command: String(block.input?.command ?? "") });
         emit("tool_start", { tool: block.name, detail }, block.id);
       } else if (block.type === "text" && block.text?.trim()) {
         const text = block.text.trim();
@@ -1926,6 +2055,12 @@ function watchTranscripts(office2) {
       for (const b of content) {
         if (b.type !== "tool_result") continue;
         emit("tool_end", { detail: b.is_error ? "error" : void 0 }, b.tool_use_id);
+        const intent = cur.gitCalls.get(b.tool_use_id);
+        if (intent) {
+          cur.gitCalls.delete(b.tool_use_id);
+          const done = gitOutcome(intent.kind, resultText(b.content), Boolean(b.is_error), intent.command);
+          if (done) emit(done.kind, { detail: done.detail }, b.tool_use_id);
+        }
       }
       apply({ lastActivity: ts, status: "working", currentTool: void 0, currentToolDetail: void 0 });
       return;