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.
- package/.claude-plugin/marketplace.json +26 -0
- package/CHANGELOG.md +675 -0
- package/LICENSE +21 -0
- package/README.es.md +1457 -0
- package/README.fr.md +1435 -0
- package/README.md +1605 -2
- package/README.pt-BR.md +1373 -0
- package/dist/build.json +5 -0
- package/dist/cli/busybits.js +14708 -0
- package/dist/client/assets/art/framed/painting-abstract.png +0 -0
- package/dist/client/assets/art/framed/painting-beach.png +0 -0
- package/dist/client/assets/art/framed/painting-cat.png +0 -0
- package/dist/client/assets/art/framed/painting-city-night.png +0 -0
- package/dist/client/assets/art/framed/painting-mountains.png +0 -0
- package/dist/client/assets/art/framed/painting-rio.png +0 -0
- package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/framed/painting-wave.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/painting-abstract.png +0 -0
- package/dist/client/assets/art/painting-beach.png +0 -0
- package/dist/client/assets/art/painting-cat.png +0 -0
- package/dist/client/assets/art/painting-city-night.png +0 -0
- package/dist/client/assets/art/painting-mountains.png +0 -0
- package/dist/client/assets/art/painting-rio.png +0 -0
- package/dist/client/assets/art/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/painting-wave.png +0 -0
- package/dist/client/assets/art/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/poster-bug.png +0 -0
- package/dist/client/assets/art/poster-cat.png +0 -0
- package/dist/client/assets/art/poster-code.png +0 -0
- package/dist/client/assets/art/poster-coffee.png +0 -0
- package/dist/client/assets/art/poster-rocket.png +0 -0
- package/dist/client/assets/art/poster-ship-it.png +0 -0
- package/dist/client/assets/brand/apple-touch-icon.png +0 -0
- package/dist/client/assets/brand/favicon-16.png +0 -0
- package/dist/client/assets/brand/favicon-32.png +0 -0
- package/dist/client/assets/brand/icon-192.png +0 -0
- package/dist/client/assets/brand/icon-512.png +0 -0
- package/dist/client/assets/brand/logo-detailed.png +0 -0
- package/dist/client/assets/brand/logo-mark.png +0 -0
- package/dist/client/assets/brand/logo-mark@4x.png +0 -0
- package/dist/client/assets/brand/signage.png +0 -0
- package/dist/client/assets/brand/signage@4x.png +0 -0
- package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
- package/dist/client/assets/emoji/sheet.png +0 -0
- package/dist/client/assets/illustrations/empty-office.png +0 -0
- package/dist/client/assets/manifest.json +260 -0
- package/dist/client/assets/og-image.png +0 -0
- package/dist/client/bundle/app-AwZeKIeu.js +24 -0
- package/dist/client/bundle/app-CoDOLwxe.css +1 -0
- package/dist/client/bundle/city-DPTwQLdi.css +1 -0
- package/dist/client/bundle/city-YoIG0FsX.js +1 -0
- package/dist/client/bundle/daystats-DGzYOP8l.js +1 -0
- package/dist/client/bundle/dom-D2vx0KTo.js +1 -0
- package/dist/client/bundle/en-DBfNt5uV.js +169 -0
- package/dist/client/bundle/es-pnWdszTE.js +169 -0
- package/dist/client/bundle/format-C7qb6Cn-.js +1 -0
- package/dist/client/bundle/fr-CY8q9pj4.js +169 -0
- package/dist/client/bundle/main-DktU0GfB.js +2 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
- package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
- package/dist/client/bundle/ptypane-NIZ2Y8QM.js +16 -0
- package/dist/client/bundle/room-name-CFJfHE5L.js +1 -0
- package/dist/client/bundle/simulator-BnBPS_Ws.js +7 -0
- package/dist/client/bundle/world-model-BIYmgAWC.js +1 -0
- package/dist/client/bundle/world-stream-BRkL9Eme.js +1 -0
- package/dist/client/index.html +41 -0
- package/dist/client/manifest.webmanifest +17 -0
- package/dist/server/index.js +40327 -0
- package/mod/README.md +193 -0
- package/mod/habblaud/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud/hooks/hooks.json +4 -0
- package/mod/habblaud/hooks/register.ts +517 -0
- package/mod/habblaud-codex/hook.mjs +274 -0
- package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
- package/mod/habblaud-mensagens/hooks/register.ts +384 -0
- package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
- package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
- package/mod/habblaud-pi/core.ts +325 -0
- package/mod/habblaud-pi/extension.ts +119 -0
- package/mod/habblaud-pi/package.json +12 -0
- 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
|