@madarco/agentbox 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+All notable changes to `@madarco/agentbox` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Entries are generated from the commit history with `/release-notes` and then
+hand-reviewed — they describe what changed for someone using the `agentbox`
+CLI, not the raw commits.
+
+## [0.10.0] - 2026-05-30
+
+### Breaking
+
+- `agentbox browser` is renamed to `agentbox url` (it opens the box's web-app
+  URL). No alias is kept.
+- `agentbox list --all` / `-a` is renamed to `--global` / `-g`, matching the
+  npm/pnpm convention. The old form is removed with no alias — update any
+  scripts that used it.
+
+### Added
+
+- `agentbox install` is now an interactive setup wizard (system compatibility
+  check, provider picker, login/prepare hints, host `/agentbox` skill install)
+  and a new `agentbox doctor` reports the same checks in full detail. The wizard
+  auto-runs once on first use; `--skills-only` keeps the old host-skill-only
+  behavior.
+- Portless integration on Docker Desktop: boxes can get a stable
+  `https://<box-name>.localhost` URL for their web app via the
+  [Portless](https://portless.sh) proxy. Opt-in on first run (saved to the new
+  `portless.enabled` config key; `--portless` / `--no-portless` flags). The same
+  URL works from the host and from inside the box's VNC browser.
+- Cloud boxes now offer to sign you in before the box starts when agent
+  credentials are missing or expired, seeding the login into this box and every
+  future one (Claude, Codex, OpenCode).
+- Attach now survives a box reboot: the wrapper stays open and auto-reconnects
+  once the box is back, so a Vercel checkpoint or restart no longer drops your
+  session.
+- `agentbox url` and `agentbox screen` reach an in-box web service on Vercel —
+  the in-box proxy binds to the always-exposed port 8080, and `url` falls back to
+  the first exposed service port when no proxy is configured.
+- `agentbox list --live` forces a real state probe of cloud boxes; by default
+  `list` now reads persisted box state, so it's fast even with several boxes.
+- A 3-line alert band above the footer surfaces relay confirm prompts,
+  checkpoint notices, and the agent's questions without hiding the status bar —
+  in both the single-attach TUI and the dashboard.
+- Agents skip their interactive permission prompts by default inside boxes
+  (boxes are already isolated). Controlled by `claude.dangerouslySkipPermissions`
+  / `codex.dangerouslySkipPermissions` (both default on); override per-box with
+  `--no-dangerously-skip-permissions`.
+
+### Changed
+
+- `Ctrl+a` leader chords are now mnemonic and consistent across the agent/shell
+  footers and the dashboard: `s` opens the noVNC screen, `u` opens the web-app
+  URL, `d` detaches. The dashboard keeps `Ctrl+a q` to quit and moves "stop the
+  box" to `Ctrl+a t`.
+- A Vercel checkpoint reboots the box, so it now asks for confirmation first
+  (skip with `-y`).
+- Chromium is baked into the Vercel base snapshot at `prepare` time, so
+  agent-browser is ready immediately on every box instead of installing on each
+  create.
+- The host relay is now a version-consistent global singleton shared by all
+  boxes, robust to mismatched `npx` caches.
+- Faster dashboard switching on the Vercel provider; install-wizard copy and
+  progress animation polished.
+
+### Fixed
+
+- The cloud login offer runs in the default docker image instead of a cloud
+  snapshot ref, fixing a `docker build` failure on `snap_…` image names.
+- `agentbox list` shows the real state of cloud boxes (stopped/paused) instead
+  of always reporting `running`.
+- Resuming a cloud box re-ensures its daemons and declared services, and a
+  stopped cloud box is resumed before attach instead of failing.
+- Hetzner box creation waits for SSH to be ready before returning, so the next
+  command no longer races a not-yet-reachable VPS.
+- The published npm package now includes the repo README.
+- `Ctrl+c` during the startup banner animation exits cleanly.
+- Skip-permissions conflict detection now also matches inline `--flag=value`
+  syntax, so an explicit user choice always wins; background-queue jobs honor
+  `--no-dangerously-skip-permissions`.
+- The footer spinner keeps animating when the alert band collapses on a tiny
+  terminal.
+
+## [0.9.0] - 2026-05-29
+
+First release with a tracked changelog. Earlier history lives in the git log.

