volute 0.25.0 → 0.27.0

package/README.md

@@ -13,6 +13,9 @@ Built on the [Anthropic Claude Agent SDK](https://github.com/anthropics/claude-a
 ```sh
 npm install -g volute
 
+# First-time setup (required)
+volute setup --name my-system
+
 # Start the daemon (manages all your minds)
 volute up
 
@@ -33,10 +36,11 @@ You now have a running AI mind with persistent memory, auto-committing file chan
 One background process runs everything. `volute up` starts it; `volute down` stops it.
 
 ```sh
-volute up              # start (default port 1618)
-volute up --port 8080  # custom port
-volute down            # stop all minds and shut down
-volute status          # check daemon status, version, and minds
+volute up                  # start (default port 1618)
+volute up --port 8080      # custom port
+volute up --no-sandbox     # disable sandbox isolation
+volute down                # stop all minds and shut down
+volute status              # check daemon status, version, and minds
 ```
 
 The daemon handles mind lifecycle, crash recovery (auto-restarts after 3 seconds), connector processes, scheduled messages, and the web dashboard.
@@ -93,32 +97,32 @@ This is the interesting part. Minds can fork themselves into isolated branches,
 
 ```sh
 # Create a variant — gets its own git worktree and running server
-volute variant create experiment --mind atlas
+volute mind split experiment --mind atlas
 
-# Talk to the variant directly
-volute send @atlas@experiment "try a different approach"
+# Talk to the variant directly (variants have standalone names)
+volute send @atlas-experiment "try a different approach"
 
 # List all variants
-volute variant list --mind atlas
+volute mind split --list --mind atlas
 
 # Merge it back (verifies, merges, cleans up, restarts the main mind)
-volute variant merge experiment --mind atlas --summary "improved response style"
+volute mind join atlas-experiment --mind atlas --summary "improved response style"
 ```
 
 What happens:
 
-1. **Fork** creates a git worktree, installs dependencies, and starts a separate server
+1. **Split** creates a git worktree, installs dependencies, and starts a separate server
 2. The variant is a full independent copy — same code, same identity, its own state
-3. **Merge** verifies the variant server works, merges the branch, removes the worktree, and restarts the main mind
+3. **Join** verifies the variant server works, merges the branch, removes the worktree, and restarts the main mind
 4. After restart, the mind receives orientation context about what changed
 
 You can fork with a custom personality:
 
 ```sh
-volute variant create poet --mind atlas --soul "You are a poet who responds only in verse."
+volute mind split poet --mind atlas --soul "You are a poet who responds only in verse."
 ```
 
-Minds have access to the `volute` CLI from their working directory, so they can fork, test, and merge their own variants autonomously.
+Minds have access to the `volute` CLI from their working directory, so they can split, test, and join their own variants autonomously.
 
 ## Connectors
 
@@ -210,7 +214,7 @@ The daemon serves a web UI at `http://localhost:1618` (or whatever port you chos
 - File browser and editor
 - Log streaming
 - Connector and schedule management
-- Variant status
+- Variant listing and status
 - First user to register becomes admin
 
 ## Upgrading minds
@@ -218,13 +222,13 @@ The daemon serves a web UI at `http://localhost:1618` (or whatever port you chos
 When the Volute template updates, you can upgrade minds without touching their identity:
 
 ```sh
-volute mind upgrade atlas          # creates an "upgrade" variant
+volute mind upgrade atlas          # creates an "atlas-upgrade" variant
 # resolve conflicts if needed, then:
 volute mind upgrade atlas --continue
 # test:
-volute send @atlas@upgrade "are you working?"
+volute send @atlas-upgrade "are you working?"
 # merge:
-volute variant merge upgrade --mind atlas
+volute mind join atlas-upgrade
 ```
 
 Your mind's `SOUL.md` and `MEMORY.md` are never overwritten.
@@ -261,33 +265,24 @@ docker compose up -d
 
 The container runs with per-mind user isolation enabled — each mind gets its own Linux user, so minds can't see each other's files. Open `http://localhost:1618` for the web dashboard.
 
-### Bare metal (Linux / Raspberry Pi)
-
-One-liner install on a fresh Linux system (Debian/Ubuntu, RHEL/Fedora, Arch, Alpine, SUSE):
-
-```sh
-curl -fsSL <install-url> | sudo bash
-```
-
-Or manually:
+### Bare metal (Linux / macOS)
 
 ```sh
 npm install -g volute
-sudo $(which volute) service install --system --host 0.0.0.0
+sudo volute setup --name my-server --system --host 0.0.0.0
 ```
 
-> **Note:** The initial `sudo $(which volute)` is needed because `sudo` resets PATH. After setup completes, a wrapper at `/usr/local/bin/volute` is created so `sudo volute` works normally going forward.
+This creates a system-level service with data at `/var/lib/volute`, minds at `/minds`, and per-user isolation (each mind gets its own system user). On Linux, uses systemd; on macOS, uses a LaunchDaemon. Requires root.
 
-This installs a system-level systemd service with data at `/var/lib/volute` and user isolation enabled. Check status with `systemctl status volute`. Uninstall with `sudo volute service uninstall --system --force`.
+> **Note:** After setup, a wrapper at `/usr/local/bin/volute` is created so `sudo volute` works without PATH issues.
 
 ### Auto-start (user-level)
 
-On macOS or Linux (without root), use the user-level service installer:
+On macOS or Linux (without root), include `--service` during setup:
 
 ```sh
-volute service install [--port N] [--host H]   # auto-start on login
-volute service status                          # check status
-volute service uninstall                       # remove
+volute setup --name my-system --service   # local install + auto-start on login
+volute service status                     # check status
 ```
 
 ## Development

package/dist/{activity-events-4O37J7PD.js → activity-events-BBIEA2F4.js}

@@ -3,10 +3,9 @@ import {
   broadcast,
   publish,
   subscribe
-} from "./chunk-BFK6SOEJ.js";
-import "./chunk-33XAVCS4.js";
+} from "./chunk-VIVMW2H2.js";
 import "./chunk-YUIHSKR6.js";
-import "./chunk-B2CPS4QU.js";
+import "./chunk-H7OZRFJB.js";
 import "./chunk-K3NQKI34.js";
 export {
   broadcast,