@madarco/agentbox 0.1.0 → 0.3.0

package/dist/{lifecycle-P4FSKGR2-3466P54Y.js → lifecycle-YTMZYKOE-R4M3OR27.js}

@@ -13,10 +13,10 @@ import {
   startBox,
   stopBox,
   unpauseBox
-} from "./chunk-RWJE6AER.js";
+} from "./chunk-7NQFIBQG.js";
 import {
   SNAPSHOTS_ROOT
-} from "./chunk-O5HS3QHW.js";
+} from "./chunk-MOC54XL6.js";
 import "./chunk-IDR4HVIC.js";
 import "./chunk-SOMIKEN2.js";
 export {
@@ -35,4 +35,4 @@ export {
   stopBox,
   unpauseBox
 };
-//# sourceMappingURL=lifecycle-P4FSKGR2-3466P54Y.js.map
+//# sourceMappingURL=lifecycle-YTMZYKOE-R4M3OR27.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madarco/agentbox",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Launch Claude Code, Codex, and other coding agents in isolated sandboxes",
   "license": "MIT",
   "author": "Marco D'Alia",

package/runtime/docker/apps/cli/share/agentbox-setup/SKILL.md

@@ -149,13 +149,16 @@ services:
 1. Write the file to `/workspace/agentbox.yaml`.
 2. **Apply it live**: from inside the box run `agentbox-ctl reload`. The already-running supervisor re-reads the config and immediately runs the declared tasks and autostarts the services — no box restart needed. It prints the `added` / `removed` / `changed` diff. If it errors because the daemon isn't running, the config is still valid: the next `agentbox start` (or `agentbox create` in this workspace) picks it up automatically.
 3. Confirm with `agentbox-ctl status`: tasks should be `running` or `done`, autostart services `starting` or `ready`. If something failed, tail it with `agentbox-ctl logs <service>` and fix the config, then `agentbox-ctl reload` again.
-4. Tell the user:
+
+4. **Then do section 9** — once the box is warmed up (deps installed, services ready), checkpoint it with `agentbox-ctl checkpoint --set-default` so future boxes start ready. This is the real final step; don't stop at hand-off.
+
+5. Tell the user:
 
    > I wrote `/workspace/agentbox.yaml` and ran `agentbox-ctl reload` so the supervisor is already running the declared tasks/services. To land the file on the host:
+   > - I've created a checkpoint of the warm box state so future boxes start ready in seconds, no reinstall.
    > - commit it inside the box (`git add agentbox.yaml && git commit -m 'add agentbox config'`) — the box's `.git/` is bind-mounted, so the commit shows up on the host immediately; or
-   > - on the host, tell the user to run `agentbox pull config` to update their original host workspace. `agentbox pull env` if you also create env files.
+   > - on the host, tell the user to run `agentbox pull config` to update their original host workspace.
 
-5. **Then do section 9** — once the box is warmed up (deps installed, services ready), checkpoint it so future boxes start ready. This is the real final step; don't stop at hand-off.
 
 ## 9. Checkpoint the warm state (do this at the very end)
 
@@ -185,4 +188,5 @@ Then tell the user, e.g.:
 
 - For Nextjs/Vite/Tasnstack projects, makes sure to forward also websocket for hot reload.
 - **Turbo/Nx/Jest and other git-worktree-aware tools may try to write their cache to a read-only host path.** The box runs `/workspace` as a git worktree with the host repo's `.git/` bind-mounted at its absolute host path; tools that derive paths from git (Turbo's cache root = the worktree's git *common dir*) resolve outside `/workspace` and hit `EROFS` on the Mac path. Pin the cache into the writable overlay via the task/service `env:`, e.g. `TURBO_CACHE_DIR: /workspace/.turbo/cache` (or pass `--cache-dir`).
-- The `install` task is intentionally a no-op once `node_modules/.agentbox-installed` exists. Do **not** remove the marker guard to "force a fresh install" — that reinstalls on every box start. To force a one-off rebuild, delete `node_modules` (or just the marker) then run `agentbox-ctl reload`.
+- The `install` task is intentionally a no-op once `node_modules/.agentbox-installed` exists. Do **not** remove the marker guard to "force a fresh install" — that reinstalls on every box start. To force a one-off rebuild, delete `node_modules` (or just the marker) then run `agentbox-ctl reload`.
+- `.pnpm-store` default location is read only, so you need to point it to a writable location in the box's writable workspace eg: `PNPM_STORE: /workspace/.pnpm-store` and add `.pnpm-store/` to the `.gitignore` if the workspace root is git-tracked.

package/runtime/docker/packages/ctl/dist/bin.cjs

@@ -12017,6 +12017,17 @@ var import_node_child_process3 = require("child_process");
 
 // src/tmux.ts
 var import_node_child_process2 = require("child_process");
+var import_node_os = require("os");
+var MAX_TITLE_LEN = 120;
+function sanitizePaneTitle(raw, ctx) {
+  const t = raw.trim();
+  if (t.length === 0) return null;
+  const lower = t.toLowerCase();
+  if (ctx.hostname && lower === ctx.hostname.toLowerCase()) return null;
+  if (ctx.sessionName && lower === ctx.sessionName.toLowerCase()) return null;
+  if (["bash", "-bash", "sh", "-sh", "zsh", "-zsh", "tmux"].includes(lower)) return null;
+  return t.length > MAX_TITLE_LEN ? t.slice(0, MAX_TITLE_LEN) : t;
+}
 function runTool(cmd, args) {
   return new Promise((resolve) => {
     const child = (0, import_node_child_process2.spawn)(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
@@ -12030,7 +12041,8 @@ function runTool(cmd, args) {
 }
 async function probeClaudeSession(sessionName) {
   const has = await runTool("tmux", ["has-session", "-t", sessionName]);
-  if (has.exitCode !== 0) return { running: false, sessionName, startedAt: null };
+  if (has.exitCode !== 0)
+    return { running: false, sessionName, startedAt: null, title: null };
   const ts = await runTool("tmux", [
     "display-message",
     "-p",
@@ -12043,7 +12055,15 @@ async function probeClaudeSession(sessionName) {
     const secs = Number.parseInt(ts.stdout.trim(), 10);
     if (Number.isFinite(secs) && secs > 0) startedAt = new Date(secs * 1e3).toISOString();
   }
-  return { running: true, sessionName, startedAt };
+  const pt = await runTool("tmux", [
+    "display-message",
+    "-p",
+    "-t",
+    sessionName,
+    "#{pane_title}"
+  ]);
+  const title = pt.exitCode === 0 ? sanitizePaneTitle(pt.stdout, { hostname: (0, import_node_os.hostname)(), sessionName }) : null;
+  return { running: true, sessionName, startedAt, title };
 }
 
 // src/status-reporter.ts
@@ -12135,7 +12155,8 @@ var StatusReporter = class {
       claude: {
         state: this.claudeState,
         updatedAt: this.claudeUpdatedAt,
-        sessionRunning: session.running
+        sessionRunning: session.running,
+        ...session.title ? { sessionTitle: session.title } : {}
       }
     };
   }

package/share/agentbox-setup/SKILL.md

@@ -149,13 +149,16 @@ services:
 1. Write the file to `/workspace/agentbox.yaml`.
 2. **Apply it live**: from inside the box run `agentbox-ctl reload`. The already-running supervisor re-reads the config and immediately runs the declared tasks and autostarts the services — no box restart needed. It prints the `added` / `removed` / `changed` diff. If it errors because the daemon isn't running, the config is still valid: the next `agentbox start` (or `agentbox create` in this workspace) picks it up automatically.
 3. Confirm with `agentbox-ctl status`: tasks should be `running` or `done`, autostart services `starting` or `ready`. If something failed, tail it with `agentbox-ctl logs <service>` and fix the config, then `agentbox-ctl reload` again.
-4. Tell the user:
+
+4. **Then do section 9** — once the box is warmed up (deps installed, services ready), checkpoint it with `agentbox-ctl checkpoint --set-default` so future boxes start ready. This is the real final step; don't stop at hand-off.
+
+5. Tell the user:
 
    > I wrote `/workspace/agentbox.yaml` and ran `agentbox-ctl reload` so the supervisor is already running the declared tasks/services. To land the file on the host:
+   > - I've created a checkpoint of the warm box state so future boxes start ready in seconds, no reinstall.
    > - commit it inside the box (`git add agentbox.yaml && git commit -m 'add agentbox config'`) — the box's `.git/` is bind-mounted, so the commit shows up on the host immediately; or
-   > - on the host, tell the user to run `agentbox pull config` to update their original host workspace. `agentbox pull env` if you also create env files.
+   > - on the host, tell the user to run `agentbox pull config` to update their original host workspace.
 
-5. **Then do section 9** — once the box is warmed up (deps installed, services ready), checkpoint it so future boxes start ready. This is the real final step; don't stop at hand-off.
 
 ## 9. Checkpoint the warm state (do this at the very end)
 
@@ -185,4 +188,5 @@ Then tell the user, e.g.:
 
 - For Nextjs/Vite/Tasnstack projects, makes sure to forward also websocket for hot reload.
 - **Turbo/Nx/Jest and other git-worktree-aware tools may try to write their cache to a read-only host path.** The box runs `/workspace` as a git worktree with the host repo's `.git/` bind-mounted at its absolute host path; tools that derive paths from git (Turbo's cache root = the worktree's git *common dir*) resolve outside `/workspace` and hit `EROFS` on the Mac path. Pin the cache into the writable overlay via the task/service `env:`, e.g. `TURBO_CACHE_DIR: /workspace/.turbo/cache` (or pass `--cache-dir`).
-- The `install` task is intentionally a no-op once `node_modules/.agentbox-installed` exists. Do **not** remove the marker guard to "force a fresh install" — that reinstalls on every box start. To force a one-off rebuild, delete `node_modules` (or just the marker) then run `agentbox-ctl reload`.
+- The `install` task is intentionally a no-op once `node_modules/.agentbox-installed` exists. Do **not** remove the marker guard to "force a fresh install" — that reinstalls on every box start. To force a one-off rebuild, delete `node_modules` (or just the marker) then run `agentbox-ctl reload`.
+- `.pnpm-store` default location is read only, so you need to point it to a writable location in the box's writable workspace eg: `PNPM_STORE: /workspace/.pnpm-store` and add `.pnpm-store/` to the `.gitignore` if the workspace root is git-tracked.