busybits 0.0.0-stage → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/.claude-plugin/marketplace.json +26 -0
  2. package/CHANGELOG.md +675 -0
  3. package/LICENSE +21 -0
  4. package/README.es.md +1457 -0
  5. package/README.fr.md +1435 -0
  6. package/README.md +1605 -2
  7. package/README.pt-BR.md +1373 -0
  8. package/dist/build.json +5 -0
  9. package/dist/cli/busybits.js +14708 -0
  10. package/dist/client/assets/art/framed/painting-abstract.png +0 -0
  11. package/dist/client/assets/art/framed/painting-beach.png +0 -0
  12. package/dist/client/assets/art/framed/painting-cat.png +0 -0
  13. package/dist/client/assets/art/framed/painting-city-night.png +0 -0
  14. package/dist/client/assets/art/framed/painting-mountains.png +0 -0
  15. package/dist/client/assets/art/framed/painting-rio.png +0 -0
  16. package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
  17. package/dist/client/assets/art/framed/painting-wave.png +0 -0
  18. package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
  19. package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
  20. package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
  21. package/dist/client/assets/art/painting-abstract.png +0 -0
  22. package/dist/client/assets/art/painting-beach.png +0 -0
  23. package/dist/client/assets/art/painting-cat.png +0 -0
  24. package/dist/client/assets/art/painting-city-night.png +0 -0
  25. package/dist/client/assets/art/painting-mountains.png +0 -0
  26. package/dist/client/assets/art/painting-rio.png +0 -0
  27. package/dist/client/assets/art/painting-sunflowers.png +0 -0
  28. package/dist/client/assets/art/painting-wave.png +0 -0
  29. package/dist/client/assets/art/painting-wide-aurora.png +0 -0
  30. package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
  31. package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
  32. package/dist/client/assets/art/poster-bug.png +0 -0
  33. package/dist/client/assets/art/poster-cat.png +0 -0
  34. package/dist/client/assets/art/poster-code.png +0 -0
  35. package/dist/client/assets/art/poster-coffee.png +0 -0
  36. package/dist/client/assets/art/poster-rocket.png +0 -0
  37. package/dist/client/assets/art/poster-ship-it.png +0 -0
  38. package/dist/client/assets/brand/apple-touch-icon.png +0 -0
  39. package/dist/client/assets/brand/favicon-16.png +0 -0
  40. package/dist/client/assets/brand/favicon-32.png +0 -0
  41. package/dist/client/assets/brand/icon-192.png +0 -0
  42. package/dist/client/assets/brand/icon-512.png +0 -0
  43. package/dist/client/assets/brand/logo-detailed.png +0 -0
  44. package/dist/client/assets/brand/logo-mark.png +0 -0
  45. package/dist/client/assets/brand/logo-mark@4x.png +0 -0
  46. package/dist/client/assets/brand/signage.png +0 -0
  47. package/dist/client/assets/brand/signage@4x.png +0 -0
  48. package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
  49. package/dist/client/assets/emoji/sheet.png +0 -0
  50. package/dist/client/assets/illustrations/empty-office.png +0 -0
  51. package/dist/client/assets/manifest.json +260 -0
  52. package/dist/client/assets/og-image.png +0 -0
  53. package/dist/client/bundle/app-AwZeKIeu.js +24 -0
  54. package/dist/client/bundle/app-CoDOLwxe.css +1 -0
  55. package/dist/client/bundle/city-DPTwQLdi.css +1 -0
  56. package/dist/client/bundle/city-YoIG0FsX.js +1 -0
  57. package/dist/client/bundle/daystats-DGzYOP8l.js +1 -0
  58. package/dist/client/bundle/dom-D2vx0KTo.js +1 -0
  59. package/dist/client/bundle/en-DBfNt5uV.js +169 -0
  60. package/dist/client/bundle/es-pnWdszTE.js +169 -0
  61. package/dist/client/bundle/format-C7qb6Cn-.js +1 -0
  62. package/dist/client/bundle/fr-CY8q9pj4.js +169 -0
  63. package/dist/client/bundle/main-DktU0GfB.js +2 -0
  64. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
  65. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
  66. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
  67. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
  68. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
  69. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
  70. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
  71. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
  72. package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
  73. package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
  74. package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
  75. package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
  76. package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
  77. package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
  78. package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
  79. package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
  80. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
  81. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
  82. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
  83. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
  84. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
  85. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
  86. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
  87. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
  88. package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
  89. package/dist/client/bundle/ptypane-NIZ2Y8QM.js +16 -0
  90. package/dist/client/bundle/room-name-CFJfHE5L.js +1 -0
  91. package/dist/client/bundle/simulator-BnBPS_Ws.js +7 -0
  92. package/dist/client/bundle/world-model-BIYmgAWC.js +1 -0
  93. package/dist/client/bundle/world-stream-BRkL9Eme.js +1 -0
  94. package/dist/client/index.html +41 -0
  95. package/dist/client/manifest.webmanifest +17 -0
  96. package/dist/server/index.js +40327 -0
  97. package/mod/README.md +193 -0
  98. package/mod/habblaud/.claude-plugin/plugin.json +11 -0
  99. package/mod/habblaud/hooks/hooks.json +4 -0
  100. package/mod/habblaud/hooks/register.ts +517 -0
  101. package/mod/habblaud-codex/hook.mjs +274 -0
  102. package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
  103. package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
  104. package/mod/habblaud-mensagens/hooks/register.ts +384 -0
  105. package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
  106. package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
  107. package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
  108. package/mod/habblaud-pi/core.ts +325 -0
  109. package/mod/habblaud-pi/extension.ts +119 -0
  110. package/mod/habblaud-pi/package.json +12 -0
  111. package/package.json +96 -4
