busybits 0.0.0-stage → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/.claude-plugin/marketplace.json +26 -0
  2. package/CHANGELOG.md +692 -0
  3. package/LICENSE +21 -0
  4. package/README.es.md +1457 -0
  5. package/README.fr.md +1435 -0
  6. package/README.md +1623 -2
  7. package/README.pt-BR.md +1373 -0
  8. package/dist/build.json +5 -0
  9. package/dist/cli/busybits.js +14724 -0
  10. package/dist/client/assets/art/framed/painting-abstract.png +0 -0
  11. package/dist/client/assets/art/framed/painting-beach.png +0 -0
  12. package/dist/client/assets/art/framed/painting-cat.png +0 -0
  13. package/dist/client/assets/art/framed/painting-city-night.png +0 -0
  14. package/dist/client/assets/art/framed/painting-mountains.png +0 -0
  15. package/dist/client/assets/art/framed/painting-rio.png +0 -0
  16. package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
  17. package/dist/client/assets/art/framed/painting-wave.png +0 -0
  18. package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
  19. package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
  20. package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
  21. package/dist/client/assets/art/painting-abstract.png +0 -0
  22. package/dist/client/assets/art/painting-beach.png +0 -0
  23. package/dist/client/assets/art/painting-cat.png +0 -0
  24. package/dist/client/assets/art/painting-city-night.png +0 -0
  25. package/dist/client/assets/art/painting-mountains.png +0 -0
  26. package/dist/client/assets/art/painting-rio.png +0 -0
  27. package/dist/client/assets/art/painting-sunflowers.png +0 -0
  28. package/dist/client/assets/art/painting-wave.png +0 -0
  29. package/dist/client/assets/art/painting-wide-aurora.png +0 -0
  30. package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
  31. package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
  32. package/dist/client/assets/art/poster-bug.png +0 -0
  33. package/dist/client/assets/art/poster-cat.png +0 -0
  34. package/dist/client/assets/art/poster-code.png +0 -0
  35. package/dist/client/assets/art/poster-coffee.png +0 -0
  36. package/dist/client/assets/art/poster-rocket.png +0 -0
  37. package/dist/client/assets/art/poster-ship-it.png +0 -0
  38. package/dist/client/assets/brand/apple-touch-icon.png +0 -0
  39. package/dist/client/assets/brand/favicon-16.png +0 -0
  40. package/dist/client/assets/brand/favicon-32.png +0 -0
  41. package/dist/client/assets/brand/icon-192.png +0 -0
  42. package/dist/client/assets/brand/icon-512.png +0 -0
  43. package/dist/client/assets/brand/logo-detailed.png +0 -0
  44. package/dist/client/assets/brand/logo-mark.png +0 -0
  45. package/dist/client/assets/brand/logo-mark@4x.png +0 -0
  46. package/dist/client/assets/brand/signage.png +0 -0
  47. package/dist/client/assets/brand/signage@4x.png +0 -0
  48. package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
  49. package/dist/client/assets/emoji/sheet.png +0 -0
  50. package/dist/client/assets/illustrations/empty-office.png +0 -0
  51. package/dist/client/assets/manifest.json +260 -0
  52. package/dist/client/assets/og-image.png +0 -0
  53. package/dist/client/bundle/app-CoDOLwxe.css +1 -0
  54. package/dist/client/bundle/app-QYGBa260.js +24 -0
  55. package/dist/client/bundle/city-DPTwQLdi.css +1 -0
  56. package/dist/client/bundle/city-UYDbxWIy.js +1 -0
  57. package/dist/client/bundle/daystats-CJyNq6hu.js +1 -0
  58. package/dist/client/bundle/dom-slmnBOjx.js +1 -0
  59. package/dist/client/bundle/en-BQQEHqmG.js +169 -0
  60. package/dist/client/bundle/es-BgBoKwEe.js +169 -0
  61. package/dist/client/bundle/format-CvlPqloO.js +1 -0
  62. package/dist/client/bundle/fr-PI_gjIFq.js +169 -0
  63. package/dist/client/bundle/main-DTHUta25.js +2 -0
  64. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
  65. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
  66. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
  67. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
  68. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
  69. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
  70. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
  71. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
  72. package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
  73. package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
  74. package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
  75. package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
  76. package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
  77. package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
  78. package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
  79. package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
  80. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
  81. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
  82. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
  83. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
  84. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
  85. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
  86. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
  87. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
  88. package/dist/client/bundle/ptypane-9pL54zR0.js +16 -0
  89. package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
  90. package/dist/client/bundle/room-name-Bv6N672f.js +1 -0
  91. package/dist/client/bundle/simulator-B45JPgSp.js +7 -0
  92. package/dist/client/bundle/world-model-BgjMjmrp.js +1 -0
  93. package/dist/client/bundle/world-stream-CUfry7aL.js +1 -0
  94. package/dist/client/index.html +41 -0
  95. package/dist/client/manifest.webmanifest +17 -0
  96. package/dist/server/index.js +40342 -0
  97. package/mod/README.md +193 -0
  98. package/mod/habblaud/.claude-plugin/plugin.json +11 -0
  99. package/mod/habblaud/hooks/hooks.json +4 -0
  100. package/mod/habblaud/hooks/register.ts +517 -0
  101. package/mod/habblaud-codex/hook.mjs +274 -0
  102. package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
  103. package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
  104. package/mod/habblaud-mensagens/hooks/register.ts +384 -0
  105. package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
  106. package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
  107. package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
  108. package/mod/habblaud-pi/core.ts +325 -0
  109. package/mod/habblaud-pi/extension.ts +119 -0
  110. package/mod/habblaud-pi/package.json +12 -0
  111. package/package.json +100 -4