package/README.md

@@ -0,0 +1,161 @@
+<h1 style="font-weight:normal">
+  AgentBox&nbsp;
+  <a href="https://github.com/madarco/agentbox/blob/main/LICENSE"><img src="https://img.shields.io/github/license/madarco/agentbox.svg?colorB=ff0000"></a>
+  <a href="https://www.npmjs.com/package/@madarco/agentbox"><img src="https://img.shields.io/npm/d18m/%40madarco%2Fagentbox?label=npm" /></a>
+  <img src="https://img.shields.io/github/stars/madarco/agentbox" />
+</h1>
+
+Run multiple agents in parallel, with a single command, on your PC, self-hosted, or in the cloud
+<br>
+
+<p align="center">
+
+![AgentBox](https://raw.githubusercontent.com/madarco/agentbox/main/docs/cover.jpg)
+</p>
+
+## How it works
+
+```sh
+agentbox claude # launch a new VM with claude and your project inside
+```
+
+- 📦 **Teleport** - Move your project to a dedicated VM, local or in the cloud, with a single command.
+- 🤖 **Automatic** - Bring all your skills, plugins, and settings for **Claude Code**, **Codex**, **Open Code**
+- 🌐 **A full Computer** — Dedicated browser, screen sharing, persistent shells and warmed up VS Code / Cursor IDE, with each box.
+- 💾 **Checkpoints** — Sub <1s startup of new boxes from a previous checkpoint, auto pause to save cost/resources when not in use.
+- 🔒 **Safe** - Your git credentials are kept on your local machine, with permission requests to push to the remote repository.
+
+
+### Complete setup:
+
+```sh
+npm -g install @madarco/agentbox
+agentbox install
+
+# Launch a new VM with claude, copy all your settings and workspace
+agentbox claude
+
+# Also install required project libraries and launch your dev server
+> Run setup wizard? -> Yes
+
+# Also use a cloud:
+agentbox hetzner claude # or vercel, daytona
+
+# Ctrl+a d to detach, claude keep going, to reconnect later:
+agentbox claude attach 1
+
+# To open a persistent shell inside the box:
+agentbox shell 1
+
+# Create a second box:
+agentbox claude
+agentbox claude attach 2
+agentbox shell 2
+
+# Open your web project on a .local url tunnel on your pc
+agentbox url 2
+# Or the in-box browser via webVNC:
+agentbox screen 2
+# Or connect to vscode/cursor inside the box:
+agentbox code 2
+
+# See status and quickly switch between agents:
+agentbox dashboard
+```
+
+## Demo
+
+![AgentBox demo](docs/demo.gif)
+
+## Install
+
+```sh
+npm -g install @madarco/agentbox
+```
+
+Requirements: macOS (arm64 or Intel) or Linux, Docker ([Docker Desktop](https://www.docker.com/products/docker-desktop/) or [OrbStack](https://orbstack.dev/)), Node `>=20.10`. The first `agentbox create` / `agentbox claude` builds the `agentbox/box:dev` image (~1 GB, one-time).
+Uses `portless` to give box web apps the same URL from inside the box and on the host.
+
+## Cloud Providers
+
+|                     | local docker              | hetzner                | daytona            | vercel            |
+| ------------------- | ------------------------- | ---------------------- | ------------------ | ------------------ |
+| Support             | ✅                        | ✅                     | ⚠️ Partial         | ✅                 |
+| Base image          | Dockerfile                | Setup script (Ubuntu)  | Dockerfile         | Setup script       |
+| Live snapshots      | ✅                        | ✅                     | 🧪 Experimental    | ✅                 |
+| Private preview URLs| ✅ (portless or OrbStack) | ✅ (portless)          | ✅ (native)        | ✅ (native)        |
+
+**Cloud setup** (optional — skip for local Docker)
+
+- `agentbox install` — interactive setup wizard to choose which providers to use and configure them.
+- `agentbox vercel login` — interactive Vercel Sandbox token setup, saved to `~/.agentbox/secrets.env`
+- `agentbox hetzner login` — interactive Hetzner Cloud token setup, saved to `~/.agentbox/secrets.env`
+- `agentbox daytona login` — interactive Daytona API key setup, saved to `~/.agentbox/secrets.env`
+- `agentbox prepare [--provider daytona|hetzner]` — build the image and initial snapshot
+- `agentbox hetzner claude`, `agentbox hetzner codex`, `agentbox hetzner create`, etc.
+
+## How to use
+
+`<box>` is optional almost everywhere — it defaults to the box for the current project, or use its short index (`1`, `2`, …), name, or id prefix.
+
+**Create & run**
+
+- `agentbox create` — Create and start a new agent box (Docker container with FUSE overlay)
+- `agentbox claude` — Create a sandboxed box and launch Claude Code in a detachable tmux session
+
+**Access**
+
+- `agentbox url` — Open a box's web app URL in the browser (even with no `expose:` service)
+- `agentbox screen` — Open a box's VNC (noVNC) viewer in the browser
+- `agentbox code` — Open a box in VS Code or Cursor via the Dev Containers extension
+- `agentbox shell` — Open an interactive bash shell in a box
+- `agentbox open` — Open a box's merged workspace in Finder
+- `agentbox logs` — Print recent log lines from a box service; `-f` to stream
+- `agentbox dashboard` — Box list + the selected box's live agent session
+
+**Inspect**
+
+- `agentbox list` (`ls`) — List boxes in current project or `-g` for all
+- `agentbox status` — Show service + task status from a box's `agentbox-ctl` daemon
+- `agentbox top` — Live resource monitor (cpu/mem/pids/disk) for a box, project, or all boxes
+
+**Lifecycle**
+
+- `agentbox start` — Start a stopped box (docker start + re-mount the FUSE overlay)
+- `agentbox stop` — Stop a box (preserves the upper volume, `node_modules` included)
+- `agentbox destroy` (`rm`) — Destroy a box and discard its upper volume
+- `agentbox pause` / `agentbox unpause` — Freeze / resume a box (sub-second)
+
+**Sync & state**
+
+- `agentbox download` — Download a box's `/workspace` back into your host workspace (gitignore-aware)
+- `agentbox cp <src> [dst]` — Copy individual files between host and box (like `docker cp`; direction picked by `name:` prefix)
+- `agentbox checkpoint` (alias `checkpoints`) — List and manage project checkpoints (warm box state to start new boxes from); bare command lists, `checkpoint create` captures
+
+**Advanced**
+
+- `agentbox wait` — Block until the box reports all autostart units ready
+- `agentbox prune` — Clean up orphan state records (and with `--all`, orphan docker resources)
+- `agentbox self-update` — Update agentbox, wipe the box image so it rebuilds, reload the relay
+- `agentbox config` — Read / write layered config (global, per-project, workspace `defaults:`)
+- `agentbox relay` — Manage the host relay process (`status` / `stop` / `start` / `restart`)
+
+Run `agentbox <command> --help` for command-specific options.
+
+## Development
+
+```sh
+git clone https://github.com/madarco/agentbox && cd agentbox
+pnpm install && pnpm build
+node apps/cli/dist/index.js --help
+```
+
+The full development workflow, stack, end-to-end smoke tests, and teardown live in [`docs/development.md`](https://github.com/madarco/agentbox/blob/main/docs/development.md).
+
+# Author
+
+[Marco D'Alia](https://www.madarco.net) - [@madarco](https://x.com/madarco) - [Linkedin](https://www.linkedin.com/in/marcodalia/)
+
+# License
+
+MIT. See [LICENSE](https://github.com/madarco/agentbox/blob/main/LICENSE).

package/dist/{_cloud-attach-ZXBCNWJX.js → _cloud-attach-O6NYTLES.js}

@@ -2,12 +2,12 @@
 import {
   buildCloudAttachInnerCommand,
   cloudAgentAttach
-} from "./chunk-GU5LW4B5.js";
-import "./chunk-NCJP5MTN.js";
+} from "./chunk-R4O5WPHW.js";
+import "./chunk-7UIAO7PC.js";
 import "./chunk-KL36BRN4.js";
 import "./chunk-G3H2L3O2.js";
 export {
   buildCloudAttachInnerCommand,
   cloudAgentAttach
 };
-//# sourceMappingURL=_cloud-attach-ZXBCNWJX.js.map
+//# sourceMappingURL=_cloud-attach-O6NYTLES.js.map