package/CHANGELOG.md ADDED
@@ -0,0 +1,675 @@
1
+ # What's new
2
+
3
+ What changed in each version of Busybits. Each version has its own section here; the notes of each version also
4
+ appear as the GitHub release notes when it is published (`npm run release`), and Busybits opens them from
5
+ **Settings › About › See what changed**.
6
+
7
+ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and version numbers follow
8
+ [semantic versioning](https://semver.org/): a fix bumps the last number (0.2.**1**), a new feature bumps the middle
9
+ one (0.**3**.0).
10
+
11
+ ## [2.0.0] - 2026-11-12
12
+
13
+ ### Highlights
14
+
15
+ - **Habblaud is now Busybits.** New name, logo and icons everywhere; the project is a fork of Habblaud by Márcio Junior (MIT).
16
+ - **Installable from npm.** `npx busybits setup --service` installs it without a clone, and `busybits update` keeps it current (with rollback).
17
+ - **English by default.** The server, the install scripts and the browser speak English unless you pick another language.
18
+ - **One office for all your machines.** Run Busybits on several computers (Mac, Windows, WSL) and see every agent in a single office, with a remote terminal and rooms named per machine.
19
+ - **More agents in the office.** Gentle Shell sessions and Agent Hub jobs show up as characters, and "New agent" can start Claude Code, Gentle Shell or Codex inside herdr.
20
+ - **A friendlier sidebar.** A Recent view, custom rooms and favorites, a slash-command explorer, image messages, and a copy button on every code block.
21
+
22
+ ### Upgrading from Habblaud
23
+
24
+ - **Service renamed.** `habblaud.service` becomes `busybits.service` (`com.habblaud.server` becomes `com.busybits.server` on macOS). `npm run setup -- --service` and `busybits setup` replace the old service for you.
25
+ - **Claude marketplace and plugins renamed.** Every `*@habblaud` plugin becomes `*@busybits` (`busybits@busybits`, `busybits-permissions@busybits`, `busybits-messages@busybits`). Run `npm run mod:install` once: in each account it removes the old plugins and the `habblaud` marketplace and installs the new ones.
26
+ - **English is now the default language.** Set `HABBLAUD_LANG` (`es`, `pt-BR` or `fr`) or pick one in Settings › Language to change it.
27
+ - **Environment variables keep their names.** `HABBLAUD_*` variables are still honored and the state folder is still `~/.habblaud`; each `BUSYBITS_X` variable is also accepted as an alias that fills `HABBLAUD_X` when that one is not set.
28
+ - **Habblaud World is off by default.** Set `HABBLAUD_WORLD=1` to turn it on.
29
+ - **Codex hooks:** run `npm run codex:install` again and approve the hook in `/hooks`.
30
+
31
+ ### Added
32
+
33
+ - **npm package and CLI.** `npx busybits setup --service` (or `npm i -g busybits`) installs Busybits without a clone, with `busybits status|start|update|uninstall|pair`, `--help` and `--version`. `busybits setup` installs into `~/.busybits` (no `npm ci` or build), points the Claude Code mod, the Pi extension and the Codex hooks at `~/.busybits/marketplace`, and takes over an existing clone install in place: the old `habblaud.service` is stopped and replaced by `busybits.service` (`com.busybits.server` on macOS, replacing `com.habblaud.server`), the service still pins the Node used at setup, and pairing and TLS state in `~/.habblaud` are untouched. `--no-codex` skips Codex; `--after-update` restarts the service. `busybits update` refuses while another update runs (`~/.busybits/update.lock`), rolls back if the new version fails setup or, when a background service is installed, does not answer `/api/health` within 30 s, and `busybits update --rollback` returns to the previous version. `busybits setup`, `update` and `uninstall` refuse on Windows and point to `scripts/windows/install-satellite.ps1`. The command is a single ESM bundle at `dist/cli/busybits.js` (entry `scripts/cli/main.ts`), and installer scripts guard direct execution with `isDirectRun()`.
34
+ - **One-command install for clones: `npm run setup`.** Checks Node (22.12+ or 24, with an nvm hint), runs `npm ci` and the build only when they are missing, writes `~/.config/habblaud/env` (which the server reads on start) with the Claude Code accounts minus the `*.retired` and `*.backup*` folders, installs the Claude Code mod and the Gentle Shell/Pi extension, and with `--service` a user service (systemd on Linux, launchd on macOS). Idempotent, with `--dry-run`, `npm run setup:status` and `npm run setup:uninstall`. There is a "Quickstart" section in both READMEs.
35
+ - **One office for all machines.** Run Busybits on more than one computer (Mac, Windows, WSL) and see the agents of all of them in one office: one machine is the **central** (`HABBLAUD_SATELLITES=1`) and the others are **satellites** (`HABBLAUD_CENTRAL_URL`). It needs Tailscale: the central listens only on its address, on port 4749, with its own TLS and CA in `~/.habblaud/central-tls`. Pairing uses a single-use text generated in Settings › Machines and pasted into the satellite through standard input (`npm run satellite:pair`); the satellite pins the CA by checking its fingerprint before sending the code. Tokens are stored only as hashes and can be revoked instantly. On Windows, `scripts/windows/install-satellite.ps1` installs everything in Task Scheduler (restarting after a crash and writing `satellite-restarts.log`; `-DryRun` only shows); on WSL two variables in the env file are enough. Remote agents get rooms and agents labeled with the machine name, messages (with images, up to 32 MB), permission requests, detail, terminal and conversation, history, deliveries, "My day", timelapse and plan usage. A machine silent for 30 s shows as offline (and disappears after 10 min), and a message to it fails after 60 s without losing the text. The timelapse only covers the time the central is up. With both modes off (the default, and always in Docker) nothing changes. New `/satellite/v1/*` and `/api/central/*` routes and new variables are documented in `server/README.md`.
36
+ - **Remote terminal.** "Take over from here" and "Close" now work for agents on other machines (satellites with `HABBLAUD_PTY=1`). Output arrives through authenticated POSTs from the satellite and is replayed in the central's interactive window; input and resizing go through the existing action system, with deduplication of re-delivered actions. If the satellite has no `HABBLAUD_PTY=1` or no node-pty, the central shows the reason. A dropped link shows in yellow in the terminal and reconnection in green. The window header shows the machine name. Limit of 4 simultaneous remote terminals per machine.
37
+ - **Rename remote rooms.** On the central, rename a room from another machine; the name is saved only on the central, and an empty field restores the satellite's name.
38
+ - **New agent in herdr.** "New agent" offers the installed providers (Claude Code, Gentle Shell and Codex) and opens the session in the background (Claude Code only, as before), in a new herdr tab in a chosen workspace or in a split to the right of or below an existing pane (always a new pane, in the folder chosen in the dialog). It needs herdr open, outside Docker, in the `default` session. "Take over from here" focuses the herdr pane of sessions opened there. Resuming after a herdr restart has not been verified yet (`docs/herdr-resume-verification.md`); for Gentle Shell it depends on `herdr integration install pi`. New routes are in `server/README.md`.
39
+ - **Gentle Shell in the office.** Gentle Shell sessions (`gentle-shell`, based on Pi) show up like Claude Code and Codex ones, read-only: a character in the project room, activities (tools), `todo` tasks, model, tokens and cost, a read-only terminal, and the subagents (`subagent_run`) linked to the session that called them. Busybits reads `~/.gentle-shell/agent` (`HABBLAUD_GENTLE_SHELL_DIRS` chooses the folders and `HABBLAUD_GENTLE_SHELL=0` turns it off) without installing anything and without writing there. A session is open while it keeps renewing the presence `heartbeat`. No permission replies, messages, history or plan usage yet; in Docker the folder is not mounted by `docker:up`.
40
+ - **Gentle Shell messages and "needs you" (`habblaud-pi` extension).** The message box works on Gentle Shell and Pi agents (including extension `/command`, prompts and skills), and when Pi opens a question box while the agent is working, such as gentle-pi's *"Allow guarded git push? Yes/No"*, the office shows the agent waiting, with the command. The reply is still given in the terminal: Pi does not let an extension answer another one's box, so there are no Approve/Decline buttons for Gentle Shell (and the guard stays exactly as it was). `npm run pi:install` (also `pi:status` and `pi:uninstall`) puts the extension in the `settings.json` of Gentle Shell and Pi, with a backup and without touching the rest. Permission requests get `answerable: false` (notify only), and the "no plugin" reason for Gentle Shell agents now asks for `npm run pi:install`.
41
+ - **Agent Hub jobs in the office.** The read-only source shows jobs from `agy`, `opencode`, `copilot` and `codex` as main agents in the project room, with status, model and real activities from their JSONL logs. Tool calls, steps and messages appear in the agent's timeline; the feed receives only start, completion with duration, and failure with error. The final answer from `response.txt` also appears in the detail. Logs are read by offset in bounded chunks, without rereading the whole file; unknown agents use plain text without publishing steps to the feed. Finished jobs leave after the same grace period as the office; failed jobs stay marked as failed. `HABBLAUD_AGENT_HUB=auto|on|off` controls reading, and `auto` only turns on if the data folder exists. The source reads the mirror `runs/<jobId>/result.json`, `prompt.txt`, `stdout.log` and `response.txt`; details in `server/README.md`. Jobs share a single "Agent Hub" room while any are active, showing the real project mapped from worktrees or scratch copies as a secondary label in the sidebar and drawer ("project: busybits"). Each CLI has a stable account ("Agent Hub · agy", "Agent Hub · opencode", etc.) with the model shown on the agent, and long chips and labels stay on one line with an ellipsis and a full floating hint. A job's terminal shows the task, the reasoning, the tools with their outputs and the final answer, read from `stdout.log` (only the tail of large logs). It is read-only: no message box and no take over. Queued jobs show "Queued in Agent Hub".
42
+ - **Slash commands in the message box.** `/command arguments` in the message box of the agent panel or the terminal runs the command in the Claude Code session (`/compact`, `/review`...). Typing `/` opens a full explorer with all the session's commands and skills, with no 8-item cap, grouped in a scrollable panel of up to 50vh by origin (Yours, Plugins, MCP and From Claude Code), with a count per group and empty groups hidden. Search filters in real time by prefix or substring on the name and by description, highlighting the match in the name and showing the full description on a second line for the selected item or in the design-system tooltip. It supports arrow keys (wrapping at the ends), PageUp/PageDown, Home/End, hover selection, and completion by click or Enter/Tab (`Esc` closes; the `/` key does not open search while the box is focused). It also opens after a space or line break in the middle of a message (for example `analyze this with /brain`) and completes only that word, keeping the surrounding text; paths and URLs (`/home/...`, `http://...`) don't open it. The `habblaud-mensagens` plugin publishes the list at `POST /api/mod/commands` and runs the command with `$.command.run`; text starting with `/` that is not a session command fails with the reason. Interactive-menu commands (`/model` without an argument, `/config`) do not work from here. Run `/reload-plugins` (or `npm run mod:install`) to update the plugin.
43
+ - **Images in office messages.** The message box accepts Ctrl+V with screenshots and has an attach button (gallery or camera, on mobile), with thumbnails and an × to remove each image: up to 8 images of 15 MB (PNG, JPEG, GIF and WebP, checked by their bytes), and images alone are enough; if an image upload fails, it shows how to retry and blocks sending, and an uploaded image expires after 30 minutes (only expired ones ask to be attached again; removing the thumbnail frees the image on the server). With text on the clipboard, Ctrl+V pastes only the text. Slash commands do not carry images. The agent receives the text and the list of paths in `~/.habblaud/attachments/` (folders 700, files 600); from the phone with login, only with `messages` in `HABBLAUD_REMOTE_ALLOW`. Off in Docker and mock. Claude Code and Gentle Shell read the image from the path; Codex receives the paths, but it has not been verified that it reads them. New `POST` and `DELETE /api/messages/attachments` routes, `attachments` in `POST /api/messages` and `messageImages` in `GET /api/access`. See `server/README.md`.
44
+ - **My avatar in the office.** You get a character of your own (name and look in Settings › My avatar, the same on every screen), in a room of your own, the "My office" block next to the pantry. Whoever is waiting for you forms a queue in the hallway, at the door, with the stamp of your answer (Approve, Decline) and a "+N waiting" notice above 6; when you open an agent, the avatar stands beside it, without covering the bubble or the label, and clicking the agent next to it still selects the agent. When you step away from the computer, the avatar goes for coffee and then dozes off (the minutes are adjustable in Settings) and, when you return, a card summarizes what finished and who waited for you. With nothing to attend to, it joins the colleagues' fun, with its own wallet, and places a side bet while watching a match with a bet. Attention and presence (`POST /api/attention` and `/api/presence`) and the look (`/api/avatar`) are new routes, with the SSE events `attention`, `presence` and `avatar`; they live only in memory (the look in `avatar.json`) and apply on the computer itself or through remote access with login and `permissions`, `messages` or `terminal` allowed. See `server/README.md`.
45
+ - **Custom rooms and favorites.** The pixel-art star on main agents creates **Favorites**, moves straight to a room or opens the menu when there are several; the filled star removes the favorite, with an action hint and the favorite room's name in the agent detail. The context menu of the map and the list lets you rename or delete custom rooms. These actions use the same permission as sending messages (including `HABBLAUD_REMOTE_ALLOW=messages`); the map changes only the visual position, without altering the project room or the project groupings and counts. The filled star shows correctly with the approved pixel art. Favorites appear in the custom room and their subagents stay in the project room, so a favorite main agent is not duplicated in the sidebar and project counts exclude them. Custom rooms do not disappear when agents leave, and remote favorites follow the session even when the process ID changes (old favorites migrate automatically). A custom room's drawer shows the saved name (or **Favorites** when it is empty or equal to the id), lists local and remote favorite agents with their source project and counts, offers no folder actions, and shows Rename and Delete.
46
+ - **A "Recent" view in the sidebar.** A Rooms / Recent switch under the search box lists every main agent in one flat list, most recent activity first (last event, so a busy agent ranks above one that went idle), across all rooms and machines, each row with its room (and machine) label. The search and the account filters apply to it too, and the choice is remembered. The grouped Rooms view is unchanged.
47
+ - **Copy button on code blocks.** Every fenced code block in an agent reply (terminal, deliveries) now has a copy button in its top-right corner, shown on hover or keyboard focus and always visible on touch screens. It copies the code exactly as written (a leading `! ` included, nothing added), confirms with "Copied" for a moment, and falls back to a hidden textarea when the page is opened over plain http, where the Clipboard API does not exist. Inline `code` spans have no button.
48
+ - **Default character style.** In **Settings › Characters**, the **Default style** section lets you fix visual parts (skin tone, hair style and color, eyes, clothes, trousers, shoes and accessories) for new agents, with a live preview on sample characters. Parts left on "Random" keep varying with the agent's seed. The "Apply to all" button extends the rule to existing agents after confirmation in a modal dialog, without changing hand-customized characters, and "Reset" returns everything to the random draw.
49
+ - **Duplicate-conversation (intrusion) alarm.** When the same session is open in more than one terminal, the building warns you, the agents run around and get a **duplicate** badge; messages go to the newest process. Close the other terminal. The top counter bar gains **N duplicates** (click to jump to the newest) and the alert uses the same red banner as a failed CI, in the middle of the building and in rooms with a duplicated agent, instead of the red veil and the small banner at the top. The banner, the room alarm and the top-bar pulse stay on while the conversation remains duplicated (10 minutes at most) and go away as soon as the duplicate is resolved; the characters' scramble still lasts about 15 seconds. A real siren (about 3.6 s, rising and falling) replaces the ordinary bell, following the volume and the "Alerts" category of the sounds.
50
+ - **Performance panel and FPS limit.** A gauge-icon button in the top bar opens the performance window, showing CPU use (one core and total), RSS memory and JS heap, event loop latency (p99) and work counters (transcripts followed, bytes read, snapshots and SSE clients) of the central and each satellite, with sparklines of the last 10 minutes and yellow warnings for values above the limits. It measures browser metrics: frame rate (FPS), frame time (p50/p95, GPU indicator), long tasks, JS heap, DOM nodes and render scale. It lets you cap the map at 60, 30 or 15 FPS and pause rendering when the tab is in the background (also adjustable in Settings › Office), with 2 s polling active only while the panel is open and visible.
51
+ - **Pixel-art emoji.** The office emojis (bubbles, signs, banners) and the interface ones (activity, help, notices, bars) are now drawn as pixel art, from a SerenityOS sprite sheet (BSD 2-Clause) that ships with the project, at twice the previous size (20 px in normal text), close to the native emoji size, without increasing the line height. Glyphs without a sprite and the terminal symbols stay as they are. You can go back to system emoji in **Settings › Office › Pixel-art emoji**.
52
+ - **Design-system tooltip across the interface.** A single floating component replaces the browser's native balloons and the CSS balloon: it opens above or below without covering the element, respects the screen margins with a width limit, waits 400 ms on the cursor or opens immediately on keyboard focus, supports long-press on phones, and unifies the hints of the drawer, buttons and bars in the office's visual theme.
53
+ - **Pixel-art controls across the interface.** Selects, radios and checkboxes now use the same design system; the select opens a keyboard-accessible list that fits the screen.
54
+ - **Markdown tables in chat.** GFM tables in agent replies appear formatted, with alignment and their own horizontal scrolling.
55
+ - **Waiting for background subagents.** After the main turn ends, Busybits shows how many subagents are still running, with type, description, time and known tokens in the terminal and in the detail. Resuming a subagent puts it back as active until the next completion notification, including when the agent comes from a satellite.
56
+ - **Clickable links in the terminal and deliveries.** `http` and `https` addresses in agent replies (also those of markdown links, `[text](https://...)`) and in user prompts become links that open in another tab, with `rel="noopener noreferrer"`. Other schemes (`javascript:`, `data:`...) stay text. Trailing sentence punctuation (`.`, `,`, `;`, `:`, `)`, `]`, quotes) stays out of the link, and a final `)` only goes in if it opens inside the URL. Inline code and code blocks stay literal, with no link. The interactive terminal (xterm) still has no links: the `@xterm/addon-web-links` package is not installed yet.
57
+ - **Automatic cleanup of saved attachments.** Images and files sent through the message box and "New agent" (`~/.habblaud/attachments/`) are now deleted automatically after the period chosen in Settings › Saved attachments: 1, 3, 7 (default) or 30 days, or never. The server cleans on start and every hour, and only deletes request folders (named like `20261107-181926-fcdfdad9`) directly at the root, without following symlinks; the root, loose files and everything else stay untouched. Changing the period applies without a restart and only the computer itself can write it. With no attachments in this process (Docker, mock) there is no cleanup. New `GET`/`PUT /api/settings/attachments` route, with the period in `attachments.json`. See `server/README.md`.
58
+ - **The Claude Code mod speaks your language.** The mod's line under the prompt, the `/busybits` summary and the offline messages come out in English, Spanish, Portuguese or French, with singular and plural forms, picked from `HABBLAUD_LANG`, `LC_ALL`, `LC_MESSAGES`, `LANG` or `LANGUAGE` (English when none is set).
59
+ - **`BUSYBITS_*` variables.** Each `BUSYBITS_X` is an alias for `HABBLAUD_X` on the Node server: it only fills `HABBLAUD_X` when that one is not set, and the `HABBLAUD_*` names keep working. Docker Compose only passes on the `HABBLAUD_*` names. See `server/README.md`.
60
+
61
+ ### Changed
62
+
63
+ - **New name: Busybits.** The visible name changes: the page title, the pixel-art sign at the top, the logo (now a navy tile with a 3x3 grid of colored blocks, generated by `scripts/assets/busybits_brand.py`), the favicon, the icons, the share image and the server messages. Internal names stay as they were: the `HABBLAUD_*` variables and the `~/.habblaud` folder; the service, marketplace and plugins are renamed as described in "Upgrading from Habblaud". Busybits is based on [Habblaud](https://github.com/marmottajr/habblaud) by Márcio Junior (MIT). If you use the Codex hooks: the waiting notice now says Busybits, so run `npm run codex:install` again and approve the hook in `/hooks`.
64
+ - **English is the default language.** On a machine with no `HABBLAUD_LANG` and an English system (`LANG=en_US.UTF-8`, or no locale at all), the server, the install scripts (`mod:install`, `setup`...) and the browser now speak English instead of Portuguese. The system language is still honored when it is Portuguese, Spanish or French; anything else falls back to English. To pick another language set `HABBLAUD_LANG` (`HABBLAUD_LANG=es`, `pt-BR` or `fr`; in Docker, in `.env`), or pin one in Settings › Language in the browser.
65
+ - **The Claude marketplace, mod and plugins are called Busybits.** The marketplace is now `busybits` and the plugins are `busybits@busybits` (the mod, command `/busybits`; it showed up as `habblaud:` in the status line), `busybits-permissions@busybits` (was `habblaud-permissoes`) and `busybits-messages@busybits` (was `habblaud-mensagens`; the Claude Code prompt notice said "Prompt from the habblaud-mensagens plugin"). `npm run mod:install` removes every `*@habblaud` plugin and the `habblaud` marketplace in each account first; `mod:status` and `docker:up` report them as the old name until then, and `mod:uninstall` removes both generations. The plugin folders under `mod/` keep their names.
66
+ - **Clone installs move to the new names.** `npm run setup -- --service` now replaces `habblaud.service` with `busybits.service` (`com.habblaud.server` with `com.busybits.server` on macOS), and `setup --dry-run` and `setup status` mention a leftover old service.
67
+ - **Updates.** The update check reads npm and is on by default for packaged installs: it queries the npm registry every 6 hours; clone and Docker installs stay off, and `HABBLAUD_UPDATE_CHECK=1` or `0` overrides either default. A packaged install shows an "Update now" button in Settings › About that starts `busybits update` outside the service so the restart cannot kill it; clone and Docker installs keep the `git pull` hint.
68
+ - **Habblaud World is off by default.** Without configuration, nothing from Habblaud World shows up (routes return 404, nothing in the interface). `HABBLAUD_WORLD=1` turns World on (without `HABBLAUD_WORLD_URL`, it still points to `https://server.habblaud.com`).
69
+ - **Stacked usage cards.** The top bar shows the accounts as a compact stack (account letter and a minimal usage bar); the one closest to running out sits in front, in amber or red, and those without data at the back. Hovering the stack opens the fan, and hovering or focusing a card shows the full card (full name, 5 h and week, reset, and the activate button). It works by keyboard (Tab, arrows, Esc) and by touch, and respects reduced motion.
70
+ - **Much lighter on the CPU when idle.** The map used to repaint every frame (60 fps) even with nothing moving. It now redraws only when something changes or animates (agents, camera, hover/selection, effects, rooms building, particles, cars, night, seasonal themes) and keeps slow heartbeats for breathing poses and the clock, so an idle office costs roughly 1 to 10 frames per second instead of 60. The FPS cap in the performance panel still applies, and the panel now reports frames actually drawn. On the server, the Agent Hub poll lists run folders without blocking (async file reads, and one `lstat` per folder instead of two), and very large transcript lines that cannot affect the office are skipped without parsing. The office shows the same jobs and activity as before.
71
+ - **Storybook in English.** Story titles, docs pages, comments and sample data are now written in English, and the interface components render in English by default. A new **Language** switch in the Storybook toolbar changes the components to Portuguese, English, Spanish or French.
72
+
73
+ ### Fixed
74
+
75
+ - **Starting an agent from "New agent" with herdr.** The request now reaches the agent again: herdr 0.9.5 rejected the `--` before the text ("unknown option") and the agent never started, and it prints nothing when `pane run` succeeds, which Busybits read as "herdr: invalid output" (empty output from `pane run` now counts as success; other herdr commands still fail on empty output). For Gentle Shell, herdr only accepts `agent prompt` for the agent kinds it knows ("agent ... is not an active named agent"), so the pane opened but the request never arrived. The request now goes through the office message inbox that the habblaud-pi extension already reads, to the Gentle Shell session that opened in that pane (matched by folder and start time, and only when exactly one fits). It is never typed into the pane. If the session does not show up in time, the pane stays and the error says the request was not sent.
76
+ - **Crowd of old subagents after a restart.** When the server restarted, every background subagent a long session had already finished showed up as a character for about half a minute (over 200 in one session), because background agents were synced after each replayed launch, before the matching completion. The older part of a transcript is now replayed as a batch and background agents sync once at the end.
77
+ - **"Recent" no longer jumps old chats to the top after a reconnect.** When a machine (for example a WSL) dropped and came back, its sessions were re-discovered and the process start time stood in for their last activity. The Recent view now orders by the transcript's real last event.
78
+ - **Backup and retired Claude folders are not accounts.** `~/.claude.backup`, `~/.claude.backup-20260521-113111`, `~/.claude-work.retired` and similar copies used to be treated as accounts, so `mod:install` put the plugins into them and the server listed them. The scan of `$HOME` now skips a `.claude*` folder whose name has `.backup`, `.bak`, `.retired`, `.old` or `.orig` as a whole word (an optional number may follow, `.bak2`) or ends in a date/time stamp (`20260521`, `2026-05-21`, `20260521-113111`). `CLAUDE_CONFIG_DIR`, `HABBLAUD_CLAUDE_DIRS` and `HABBLAUD_ACCOUNTS` still win, and `npm run mod:uninstall -- --conta <folder>` (or install/status) still works on such a folder. If a real account has one of those words in its name, list it in `HABBLAUD_CLAUDE_DIRS`.
79
+ - **Alerts that arrive before you touch the page.** Browsers only allow audio after a click or key press, so the intrusion siren and the "needs you" bell were silently dropped when they arrived first. Busybits now asks for audio as soon as the page loads, and any blocked alert from the last minute plays on your first click or key press.
80
+ - **Context size and tokens of background agents.** Background subagents show the real context size of the last message on every path (including after a server restart), as Claude Code does, instead of the running sum of everything they have read on each call; they never fall back to the cumulative token sum when usage is available, and they leave the list immediately when finished by a task notification or a tool result.
81
+ - **Labels centered in segmented controls and buttons.** The option labels of segmented controls (the sidebar Rooms / Recent switch, the terminal filter, the playback speed, settings choices) and of option chips sat at the left edge of their button, because the radio base style set `text-align: left` after the segmented style. Radios without a dot now center their label, and `.ui-btn` / `.ui-scene-btn` center icon + text when they are wider than their content. List rows, menus and form labels stay left-aligned.
82
+
83
+ ## [1.0.3] - 2026-10-16
84
+
85
+ ### Fixed
86
+
87
+ - **City: "Reply" and "Show in the office" on notices go back to the office and open the agent's request.** With the
88
+ city open, clicking the notice of a request or question (and the browser notification, the requests chip in the bar
89
+ and Deliveries) did nothing visible: the agent was selected behind the city. Now the city closes, the drawer opens on
90
+ the agent and the request card gets focus.
91
+
92
+ ## [1.0.2] - 2026-10-16
93
+
94
+ ### Fixed
95
+
96
+ - **City: entering and liking work again after leaving the tab in the background.** After half a minute with Habblaud
97
+ in another tab or window, the character stopped sending its position to Habblaud World: it walked on screen, but
98
+ "Enter" and liking said to get closer to the door.
99
+
100
+ ## [1.0.1] - 2026-10-16
101
+
102
+ ### Fixed
103
+
104
+ - **City: the keys walk again.** In 1.0.0, with the launch popups and the Habblaud World window on the page, WASD, the
105
+ arrow keys and the office shortcuts stopped responding even with everything closed: a closed `<dialog>` stays on the
106
+ page and was mistaken for an open modal. Only open dialogs count now.
107
+
108
+ ## [1.0.0] - 2026-10-16
109
+
110
+ Why 1.0: the office (rooms, characters, subagents, per-account usage, terminal, timelapse, phone with login) has been
111
+ stable for several versions, and Habblaud World arrives complete: account, character, building, city, visits and the
112
+ light social features. To update: `git pull` and `npm run docker:up`.
113
+
114
+ ### Habblaud World
115
+
116
+ Habblaud's online city is live: each Habblaud becomes a building, lit up live while the agents work, and each person
117
+ strolls through the city with a character. **It comes on by default**, pointing to `server.habblaud.com`; **nothing
118
+ leaves the computer until you create the account** and sign in, and `HABBLAUD_WORLD=0` turns everything off (even
119
+ hiding the routes). Access is granted from a waiting list. What can leave and what never leaves is in
120
+ [`docs/world/privacidade.md`](docs/world/privacidade.md); the README has the complete **Habblaud World** section, in
121
+ the four languages.
122
+
123
+ - **Configure and test:** without `HABBLAUD_WORLD_URL`, the official server (`https://server.habblaud.com`; `npm run
124
+ docker:up` and the server log say "(default)"); when set, the one set wins (only `https://` or `wss://`; if refused,
125
+ World stays off, with the reason in the log). `HABBLAUD_WORLD=0` turns everything off, and `HABBLAUD_WORLD_DEV=1`
126
+ accepts a local world server without TLS at `http://127.0.0.1:<port>` (`npm run dev` already accepts it) or, from
127
+ inside Docker, at `http://host.docker.internal:<port>`. `docker-compose.yml` passes on the three variables and binds
128
+ `host.docker.internal` to the host (`extra_hosts` with `host-gateway`, harmless on macOS), and `npm run docker:up`
129
+ ends by saying whether World is on and to which server. The build writes `dist/build.json` with the commit and
130
+ whether the copy was modified (it goes in the first message of the building's connection).
131
+ - **Own window:** Habblaud World has a button of its own in the top bar (the city icon, next to Settings; it only
132
+ appears with the world server configured) and opens in a modal of its own, outside Settings: the pixel building, the
133
+ account state in the header and everything else in a scrollable body. The "in the world" chip next to the version,
134
+ the launch popups and the "While you were away" notice open the same window, on the right screen.
135
+ - **Account:** in the Habblaud World window. **Create account** (email and a password of 12 characters or more, the
136
+ summary of what leaves and what never leaves the computer, the line about real data and the mandatory acceptance of
137
+ the Terms of Use and the Privacy Policy; the anti-robot challenge is solved by Habblaud itself) or **I already have
138
+ an account**; 6-digit code with resend; **Forgot password**; **Devices** (up to 3, with revoke) and sign out. On the
139
+ waiting list, only the notice, with no position or estimate, and an open Habblaud checks by itself every 30 minutes
140
+ whether access has been granted. Everything only from the computer itself: never through the phone port, and what
141
+ acts on the account only with local access (the terminal lock). The device token is kept in
142
+ `~/.habblaud/world.json` (permission 600; in Docker, in the `/data` volume) and never goes to the browser, the
143
+ snapshot, the logs or the URL.
144
+ - **Player name chosen at sign-up (reserved on the waiting list):** sign-up asks for the player name (3 to 20
145
+ characters, unique in the world) together with the email and password, checked on the spot and, if already in use,
146
+ with a notice on the field itself. It stays reserved for the account while it waits on the list (the waiting screen
147
+ shows "Your player name: X (reserved)") and becomes the character's name, which is born with it without asking for
148
+ the name again (it can be changed later, once every 30 days); old accounts, without a reservation, keep choosing the
149
+ name when creating the character. `docs/world/privacidade.md` now says that the world server keeps, besides the
150
+ country, the IP of the sign-up and of the last login with password, for auditing (only administration sees them;
151
+ deleted with the account; included in "Download my data"), and no other.
152
+ - **Launch popups:** three notices in a modal window, on top of the office (and of Settings). **New: Habblaud World**,
153
+ for those who do not have an account yet, with the **Create account** button: "Not now" brings it back in 3 days (at
154
+ most 3 times), "Don't show again" ends it and, once the account is created, it does not come back. **You are on the
155
+ waiting list**, right after sign-up (or when opening the page already waiting), once per browser. **Access granted!**,
156
+ when your turn arrives and the character does not exist yet, with **Create character** taking you straight to its
157
+ screen. None of them appears through the phone port, in the timelapse or in demo mode.
158
+ - **Character:** player name, visual hint, the same appearance editor as the agent drawer, 2 or 3 personality traits
159
+ (the ones that do not match are disabled) and an introduction phrase from the list; it can be created even while on
160
+ the waiting list. If moderation changes the name, the section asks for a new name, which takes effect without
161
+ waiting for the 30 days.
162
+ - **Building visibility:** live or discreet, closed to visits, hide the country, tokens (only in bands), scoreboard,
163
+ compactions and **Notify when someone knocks** (off by default).
164
+ - **Account and data** (new screen of the Habblaud World window): the **Email me before removing my building for
165
+ inactivity** switch; **Download my data**, which saves `habblaud-world-dados.json` with what the world keeps about
166
+ the account (once a day); and **Delete account** in three steps: what disappears and when (the building and the
167
+ profile at once; the account, likes, blocks, reports made and devices from the database in 7 days; from backups,
168
+ within 30), the confirmation, which sends a code to the email, and the code. With the account deleted (from here or
169
+ from another computer), the building's connection closes and `world.json` disappears from this computer; the section
170
+ says the account was deleted.
171
+ - **Your building in the world:** with access granted and the character created, the **Your building** card shows
172
+ whether the building is connected, reconnecting, paused or out of the world (or whether the character is still
173
+ missing), how many floors and agents it has, when the last batch went out and, if the world refuses a batch, the
174
+ reason. When the world server stops the building, the card says why: **Update Habblaud** (old version), **Connected
175
+ on another computer** (with **Bring it to this computer**), account suspended or banned (with **Appeal by email**,
176
+ which opens an email to privacidade@habblaud.com with the account id in the subject) or account deleted. A building
177
+ marked **unverified** shows the badge and **Contest by email**, and the world under maintenance appears as **Under
178
+ maintenance** (Habblaud retries by itself, with backoff). **Pause** stops sending at once and turns the building off,
179
+ keeping the lot; **Resume** lights it up again. **Leave the world** (in two clicks, with the difference from pause
180
+ beside it) removes the building at once and frees the lot; the account and the character remain, and **Return to the
181
+ world** creates a new building, in another lot (leaving on another computer also applies here). **See what was
182
+ sent** opens the exact JSON of the last batch, with the time, the size in bytes, the world's response (with the
183
+ bytes it counted) and a button to copy: it is everything that left the computer. The theme chosen in **Appearance ›
184
+ Office theme** also applies to the building (and the theme saved for the building applies to the office), and the
185
+ top bar gets the badge "🏙️ in the world" / "⏸ paused" / "⚠️ stopped", which opens the section (hidden on the
186
+ narrow bar and on the phone).
187
+ - **The building goes up to the world:** with the account granted and the character created, Habblaud opens a
188
+ connection (WebSocket) to the world server and sends the live building: one floor per room with someone present and,
189
+ per agent, only a random id, main or subagent, the tool, the status, a drawn name and the appearance; plus the
190
+ theme, the tasks completed in the day as a band, the building's tokens rounded (can be turned off) and, if you turn
191
+ it on, the compactions. The floor and agent ids are random and change every 24 h (±6 h); paths, room names, titles,
192
+ activities, model, branch, account and edited names never leave. It sends on change (at most once every 5 s),
193
+ reconnects by itself with growing backoff (2 s to 60 s, also during world maintenance) and stops when the server
194
+ asks (account suspended, banned or deleted, old version, connected elsewhere). Demo-mode agents never go up. Tasks
195
+ and compactions are counted even with the building paused or disconnected, and go in the next batch.
196
+ - **The city (World button):** with the scene available (`meta.world.scene.available`), the **World** button next to
197
+ Timelapse swaps the office for the Habblaud World city, in 3/4 pixel art in the same style: blocks of 6 lots with
198
+ sidewalk, curb, lampposts, trees, crosswalks and the central square with the fountain, the benches and the totem;
199
+ empty lots become gardens (park, lake, orchard, café). Each building has the height of the open projects (up to 12
200
+ floors drawn, with a "+N" sign above that), windows lit in proportion to the agents working and blinking amber for
201
+ those waiting, the owner's theme (pumpkins, cobwebs and bats at Halloween; snow, lights, garland and tree at
202
+ Christmas), everything turned off with the "Closed" sign when the building is out, color and finish from the lot's
203
+ seed and the sign with the flag, the owner's name and the ❤️ likes. The bottom row of each block shows the facade with
204
+ the shop window and the door; the top one, with the door facing north, shows the roof with the entrance awning and
205
+ the back. At night the lampposts and windows light up. Walk with arrows/WASD (Shift runs) or by clicking (the
206
+ office's A*); the camera follows, with the usual zoom and zooming out until about 200 buildings are visible; near a
207
+ door **Enter (E)** appears (see "Visiting a building", below). Hovering a building opens the card (owner, country,
208
+ state, floors up to "24+", agents working, waiting and idle or "discreet mode", likes, "in the world since");
209
+ clicking a player opens the profile (character, country, traits, phrase, building and likes received). The other
210
+ players walk smoothly, slightly behind, at the pace at which positions arrive (5 per second for the 20 closest, 2.5
211
+ for the others), with the name above; whoever stops on a bench appears seated (you too), and when away your
212
+ character stays where it is. The minimap in the corner shows the surrounding blocks, brighter the more buildings are
213
+ connected, and takes the camera wherever you click. Esc or **Office** go back, and reopening the city returns
214
+ exactly where you were (the character, the camera and the zoom, without flicker); Settings stays open over the
215
+ city, and the office stops drawing meanwhile. The scene is loaded only when it opens. **Paused or out of the world,
216
+ your building stays dark, but you can walk around the city**: with the scene open, the connection carries only the
217
+ first message, the heartbeat and the scene commands, never the building packet, and closes together with the scene.
218
+ Account banned, suspended or deleted (or the building stopped by an old version or by another computer): the World
219
+ button disappears; it also only appears on the computer's own page (never through the phone port or without
220
+ local-only access).
221
+ - **The city through the local server:** with the scene open, Habblaud asks the world server for the piece of city
222
+ around your character (`view`) through the same building connection and passes it to the browser through `GET
223
+ /api/world/stream` (SSE: the whole state on opening, then each change in order); once the scene is closed, it
224
+ notifies (`view.off`) and nothing else comes down. Buildings per chunk with a revision (a jump asks for the area
225
+ again), nearby players, minimap and your position live only in memory. The character commands (`POST
226
+ /api/world/cmd`: walk, profile, enter and leave a building and those of the light social features) are checked field
227
+ by field, at most 5 lots per second and only the last step of each lot; at most 4 tabs with the city. Only from the
228
+ computer itself and only from its own page (never from another site). The city geometry (lots, blocks, doors,
229
+ chunks and what is walkable) lives in `shared/world/city.ts`, the same as the world server's. Your character enters
230
+ the street at the position the world server validated (on the sidewalk of your door or in the square).
231
+ - **Visiting a building:** within 2 tiles of a building's door, **Enter (E)** takes you inside: the owner's office as
232
+ they see theirs, with their theme, the rooms with the day's fictional names ("Projeto Ipê", "Projeto Jade"...) and
233
+ the agents in their current status (typing, hand raised, eyeing the terminal or idle, with the social life
234
+ simulated in your browser), changing instantly with each packet from the owner. You enter through the elevator with
235
+ your character and the **visitor** badge and walk with the keyboard or by clicking (without sitting at the desks).
236
+ The top banner says whose building it is, how many floors and agents, and whether it is in discreet mode (empty
237
+ rooms, with the light on) or turned off (paused: everything dark); the side panel lists the rooms and agents (name,
238
+ role, tool and status; clicking opens a card with that and nothing else). Nothing coming from the world has a time,
239
+ so inside there are no popcorn, cobwebs, stopwatch or "waiting for X". **Leave** through the button, Esc or the
240
+ reception elevator returns to the sidewalk in front of the door. In the panel, **Like** (with the total; from
241
+ inside, without the distance from the door) and **Leave a stamp** (one of the 8 lobby stamps, one per building per
242
+ day); the cork board at reception shows the stamp you left today and, in your own building, those of "While you
243
+ were away". A building closed to visits, full (20 visitors), blocked or too far away gives an on-screen notice.
244
+ Nothing that acts on the office exists in the visit (no terminal, drawer, feed, notices, permission requests,
245
+ messages, My day, timelapse, editor or room renaming): it runs in a separate world, which only talks to
246
+ `/api/world/*`, and none of your steps in there leaves the computer. The little coins of the visited agents' social
247
+ life stay under a separate key and disappear when you leave. **See how others see it** (in the **Your building**
248
+ card and at your building's door) enters your own building. **For the owner:** the top badge gets "👀 N" and the
249
+ **Your building** card, "N visitors now" (only the count, never who); the first visitor of each connection gives the
250
+ notice "Someone entered your building", which can be turned off in **Habblaud World › Notify when someone visits**.
251
+ Through the local server, the scene stream passes on the interior (`building`, `building.patch` with the revision
252
+ checked and `resync {building}` on a jump) and the visitors (`visitors`, also in `meta.world.building.visitors`).
253
+ - **Light social features, with no free text at all:** in the city, **L** (or the ❤️ button that appears near the
254
+ door, up to 4 steps) likes a building, and the heart flies to the sign, whose counter jumps; **G** opens the wheel
255
+ with the 10 greetings (keys 1–9 and 0, arrows or touch), for whoever just greeted you, whoever is on the card or
256
+ whoever is closest, with 5 s bubbles above heads (one does not cover another) and "G to reply" when someone greets
257
+ you; **K** knocks on the door of those who accept (up to 2 steps). The player card gets **Greet**, **Block** (in two
258
+ clicks: you stop seeing each other) and **Report** (fixed reasons, "Report sent"); the building one, **Like**,
259
+ **Knock**, the building code and the "unverified" badge. On the minimap, **Go to HB-XXXX** and **Visit a random
260
+ building**, with a fade while the character walks to the sidewalk by the door. In the square, the thermometer of
261
+ the week's collective goal ("10 thousand hours of agents working") and the city hall sign (the buildings lit and
262
+ "the city consumed ≈ X this week", only with 10 buildings or more); once the goal is hit, 20 s of fireworks
263
+ (sometimes heart-shaped) and, for everyone, bunting with little bulbs and the season's decoration. On the
264
+ facades, the day's token meter beside the door, the sign with 5 intensities from the week's band (from off to neon
265
+ with sparks) and confetti when a building ends its shift. On the phone, the buttons sit in the corner, icons only.
266
+ **In the office:** the bar chip gets "❤️ N today"; on connecting, the **While you were away** card (visits, likes
267
+ and the stamps left at the lobby, without who) appears in the corner and also in **Your building**, with the
268
+ building code to send to a friend; **Notify when someone knocks** (Visibility, off by default) shows "Someone
269
+ knocked on your building's door"; **Habblaud World › Blocked** lists whom you blocked, with **Unblock**. **Through
270
+ the local server:** `POST /api/world/summary/seen` and `/api/world/unblock`, and the commands `like`, `unlike`,
271
+ `greet`, `block`, `unblock`, `report`, `stamp`, `teleport`, `knock` and `summary.seen` on the scene, checked field by
272
+ field.
273
+ - **Local routes** (`/api/world/*`, only from the computer itself): the account (sign-up, code, sign in, sign out,
274
+ resend, change password, character, visibility with the optional inactivity notice, devices); the building
275
+ (`POST /api/world/pause` and `/resume`, which stop sending before responding; `/leave`, which only responds after
276
+ the world server removes the building; `/join`, which asks for the return before reconnecting; `PUT
277
+ /api/world/theme`, with automatic turning into the day's theme; `GET /api/world/last-uplink`, the last stored batch
278
+ in `~/.habblaud/world-last-uplink.json`, permission 600); and the account and data (`POST /api/world/delete-account`
279
+ and `/delete-account/confirm`, which only responds after closing the building and deleting `world.json`; `GET
280
+ /api/world/export`, the account JSON as an attachment, only from the page itself). A resume the world server did not
281
+ confirm retries with the reconnection backoff. The World status and the snapshot (`meta.world.building`) carry the
282
+ building summary: connected, paused, out of the world, stopped, floors, agents and the last batch.
283
+ - **Open protocol and transparency:** `shared/world/protocol.ts` and `schema.json` define everything Habblaud
284
+ exchanges with World (Phase 4 adds the door notices, the owner's visitors and the building `resync`; Phase 5, the
285
+ names of the light social features: stamps, city goals, the day's likes, the "while you were away" summary, knocking
286
+ and the building code; Phase 6, the `deleted` `goodbye`, the `maintenance` error, the `implausible` refusal of the
287
+ packet, the visibility's `notifyInactivity`, the building's `unverified` badge and the deletion and export formats);
288
+ the player name rules, the 14 traits, the 20 introduction phrases, the 10 greetings and the 60 fictional floor names
289
+ ("Projeto Ipê", "Projeto Jade"...) live in `shared/world/`. `docs/world/privacidade.md` lists every field of the
290
+ packet and of the connection, with a test that checks the page against `schema.json`; the projection tests check
291
+ every key and that no office text appears in the packet. The notice about real data, for people and AI agents, is in
292
+ `CLAUDE.md`, `AGENTS.md`, `shared/world/README.md` and the World files, and `CONTRIBUTING.md` has the review rule for
293
+ PRs that touch it.
294
+ - **Demo mode:** `?mock=1&world=logged_out` (or `waiting`, `approved`) simulates the server (the code is 123456), with
295
+ the example building and batch from `docs/world/privacidade.md`; `?mock=1&world=approved&scene=city` opens a fake
296
+ city (20 buildings, yours on lot (3,1), 5 people walking and one sitting on a square bench; `&perf=N` fills N lots),
297
+ with buildings to visit (live, discreet and off) and the light social features (bots that greet and reply, the goal
298
+ at 80 % and, with `&fireworks=1`, a fireworks test button). `npm run shots:world` redoes the screenshots
299
+ `docs/screenshots/world-predio.png`, `world-enviado.png`, `world-cidade.png`, `world-cartao.png`,
300
+ `world-visita.png`, `world-visita-painel.png`, `world-social.png` and `world-praca.png`.
301
+
302
+ ## [0.11.0] - 2026-10-13
303
+
304
+ To update: `git pull` and `npm run docker:up` (it also updates the Habblaud mod in the accounts). Phone access is
305
+ optional and stays off until you run `npm run remote:setup`; the step by step is in the README, under "Phone with login
306
+ and HTTPS". New agent needs `HABBLAUD_PTY=1` in `.env`.
307
+
308
+ ### Added
309
+
310
+ - **Phone with login and HTTPS (optional, off until configured):** `npm run remote:setup` asks for a username, a
311
+ password (stored only as a scrypt hash in `.env`), a name for the address (`https://<name>.local`) and, if you want,
312
+ an address of your own (e.g. `meuclaude.home`). It creates a local CA and the server certificate and leaves the
313
+ `<name>.local` announcement running as a service. The phone connects on a **second port** (443 if free, otherwise
314
+ 4748), which is only published after the setup: every request on it requires login, and by default the phone
315
+ **approves and declines permission requests**; messages, terminal (with **Deliveries**: what each agent finished,
316
+ with summary and attachments) and New agent only with `HABBLAUD_REMOTE_ALLOW`. Port 4747 stays computer-only and
317
+ without login. **Settings › Phone access › Sign out** ends that device's login (a copy of the cookie also stops
318
+ being valid). Contributed by @jasminaladdn (#96).
319
+ - **New agent (+ button in the top bar, opt-in with `HABBLAUD_PTY=1`):** starts a Claude Code session in the
320
+ background on the computer (`claude --bg`), in the chosen folder (recent projects come suggested), with the written
321
+ request and attachments; it shows up in the office and receives messages and permissions through Habblaud. In a
322
+ folder Claude Code does not know yet, it opens the Claude app's new-session screen filled in. In Docker, the host
323
+ helper starts it (`npm run codex:bridge`, which now also runs without Codex). From the phone, it also needs `spawn`
324
+ in `HABBLAUD_REMOTE_ALLOW`.
325
+ - **Dictation** in New agent and the message box: the browser records and **local Whisper** transcribes
326
+ (`whisper-cli` + `ffmpeg` + a multilingual model); the voice does not leave the computer. Without them, the button
327
+ does not appear.
328
+ - **Waiting up to 24 h through the office:** `HABBLAUD_PERMISSION_TIMEOUT` accepts up to 86400 s (before 1800, and
329
+ the plugin cut at 330 s). The default is still 5 min. On a long wait, with no page answering for 5 min (and no
330
+ phone with login set up to answer), the request goes back to the terminal.
331
+ - **Messages to Claude desktop app sessions:** the `habblaud-mensagens` plugin also asks Habblaud in sessions with
332
+ `CLAUDE_CODE_ENTRYPOINT=claude-desktop` (before, only in those with a terminal on screen).
333
+ - A request waiting without buttons in the office (the hook already handed it back to the terminal, or the session
334
+ opened without the plugin): the terminal footer says to answer in Claude Code (or in Codex).
335
+
336
+ ### Security
337
+
338
+ - On the remote port, what separates "from the computer itself" from "from the network" is the port the connection
339
+ arrived on, never the Host header. The routes of the hooks, the plugins and the host helper, the interactive
340
+ terminal, the character editor and room renaming never apply through it, even with login.
341
+ - The local CA only signs `localhost`, `.local` names, the own address and private-network IPs (critical
342
+ `nameConstraints`): even with a leaked key, a certificate for another site is refused. The key never goes into the
343
+ container.
344
+ - Session in an `HttpOnly`, `SameSite=Strict` and `Secure` cookie, signed with HMAC (changing the password drops all
345
+ of them). One password check at a time, counted before scrypt; after 5 wrong passwords in a row, each attempt waits
346
+ from 1 s to 5 min.
347
+ - In Docker, the host helper only reads delivery files from known project folders (the ones Claude Code has in
348
+ `<account>/projects`), from the temporary folder and from the attachments, and nothing that looks like a secret.
349
+ Files and dictation use long-polling rounds (the server only responds when work arrives), instead of asking every
350
+ half second.
351
+
352
+ ### Fixed
353
+
354
+ - Phone: tapping a text field no longer zooms (iPhone Safari enlarges fields with text smaller than 16 px).
355
+ - In the timelapse, the corner notices stay above the playback bar, instead of covering the timeline and the buttons.
356
+ - With many accounts or a narrow window, the usage cards go to a second row of the top bar, instead of covering the
357
+ right-hand buttons (zoom, My day, Settings, Help).
358
+ - On the phone (up to 480 px), the top bar no longer cuts the logo and the side panel button: the counters move down
359
+ to the usage cards row.
360
+ - "My day" on the phone: the Demo | Real data selector no longer goes off screen (in French, not even at 390 px).
361
+ - Two permission requests from the same agent at the same instant: the detail of the newer one no longer says there is
362
+ another request waiting behind it.
363
+ - "My day": the limit of 1,000 waits per day also applies when all of them are open (before, the list and the day's
364
+ file grew without a ceiling).
365
+ - A conversation file rewritten in place (instead of only growing) is read from the start again; before, the new
366
+ content was ignored or read from the middle.
367
+
368
+ ## [0.10.0] - 2026-10-13
369
+
370
+ To update: `git pull` and `npm run docker:up`. The interface follows the browser's language (or Settings › Language).
371
+ The texts the server builds are still in Portuguese; for another language, set `HABBLAUD_LANG` (`en`, `es` or `fr`)
372
+ in `.env` before `docker:up`. In October, the automatic theme already puts the office in the Halloween mood; for the
373
+ usual look, choose **None** in Settings › Appearance.
374
+
375
+ ### Added
376
+
377
+ - **Office themes** in Settings › Appearance: pixel-art decoration (trees with gifts, garlands and snow on the windows
378
+ at Christmas; pumpkins, ghosts, cobwebs and bats at Halloween), lights, rugs and accessories on the characters.
379
+ **Automatic**, the default, follows the calendar: Halloween from October 1 to 31 and Christmas from November 1 to
380
+ December 26 (the rest of the year, the usual look). **None** keeps the usual look all year, and **Christmas** and
381
+ **Halloween** pin a theme. The choice is saved in the browser.
382
+ - **Interface in English, Spanish and French.** The texts go through `tr()` (`shared/i18n.ts`), with Portuguese as the
383
+ source language: a text without a translation stays in PT. The interface follows the browser and can be pinned in
384
+ **Settings › Language**. The texts the server builds (activities, notices, terminal, logs and install scripts)
385
+ follow `HABBLAUD_LANG` (`pt-BR`, `en`, `es` or `fr`) and, without it, the system language, except English (many
386
+ machines and every container come in English by default): for the server in English, `HABBLAUD_LANG=en`.
387
+ `npm run i18n:check` lists the texts still without a translation. The French came from the community (#67).
388
+ - **README in English**, with versions in Portuguese (`README.pt-BR.md`), Spanish and French, and the language row at
389
+ the top of each.
390
+
391
+ ## [0.9.0] - 2026-10-13
392
+
393
+ To update: `git pull` and `npm run docker:up`. The interactive terminal comes off and only works outside Docker:
394
+ `npm install`, `npm run build` and `HABBLAUD_PTY=1 npm start` (first read the notice under "Privacy and security" in
395
+ the README).
396
+
397
+ ### Added
398
+
399
+ - **Interactive terminal (opt-in, `HABBLAUD_PTY=1`):** the real Claude Code in an office window, with tabs for the
400
+ agents of the same project. **New session** opens a Claude Code in the room's folder; **Take over from here** ends
401
+ the session open in another terminal and continues the same conversation here (`claude --resume`); **Close** and the
402
+ tabs' X close the session, here or in another terminal. Only for Claude Code sessions (neither Codex nor demo).
403
+ Before ending an outside process, Habblaud checks that the PID is still that Claude Code. It uses `node-pty` and
404
+ `@xterm/headless` (optional dependencies); the screen comes back whole on reconnecting or switching tabs, with the
405
+ modes Claude turned on. On start, it opens a test terminal: if `node-pty` or `claude` do not work, the feature stays
406
+ off, with the reason in the log (on macOS, it first fixes the missing execute permission on `node-pty` 1.1.0's
407
+ `spawn-helper`).
408
+ - **Terminal tabs and shortcut:** the terminal window gained tabs with the main agents of the same project (with the
409
+ start of what each one does), and the side list, a shortcut next to each agent that opens its terminal. With a
410
+ terminal open, clicking another agent in the list switches the window to that one. They also apply to the live
411
+ terminal, with the interactive one off.
412
+
413
+ ### Fixed
414
+
415
+ - A message sent through the office no longer goes to the wrong conversation: if the agent switches conversation
416
+ (`/clear`, `/resume` or another thread in Codex) before fetching it, it fails with the reason instead of entering
417
+ the new conversation.
418
+ - Old tasks and their states are preserved when recovering sessions with a long history that gained new tasks.
419
+ - The activity detail no longer shows the secret of webhooks (Slack, Discord and Telegram) or of `npm_` and `hf_`
420
+ tokens pasted in a command.
421
+ - Messages to Codex in Docker are now delivered one at a time per session and confirmed individually, reducing
422
+ premature failures and duplicate resends.
423
+ - Malformed Claude Code task lists do not interrupt reading; the office preserves the other activities of the same
424
+ batch, including in subagents.
425
+ - A Codex image written on Windows (`C:` drive or a network folder `\\server\...`) appeared with the wrong path in the
426
+ activity and in the terminal (`/C:/...`, or the folder without the server). Now the path is the source file's.
427
+ - Saving a character or returning to the random draw no longer closes another open edit while the response arrives,
428
+ nor shows in it an error from the previous edit.
429
+ - A huge line in a conversation, or a line that never closed, stayed whole in memory and reading slowed down. A line
430
+ above 8 MB is now ignored, and Habblaud continues on the next line.
431
+ - Reverted Codex sessions now show the current turn in the office and in the terminal, even when the previous
432
+ conversation's file remains on disk.
433
+ - In the timelapse, the agent's timeline stops showing what happened after the replayed moment when going back in
434
+ time. A history response that was still on its way also no longer enters during the replay.
435
+ - In the timelapse, the panels' times follow the playback and stay still when paused, together with the office and the
436
+ replay badge.
437
+ - The paused feed keeps only the 50 most recent events and frees the data of old sessions, keeping the count of news.
438
+ - In the timelapse, the arrows on the speed control now change the speed, instead of moving the office camera.
439
+ - The office avoids duplicate live connections and frees the network and font resources when closed.
440
+ - `usage:install`, `hooks:install`, `mod:install` and `codex:install` stop when the configuration file changes in the
441
+ middle of the installation, instead of erasing that edit (it also disappeared from the backup). Run the command
442
+ again; the backup becomes the file that was replaced.
443
+
444
+ ## [0.8.0] - 2026-10-09
445
+
446
+ To update: `git pull` and `npm run docker:up`. Renaming rooms and editing the character only work from the computer
447
+ itself (the same lock as the terminal). Room names are kept in `rooms.json` and characters in `names.json`, in
448
+ Habblaud's data folder; going back to 0.7 makes the chosen characters disappear on the first write.
449
+
450
+ ### Added
451
+
452
+ - The side list and the character's hint show the session title (for subagents, the task) below the name. In the
453
+ list, the main agent idle for 1 minute or more shows **idle 12 min** in place of "Main"; in the hint, the state
454
+ comes with how long it has been that way (**12 min ago**).
455
+ - **Movable windows:** the terminal and the agent drawer detach by dragging the bar, resize from any edge or corner
456
+ and return to place with a double click on the bar. The terminal gets the **Expand to full screen** button.
457
+ Position and size are saved in the browser; on a narrow screen everything stays fixed. Once detached, the drawer
458
+ stops reserving the office's side.
459
+ - **Reorder the side list:** dragging a main agent's row changes the order of the room's agents, and dragging a room's
460
+ header changes the order of the rooms (in the building they stay where they are). The order is saved in the
461
+ browser; the agents' one goes through the Claude Code session and survives resuming the session.
462
+ - **Rename room:** right click on a room (in the side list or in the office) opens a field to give it another name;
463
+ empty goes back to the folder name. The name is kept on the server (`rooms.json`, in Habblaud's data folder), per
464
+ folder: it applies in any browser and survives restarts. In the room's drawer, a pencil next to the name opens the
465
+ same field. Only from the computer itself; demo rooms do not change.
466
+ - **Edit a project's character.** In the main agent's details, the pencil next to the name opens an editor with the
467
+ name, **Draw** and the parts (skin, hair, beard, eyes, clothes, shoes and accessory), with a preview. The choice
468
+ applies to the project: the next session in the same room arrives with the same character, and **Back to the draw**
469
+ undoes it. It only works from the computer itself, like the terminal.
470
+
471
+ ### Changed
472
+
473
+ - The agent's timeline shows the 15 most recent items, with **Show more** (15 more per click, up to the 200 kept)
474
+ and **Show less** (back to 15). Before it was 80 at once.
475
+
476
+ ### Fixed
477
+
478
+ - On Windows, messages to Codex looked for `codex` in the PATH and found the script npm installs next to the
479
+ executable: Habblaud said messages were on, but every delivery failed, because the script does not run without a
480
+ shell. Now the search is for `codex.exe`. With Codex installed only through npm, point `HABBLAUD_CODEX_BIN` to a
481
+ `codex.exe`.
482
+ - On Windows, the statusline command that existed before `npm run usage:install` (Habblaud keeps it and keeps running
483
+ it) was executed by `cmd.exe`, and what worked in Claude Code (single quotes, variables, pipes) broke. Now it runs
484
+ in Git Bash, as in Claude Code: the one from `CLAUDE_CODE_GIT_BASH_PATH` or from the Git installation. Without Git
485
+ Bash, it stays on `cmd.exe`.
486
+ - On Windows, the installers (`usage:install`, `hooks:install`, `codex:install` and `mod:install`) showed the user
487
+ folder paths in full (`C:\Users\...`) instead of `~/...`.
488
+ - The test suite (`npm test`) passes on Windows: the tests that assumed Linux and macOS paths, shell or permissions
489
+ now hold on all three systems, and the few that depend on something Windows does not have are skipped there.
490
+
491
+ ## [0.7.0] - 2026-10-09
492
+
493
+ To update: `git pull` and `npm run docker:up` (Codex shows up by itself, if there is a `~/.codex` folder). To see
494
+ Codex live and approve through the office: `npm run codex:install` and approve Habblaud's hooks in `/hooks` in Codex
495
+ (restart Codex first, if it was open). With Habblaud in Docker, to send messages to Codex keep
496
+ `npm run codex:bridge` running on the Mac.
497
+
498
+ ### Added
499
+
500
+ - **Codex in the office.** OpenAI Codex sessions (the `codex` CLI and the app) enter the office like Claude Code's:
501
+ each project is a room (the same as Claude Code's, when both are on the same project), each session a character
502
+ with the **CODEX** badge, with activity, subagents, terminal, history, 5-hour and weekly usage (with the age of the
503
+ numbers and "no quota" when credits run out) and My day (tokens only: Codex does not report cost). Without
504
+ installing anything, Habblaud reads Codex's files (`~/.codex`, `CODEX_HOME` or `~/.codex*`; `HABBLAUD_CODEX_DIRS`
505
+ chooses the folders and `HABBLAUD_CODEX=0` turns it off). A session enters with the first message, which is when
506
+ Codex tells the project folder (a CLI that is open and still without a conversation does not appear). In Docker,
507
+ only `sessions/`, `archived_sessions/` and `thread-writer-locks/` are mounted, read-only.
508
+ - **Codex live and approve through the office:** `npm run codex:install` adds Habblaud's hooks to
509
+ `~/.codex/hooks.json` (with a backup; other apps' hooks stay in place) and, after approving them in `/hooks` in
510
+ Codex, the activity is the current one (and not only when each step finishes) and approval requests wait for your
511
+ answer in the office for up to 25 s (`-- --espera <s>`) before going to the terminal. `codex:status` checks and
512
+ `codex:uninstall` removes.
513
+ - **Messages to Codex** through the same **Send message** box, via `codex queue` (they enter when the session
514
+ finishes what it is doing). In Docker, keep `npm run codex:bridge` running on the Mac.
515
+
516
+ ### Changed
517
+
518
+ - A Codex folder never becomes a Claude Code account, not even listed in `HABBLAUD_CLAUDE_DIRS` or
519
+ `CLAUDE_CONFIG_DIR`; the server and `docker:up` warn.
520
+ - With four accounts or more, the top usage cards get narrower and the zoom buttons disappear up to 1700 px of width,
521
+ so as not to invade the right-hand buttons.
522
+
523
+ ## [0.6.0] - 2026-10-09
524
+
525
+ To update: `git pull`, `npm run docker:up` and `npm run mod:install` (brings the new permissions plugin and the
526
+ messages one); in sessions already open, `/reload-plugins`.
527
+
528
+ ### Added
529
+
530
+ - **Answer the agent's questions through the office.** When the agent asks a question (`AskUserQuestion`), the
531
+ questions card shows each one with the options and descriptions: choose one (or several, when the question allows),
532
+ write yours in "Other" or decline. As with permissions, the dialog stays in the terminal and what you answer first
533
+ wins; the `P` key and the "need you" counter also lead to the questions. It needs this version's
534
+ `habblaud-permissoes` plugin.
535
+ - **Send messages to agents through the office.** The details of each main agent gain the "Send message" section: the
536
+ text enters the session as if you had typed it in its terminal (with the agent busy, it enters when it finishes the
537
+ turn), and the box shows whether the message is queued, delivered or not. It comes from a new plugin,
538
+ `habblaud-mensagens` (Claude Code 2.1.287+), installed by `npm run mod:install` (`-- --sem-mensagens` leaves it
539
+ out); `npm run docker:up` does not install it by itself, it only warns. It follows the terminal lock (local access
540
+ only) and `HABBLAUD_MENSAGENS=0` turns it off. Read the notice under "Privacy and security" in the README: any
541
+ program on this machine can send messages to sessions that have the plugin.
542
+
543
+ ### Changed
544
+
545
+ - **The terminal (`T` key) accepts typing.** It stopped being "read-only": on main agents, the footer became the
546
+ message box (`Enter` sends, `Shift+Enter` breaks the line). Subagents and history sessions stay read-only.
547
+ - `npm run mod:install`, `mod:status` and `mod:uninstall` also take care of the `habblaud-mensagens` plugin, and
548
+ `mod:status` says whether Habblaud has messages turned on.
549
+
550
+ ## [0.5.0] - 2026-10-09
551
+
552
+ ### Added
553
+
554
+ - The "Needs you" card shows the full `AskUserQuestion` questions, with the options and descriptions (up to 4
555
+ questions, with 6 options each). It is read-only: the answer is still given in Claude Code.
556
+ - Automatic checks on GitHub (Actions): on every push to `main` and every pull request, the project runs `typecheck`,
557
+ tests and build on Node 22.12, the minimum version `package.json` declares.
558
+
559
+ ### Fixed
560
+
561
+ - When a transcript file was deleted and another, larger one was created in its place, Habblaud could miss the swap:
562
+ some filesystems reuse the deleted file's number (inode), and only the inode was compared. Now the file's creation
563
+ time (when the system reports it) and its beginning also count, and reading restarts from the start of the new
564
+ file.
565
+ - On Windows, with Node 23 through 24.19, the `habblaud-permissoes` plugin's hook crashed on exit (code 0xC0000409, a
566
+ Node bug: nodejs/node#56645) right after receiving the office's answer. The decision arrived before the crash, but
567
+ without a decision (as in "Answer in the terminal") the session could log a hook error. Now the hook exits without
568
+ crashing.
569
+ - `npm install` changed `package-lock.json` (the repository's was out of date relative to `package.json`), and so the
570
+ next version's `git pull` stopped with "Your local changes … would be overwritten". Now the file stays identical.
571
+ Whoever already has the change runs `git checkout -- package-lock.json` once before `git pull`.
572
+ - On Windows, the mod did not record the 5-hour and weekly usage when `HOME` was not set (normal outside Git Bash):
573
+ now it uses `USERPROFILE`. And a `CLAUDE_CONFIG_DIR` with `\` (e.g. `C:\Users\you\.claude-conta2`) became an invalid
574
+ file name; now it gives the same account, including with Habblaud in Docker.
575
+
576
+ ## [0.4.0] - 2026-10-08
577
+
578
+ ### Changed
579
+
580
+ - **CodeTown is now called Habblaud.** The name changes everywhere: interface, logo, reception sign, entrance totem,
581
+ link preview, repository (`github.com/marmottajr/habblaud`), marketplace and Claude Code plugins (`habblaud` and
582
+ `habblaud-permissoes`, with the `/habblaud` command), environment variables (`HABBLAUD_*`), state folder
583
+ (`~/.habblaud`) and Docker (container and image `habblaud`, volume `habblaud-data`).
584
+ - For those coming from CodeTown: run `npm run mod:install` once (swaps the old marketplace and plugins for the new
585
+ ones in each account) and `npm run docker:up` (removes the old container and copies the names, timeline and
586
+ statistics from the `codetown_codetown-data` volume to the new one, without deleting the old one). The `~/.codetown`
587
+ folder and the preferences and coins saved in the browser move to the new names by themselves. The `CODETOWN_*`
588
+ variables no longer apply: rename them to `HABBLAUD_*` in `.env` (the server and `docker:up` warn). Details in the
589
+ README, under "Coming from CodeTown".
590
+
591
+ ## [0.3.2] - 2026-10-08
592
+
593
+ ### Fixed
594
+
595
+ - When a terminal closed and its room was dismantled, a garden was left in the middle of the building, between rooms.
596
+ Now the farthest room moves into the vacancy: it is assembled there, still dark; the first to arrive turns the light
597
+ on and each one returns to the same desk. The old address is erased and dismantled, and the building shrinks. A room
598
+ that opens takes the first free vacancy, and the initial load already comes without gaps.
599
+ - Anyone on the way to something that stopped existing, such as the water cooler of a hallway column that vanished
600
+ when the building shrank, was teleported. Now they change plan and keep walking.
601
+
602
+ ## [0.3.1] - 2026-10-08
603
+
604
+ ### Fixed
605
+
606
+ - Anyone dozing at their desk (idle for over 10 minutes) and getting up for a circle, a party or a stroll walked off
607
+ with the "zzz" over their head. Now the "zzz" only appears while the character sleeps.
608
+
609
+ ## [0.3.0] - 2026-10-08
610
+
611
+ ### Added
612
+
613
+ - **Habblaud mod for Claude Code** (2.1.287 or newer): `npm run mod:install` installs, in each account, this folder's
614
+ marketplace with the `habblaud` mod (live 5-hour and weekly usage, a line in the terminal when another session needs
615
+ you and the `/habblaud` command) and the `habblaud-permissoes` plugin (answer permissions through the office;
616
+ `-- --sem-permissoes` leaves it out). `npm run mod:status` shows what each account has and `npm run mod:uninstall`
617
+ removes everything. `npm run docker:up` updates the mod of those who already installed it.
618
+
619
+ ### Changed
620
+
621
+ - The statusline tap (`npm run usage:install`) and the permission hook (`npm run hooks:install`) become the old way,
622
+ for Claude Code before 2.1.287. `npm run mod:install` removes both from the account (with a backup), because the
623
+ mod does the same. The interface and the README now teach `npm run mod:install`.
624
+ - The permission hook script moved to `mod/habblaud-permissoes/hooks/permission-hook.mjs`. The old path
625
+ (`scripts/permission-hook.mjs`) became a shortcut, so whoever installed the hook before keeps working.
626
+ - In Accounts and usage, the source of the numbers says when they come from the mod ("live (Habblaud mod)").
627
+ - The live usage reader ignores a half-read file and keeps the last good number, instead of hiding the account for a
628
+ cycle.
629
+
630
+ ## [0.2.0] - 2026-10-08
631
+
632
+ First published version.
633
+
634
+ ### Added
635
+
636
+ - **Version and updates:** the version in use appears in the top bar and in Settings › About. Every 6 hours Habblaud
637
+ checks the releases on GitHub; when a new version comes out, the **New version** badge appears, with a notice and
638
+ the link to what changed. `HABBLAUD_UPDATE_CHECK=0` turns the check off.
639
+ - **My day** (M key): where the agents' time went, how long they waited for you, tokens and cost, with 30 days of
640
+ history.
641
+ - **GitHub in the office:** an open or merged PR and a published release become a party in the room; a red CI sets off
642
+ the alarm, until even a green CI.
643
+ - **Answer through the office** (P key): with the hook installed (`npm run hooks:install`), approve, decline or
644
+ "always allow" permission requests without going to the terminal. Only with local access.
645
+ - **Timelapse of the day** (L key): the office replays the day at high speed.
646
+ - **Read-only terminal** (T key): each agent's conversation, live, in Claude Code style, with search, filter, a copy
647
+ button and history of the last 7 days' sessions. Only with local access.
648
+ - **Day and night** by local time and **sounds** synthesized in the browser (off by default).
649
+ - **Social life:** whoever is idle joins circles (TV, video game, ping-pong, chat in the pantry, rock-paper-scissors
650
+ for coins), with personalities, friendships and rivalries.
651
+ - **Waiting on the shell:** the agent waiting on a long command stays at the desk with the hourglass, and the wait
652
+ becomes a gag.
653
+ - Session forks appear in the office.
654
+ - The open page reloads itself when the server starts serving another version.
655
+ - The container uses the computer's time zone.
656
+ - **The office:** each project open in Claude Code becomes a room and each session a character with its own name.
657
+ Subagents arrive, work and hand over to the main one. It shows the two accounts, with the 5-hour and weekly usage
658
+ of each (statusline tap), plus an activity feed, notices and demo mode. It runs on Node or in local Docker.
659
+
660
+ [1.0.3]: https://github.com/marmottajr/habblaud/compare/v1.0.2...v1.0.3
661
+ [1.0.2]: https://github.com/marmottajr/habblaud/compare/v1.0.1...v1.0.2
662
+ [1.0.1]: https://github.com/marmottajr/habblaud/compare/v1.0.0...v1.0.1
663
+ [1.0.0]: https://github.com/marmottajr/habblaud/compare/v0.11.0...v1.0.0
664
+ [0.11.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.11.0
665
+ [0.10.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.10.0
666
+ [0.9.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.9.0
667
+ [0.8.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.8.0
668
+ [0.7.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.7.0
669
+ [0.6.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.6.0
670
+ [0.5.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.5.0
671
+ [0.4.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.4.0
672
+ [0.3.2]: https://github.com/marmottajr/habblaud/releases/tag/v0.3.2
673
+ [0.3.1]: https://github.com/marmottajr/habblaud/releases/tag/v0.3.1
674
+ [0.3.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.3.0
675
+ [0.2.0]: https://github.com/marmottajr/habblaud/releases/tag/v0.2.0