package/mod/README.md ADDED
@@ -0,0 +1,193 @@
1
+ # Busybits plugins for Claude Code
2
+
3
+ The repository is also a Claude Code plugin marketplace: `.claude-plugin/marketplace.json` (at the root)
4
+ lists the `busybits` marketplace with three plugins, each in a folder here: the `busybits` mod (observe-only; it lives in the `mod/habblaud` folder),
5
+ `busybits-permissions` (answer permission requests from the office; `mod/habblaud-permissoes`) and `busybits-messages` (send messages from the
6
+ office; `mod/habblaud-mensagens`). `npm run mod:install` installs all three; `--sem-permissoes` and `--sem-mensagens` leave theirs out.
7
+ Versions follow `package.json` (the test `server/test/mod.test.ts` fails if they diverge).
8
+
9
+ Tested with **Claude Code 2.1.293** (`busybits-messages`, for now only through `claude plugin test` on
10
+ 2.1.295). Mods (TypeScript hooks loaded by Claude Code itself) exist from 2.1.287 on; the API is still
11
+ "early access" and may change between versions. On older versions, use the usual installers
12
+ (`npm run usage:install` and `npm run hooks:install`); sending messages from the office only exists with the mod.
13
+ Installation is covered in the main README.
14
+
15
+ ## `busybits` — the mod
16
+
17
+ `habblaud/hooks/register.ts`, a single module, no build. It connects each session to the office without reading the conversation:
18
+
19
+ - **Plan usage (5h and weekly):** at session start and on every `session.measure` (after each turn and when
20
+ a limit moves by a point) it reads `$.session.usage().rateLimits` and writes `~/.habblaud/usage/<account>.json` (or to
21
+ `HABBLAUD_USAGE_DIR`) in the same format as the statusline tap, plus `"source": "mod"`. It replaces
22
+ `npm run usage:install`: your statusline is left untouched. The account is the `CLAUDE_CONFIG_DIR` folder (the first
23
+ item) or `~/.claude` (`~` is `HOME`; on Windows without it, `USERPROFILE`). Identical values written less than
24
+ 10 s ago are not rewritten; a write failure is silent.
25
+ - **"Needs you" under the prompt:** every 5 s it asks the local Busybits
26
+ (`GET http://127.0.0.1:<HABBLAUD_PORT or 4747>/api/mod/summary`) who is waiting, already excluding this session and its
27
+ subagents, and shows `🏢 Valentina needs you in loja-virtual` or
28
+ `🏢 2 need you: Valentina (loja-virtual), Elias (app-mobile)` (up to 3 names, then "and N more").
29
+ Nobody waiting or Busybits down: the line disappears; while it is down, the polling drops to every 30 s until
30
+ it is back. Only in sessions that draw a UI (`claude -p` asks nothing).
31
+ - **`/busybits`:** a summary of the whole office, answered by the mod itself (it does not call the model and spends no usage):
32
+
33
+ ```
34
+ Busybits 2.0.1 at http://localhost:4747
35
+ 7 agents · 3 working · 2 need you
36
+ ✋ Valentina (loja-virtual): approve a permission · you can answer from the office
37
+ ✋ Elias (app-mobile): answer in the terminal
38
+ ```
39
+
40
+ When Busybits is down: `Busybits did not answer at http://localhost:4747. To start it: npm run docker:up in the Busybits folder.`
41
+
42
+ ### Language
43
+
44
+ Everything the mod writes (the line under the prompt, the `/busybits` answer and its description, the offline and
45
+ outdated messages) comes out in English, Spanish, Portuguese or French, with singular and plural forms. The mod picks
46
+ the language from the session environment, because the engine interface (`$`) does not expose Claude Code's own
47
+ `language` setting: `HABBLAUD_LANG` first (the same override the server uses), then `LC_ALL`, `LC_MESSAGES`, `LANG`
48
+ and `LANGUAGE`, skipping values it does not translate (`C`, `POSIX`, `de_DE`). With none of them set, it is English.
49
+ Text that comes from the server (the reason an agent is waiting) keeps the server's own language.
50
+
51
+ ### Renamed from `habblaud` (up to 1.0.3)
52
+
53
+ The plugin id is now `busybits@busybits`, in a marketplace named `busybits` (it was `habblaud`). `npm run mod:install`
54
+ removes every `*@habblaud` plugin and the `habblaud` marketplace in each account before adding `busybits`, and
55
+ `npm run mod:uninstall` removes both generations. A packaged install (`busybits setup`) does the same switch, pointing the marketplace at `~/.busybits/marketplace`; until then `npm run mod:status` and `docker:up` report the old name.
56
+
57
+ ### What it accesses
58
+
59
+ Output of `claude plugin validate --strict mod/habblaud` (the static analysis Claude Code runs before
60
+ loading the module; nothing outside this list is called):
61
+
62
+ ```
63
+ ❯ ./register.ts hooks: session.start, session.measure, command.run{command=busybits}
64
+ ❯ ./register.ts answers its own command: command.run{command=busybits}
65
+ ❯ ./register.ts calls: $.clock.after (via askBusybits), $.clock.every (via schedule), $.clock.now (via writeUsage), $.command.register, $.env.get (via readEnv), $.fs.write (via writeUsage), $.http.fetch (via askBusybits), $.session.id (via poll), $.session.surfaces (via poll), $.session.usage, $.ui.status (via setStatus)
66
+ ❯ ./register.ts env writes: nothing
67
+ ❯ ./register.ts env reads: CLAUDE_CONFIG_DIR, HABBLAUD_LANG, HABBLAUD_PORT, HABBLAUD_USAGE_DIR, HOME, LANG, LANGUAGE, LC_ALL, LC_MESSAGES, USERPROFILE
68
+ ```
69
+
70
+ In plain words: it only observes (no hook decides anything: it does not approve tools, change prompts or read messages),
71
+ writes a single file (the usage one), talks only to `127.0.0.1` and reads ten environment variables. `$.clock.after` is the
72
+ 2 s deadline of each question to Busybits (`$.http.fetch` does not accept an AbortSignal).
73
+
74
+ ## `busybits-permissions` — answer permissions from the office
75
+
76
+ A regular `PermissionRequest` hook (no mod), in `habblaud-permissoes/hooks/hooks.json`:
77
+
78
+ ```json
79
+ { "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/permission-hook.mjs\"", "timeout": 86430, "statusMessage": "Aguardando resposta no Busybits" }] }
80
+ ```
81
+
82
+ The `hooks/permission-hook.mjs` script is the same one `npm run hooks:install` installs (single source; plain Node, only
83
+ `node:*`, because Claude Code copies only the plugin folder into its cache). It sends the request to the local Busybits
84
+ and waits for the answer for up to 5 min; the dialog stays in the terminal and whatever you answer first wins. Without
85
+ Busybits running, or without any open page, it exits immediately. Port: `HABBLAUD_PORT` (default 4747); wait:
86
+ `HABBLAUD_PERMISSION_TIMEOUT` (default 300 s, up to 86400 s = 24 h; the hook timeout in the plugin is 86430 s). To approve
87
+ from your phone while away from the computer, put `"env": { "HABBLAUD_PERMISSION_TIMEOUT": "86400" }` in the account's
88
+ `settings.json`: it applies to sessions opened afterwards. Background subagents only show the dialog once the hook finishes,
89
+ which is why the default stays at 5 min. Requires `node` 22+ on the session's `PATH`.
90
+
91
+ `claude plugin validate --strict mod/habblaud-permissoes`: `✔ Validation passed` (the validator also checks the
92
+ `hooks.json` schema).
93
+
94
+ ## `busybits-messages` — messages from the office
95
+
96
+ `habblaud-mensagens/hooks/register.ts`, a single module, no build. It brings into the session what you type in the office
97
+ (in the agent panel or in the terminal opened with the T key), as if you had typed it in the terminal:
98
+
99
+ - **Polling:** every 2 s, only in sessions that draw a UI (`claude -p` asks nothing),
100
+ `POST http://127.0.0.1:<HABBLAUD_PORT or 4747>/api/mod/inbox` with `{session, account}`. The request also marks the
101
+ session as present: that is what shows the agent's message box on the page (without the plugin, the page shows a hint
102
+ to install it). When Busybits is down, or answers something else (403 with messages turned off, 404 on a version without the
103
+ route), it polls every 30 s until it is back.
104
+ - **Delivery:** each message, in order, goes through `$.prompt.submit({ text, asUser: true })`. The model reads the text as
105
+ yours, without the "The busybits-messages plugin sent a message" prefix (the session log still says it came from the plugin), and the
106
+ text goes exactly as typed. If the session is in the middle of a turn, Claude Code holds the prompt and runs it
107
+ in a turn of its own when the current one ends (a plugin prompt never enters mid-turn, the way a typed one
108
+ can). A hook that refuses the message (`{drop}`) or an exception becomes a failure, with the reason, on the page.
109
+ - **Slash commands:** a message that starts with `/name arguments`, with `name` in the `$.command.list()` list,
110
+ runs through `$.command.run({ command, args })` instead of `$.prompt.submit` (Claude Code refuses any text that starts with `/`
111
+ in `$.prompt.submit`), and the outcome (ok or the error) follows in the acknowledgement. With the list unavailable, the decision is
112
+ left to `$.command.run`, which rejects unknown names. Text that starts with `/` and is not a session command
113
+ (`/etc/hosts`, a typo) fails with the reason, without reaching the session. The same list goes to Busybits in
114
+ `POST /api/mod/commands` with `{session, account, commands: [{name, description, source, plugin?}]}`, only when it changes
115
+ and once a minute (Busybits may have restarted): it feeds the box's autocomplete. Commands that
116
+ open an interactive menu (`/model` without an argument, `/config`) have nothing to show in the office: pass arguments or
117
+ use the terminal. The text the command prints does not come back to the page.
118
+ - **Acknowledgement:** a `POST /api/mod/inbox/ack` with the result of each one (`{session, results: [{id, ok, error?}]}`).
119
+ Waiting for a message (or command) takes at most 2 s: past that, the session is busy, the message is in its queue and
120
+ counts as delivered (the following ones go right after, in order). This way a round never takes more than a few seconds and
121
+ the server's presence (10 s) and confirmation (30 s) windows do not expire while the session is busy; the price is that a refusal
122
+ after those 2 s does not reach the page.
123
+
124
+ It is kept separate from the `busybits` mod on purpose: that one only observes; this one acts, typing into the session on your behalf. To
125
+ go without it: `npm run mod:install -- --sem-mensagens` (one already installed stays; to remove it:
126
+ `claude plugin uninstall busybits-messages@busybits`). `npm run docker:up` updates the plugin for accounts that already have it,
127
+ but does not install it by itself: on an account with the mod and without it, it only hints to run `npm run mod:install`.
128
+
129
+ ### What it accesses
130
+
131
+ Output of `claude plugin validate --strict mod/habblaud-mensagens`:
132
+
133
+ ```
134
+ ❯ ./register.ts hooks: session.start
135
+ ❯ ./register.ts calls: $.clock.after (via waitAtMost), $.clock.every (via schedule), $.clock.now (via publishCommands), $.command.list (via listCommands), $.command.run (via runOne), $.env.get (via readEnv), $.http.fetch (via postJson), $.prompt.submit (via submitOne), $.session.id (via round), $.session.surfaces (via round)
136
+ ❯ ./register.ts env writes: nothing
137
+ ❯ ./register.ts env reads: CLAUDE_CODE_ENTRYPOINT, CLAUDE_CONFIG_DIR, HABBLAUD_PORT, HOME, USERPROFILE
138
+ ```
139
+
140
+ In plain words: a single hook (`session.start`, which starts the round clock); the only actions on the session are
141
+ `$.prompt.submit` for messages and `$.command.run` for the slash commands you send (`$.command.list` only reads the
142
+ command names and descriptions to publish them); it does not read the conversation, does not write any file, talks only to `127.0.0.1` and reads four
143
+ environment variables (the account comes from `CLAUDE_CONFIG_DIR`, as in the mod). `$.clock.after` is the 2 s deadline of each
144
+ request to Busybits, and of each `$.prompt.submit`, `$.command.run` and `$.command.list`.
145
+
146
+ Port: `HABBLAUD_PORT` (default 4747). Requires Claude Code 2.1.287+ and a Busybits with messages turned on: the
147
+ same lock as the terminal and permissions (port bound to `127.0.0.1` and a local Host header) and `HABBLAUD_MENSAGENS`
148
+ not turned off (`0`, `false`, `off` or `no` turn it off). Any process on this machine that talks to Busybits
149
+ can send a message to the sessions that have the plugin: that is why the lock is local.
150
+
151
+ ## `habblaud-pi` — Gentle Shell and Pi
152
+
153
+ Not a Claude Code plugin: it is a Pi extension (`habblaud-pi/extension.ts`, TypeScript loaded by Pi itself, no
154
+ build; the testable logic is in `core.ts`, with no Pi dependency). Installation: `npm run pi:install` (or `npm run setup`),
155
+ which adds the `mod/habblaud-pi` folder to `packages` in the `settings.json` of `~/.gentle-shell/agent` and of `~/.pi/agent`
156
+ (what `pi install <folder>` does; with a backup, idempotent, without touching `auth.json` or `mcp*.json`);
157
+ `npm run pi:status` and `npm run pi:uninstall` complete the set. Open sessions must be reopened (or run `/reload` in Pi).
158
+
159
+ - **Messages:** the same protocol as `busybits-messages` (`/api/mod/inbox`, `/ack` and `/commands`), only in sessions with a UI
160
+ (`ctx.mode === "tui"`; subagents, `-p` and RPC fetch nothing). Delivery uses `pi.sendUserMessage`: an idle session receives
161
+ it right away and, in the middle of a turn, the message enters as a `followUp`. A `/command` from the `pi.getCommands()` list (extensions,
162
+ prompt templates and skills) runs with `expandPromptTemplates`; any other `/...` fails with the reason (Pi's built-in commands
163
+ only run in the terminal).
164
+ - **Needs you:** Pi emits `ui_prompt_start` / `ui_prompt_end` (type and title) when an extension opens a blocking
165
+ box. The gentle-pi guard asks with `ctx.ui.confirm("Allow guarded git push?", <command preview>)`
166
+ (`extensions/gentle-ai.ts`, `confirmCommand`) and also emits `pi-permission-system:permission-request` (without the
167
+ command). While the agent is working, the extension tells Busybits (`POST /api/permissions` with `answerable: false`, the
168
+ command taken from the open tool call) and releases the notice when the box closes.
169
+ **Answering from the office is not possible safely:** the events only observe, `confirm` is resolved by the
170
+ terminal UI and Pi does not expose a way to answer another extension's box; the only way out would be to replace
171
+ `ctx.ui.confirm` from the inside, which changes the guard's semantics (the decision would come from somewhere other than the
172
+ terminal box). That is why the office shows that the agent is waiting, with the command, and the answer stays in the terminal.
173
+ - **What it accesses:** `127.0.0.1:<HABBLAUD_PORT or 4747>` (no other destination), the variables `HABBLAUD_PORT`, `HABBLAUD_PI`
174
+ (`0`, `false`, `off` or `no` turn it off) and `GENTLE_PI_AGENTS_CHILD`; it does not read the conversation, does not write files, and does not block or
175
+ decide any tool call (the `tool_call` handler only observes).
176
+ - Tests: `server/sources/gentle-shell/pi-extension.test.ts` (core and extension against a real Busybits, with a fake
177
+ Pi), `pi-install.test.ts` and `setup.test.ts` (fake HOME).
178
+
179
+ ## Development
180
+
181
+ ```bash
182
+ claude --plugin-dir mod/habblaud # loads the mod in a session, without installing (reloads on save)
183
+ claude -p "/busybits" --plugin-dir mod/habblaud # tests the command without an interactive session (does not call the model)
184
+ cd mod/habblaud && claude plugin test # mod tests (tests/*.test.ts), no session, login or network
185
+ cd mod/habblaud-mensagens && claude plugin test # same for the messages plugin
186
+ claude plugin validate --strict mod/habblaud # static analysis + manifest (same for the other folders and .)
187
+ npx tsc -p mod/habblaud # types (after loading the mod once with --plugin-dir)
188
+ ```
189
+
190
+ When loading a mod, Claude Code writes the types of the installed version to `<folder>/.claude-plugin/types/` and a
191
+ `<folder>/tsconfig.json` that extends them; both are generated and kept out of git (`mod/.gitignore`). The mod tests
192
+ import `claude-code/testing` and only run through `claude plugin test`: `npm test` (vitest) and
193
+ `npm run typecheck` do not look at this folder.
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "busybits",
3
+ "displayName": "Busybits",
4
+ "version": "2.0.1",
5
+ "description": "Connects the session to Busybits: records plan usage (5h and weekly) for the office, shows a line under the prompt when another session needs you, and adds the /busybits command.",
6
+ "author": { "name": "Márcio Junior", "url": "https://github.com/marmottajr" },
7
+ "homepage": "https://github.com/marmottajr/habblaud#readme",
8
+ "repository": "https://github.com/marmottajr/habblaud",
9
+ "license": "MIT",
10
+ "keywords": ["busybits", "habblaud", "escritorio", "uso", "rate-limits", "status"]
11
+ }
@@ -0,0 +1,4 @@
1
+ {
2
+ "description": "Busybits mod hooks module (plan usage, line under the prompt and /busybits)",
3
+ "modules": ["./register.ts"]
4
+ }