@boxes-dev/dvb 0.2.4

package/dist/devbox/ui/colors.d.ts

@@ -0,0 +1,19 @@
+type StyleName = "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "dim" | "bold" | "italic" | "underline";
+export declare const colors: {
+    style: (text: string, styles: StyleName | StyleName[]) => string;
+    cyan: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    red: (text: string) => string;
+    magenta: (text: string) => string;
+    blue: (text: string) => string;
+    dim: (text: string) => string;
+    gray: (text: string) => string;
+    white: (text: string) => string;
+    boldWhite: (text: string) => string;
+    bold: (text: string) => string;
+    italic: (text: string) => string;
+    muted: (text: string) => string;
+};
+export {};
+//# sourceMappingURL=colors.d.ts.map

package/dist/devbox/ui/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/devbox/ui/colors.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GACV,OAAO,GACP,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,WAAW,CAAC;AAOhB,eAAO,MAAM,MAAM;kBALQ,MAAM,UAAU,SAAS,GAAG,SAAS,EAAE;iBAOnD,MAAM;kBACL,MAAM;mBACL,MAAM;gBACT,MAAM;oBACF,MAAM;iBACT,MAAM;gBACP,MAAM;iBACL,MAAM;kBACL,MAAM;sBACF,MAAM;iBACX,MAAM;mBACJ,MAAM;kBACP,MAAM;CACrB,CAAC"}

package/dist/devbox/ui/colors.js

@@ -0,0 +1,22 @@
+import { styleText } from "node:util";
+const applyStyles = (text, styles) => {
+    const list = Array.isArray(styles) ? styles : [styles];
+    return list.reduce((acc, style) => styleText(style, acc), text);
+};
+export const colors = {
+    style: applyStyles,
+    cyan: (text) => applyStyles(text, "cyan"),
+    green: (text) => applyStyles(text, "green"),
+    yellow: (text) => applyStyles(text, "yellow"),
+    red: (text) => applyStyles(text, "red"),
+    magenta: (text) => applyStyles(text, "magenta"),
+    blue: (text) => applyStyles(text, "blue"),
+    dim: (text) => applyStyles(text, "dim"),
+    gray: (text) => applyStyles(text, "gray"),
+    white: (text) => applyStyles(text, "white"),
+    boldWhite: (text) => applyStyles(text, ["bold", "white"]),
+    bold: (text) => applyStyles(text, "bold"),
+    italic: (text) => applyStyles(text, "italic"),
+    muted: (text) => applyStyles(text, ["gray", "italic"]),
+};
+//# sourceMappingURL=colors.js.map

package/dist/devbox/ui/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/devbox/ui/colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAiBtC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAA+B,EAAE,EAAE;IACpE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;IACnD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC;IACrD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;IAC/C,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;IACvD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;IACjD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;IAC/C,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;IACnD,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC;IACrD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC/D,CAAC"}

package/dist/devbox/ui/statusLine.d.ts

@@ -0,0 +1,14 @@
+type StatusTone = "info" | "success" | "warn" | "error";
+type StatusLineOptions = {
+    enabled: boolean;
+    stream?: NodeJS.WriteStream;
+};
+type StatusLine = {
+    stage: (text: string, tone?: StatusTone) => void;
+    persist: (text: string, tone?: StatusTone) => void;
+    fail: (text: string) => void;
+    stop: () => void;
+};
+export declare const createStatusLine: ({ enabled, stream, }: StatusLineOptions) => StatusLine;
+export {};
+//# sourceMappingURL=statusLine.d.ts.map

package/dist/devbox/ui/statusLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusLine.d.ts","sourceRoot":"","sources":["../../../src/devbox/ui/statusLine.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CAC7B,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACnD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AA0BF,eAAO,MAAM,gBAAgB,GAAI,sBAG9B,iBAAiB,KAAG,UA+DtB,CAAC"}

package/dist/devbox/ui/statusLine.js

@@ -0,0 +1,90 @@
+import ora, {} from "ora";
+import { colors } from "./colors.js";
+const formatStage = (text, tone) => {
+    switch (tone) {
+        case "success":
+            return colors.green(text);
+        case "warn":
+            return colors.yellow(text);
+        case "error":
+            return colors.red(text);
+        case "info":
+        default:
+            return colors.cyan(text);
+    }
+};
+const formatPersist = (text, tone) => {
+    if (tone === "error")
+        return colors.red(text);
+    if (tone === "warn")
+        return colors.yellow(text);
+    if (tone === "success")
+        return colors.green(text);
+    return colors.muted(text);
+};
+export const createStatusLine = ({ enabled, stream = process.stderr, }) => {
+    if (!enabled) {
+        return {
+            stage: () => { },
+            persist: () => { },
+            fail: () => { },
+            stop: () => { },
+        };
+    }
+    let spinner = null;
+    let done = false;
+    const ensureSpinner = (text, tone) => {
+        if (done)
+            return;
+        const formatted = formatStage(text, tone);
+        if (spinner) {
+            spinner.text = formatted;
+            if (!spinner.isSpinning)
+                spinner.start();
+            return;
+        }
+        const options = {
+            text: formatted,
+            stream,
+            color: "white",
+            discardStdin: false,
+        };
+        spinner = ora(options).start();
+    };
+    return {
+        stage: (text, tone = "info") => {
+            ensureSpinner(text, tone);
+        },
+        persist: (text, tone = "info") => {
+            if (done)
+                return;
+            done = true;
+            const formatted = formatPersist(text, tone);
+            if (spinner) {
+                spinner.stopAndPersist({ symbol: "", text: formatted });
+                spinner = null;
+                return;
+            }
+            stream.write(`${formatted}\n`);
+        },
+        fail: (text) => {
+            if (done)
+                return;
+            done = true;
+            const formatted = formatStage(text, "error");
+            if (spinner) {
+                spinner.fail(formatted);
+                spinner = null;
+                return;
+            }
+            stream.write(`${formatted}\n`);
+        },
+        stop: () => {
+            if (spinner) {
+                spinner.stop();
+                spinner = null;
+            }
+        },
+    };
+};
+//# sourceMappingURL=statusLine.js.map

package/dist/devbox/ui/statusLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusLine.js","sourceRoot":"","sources":["../../../src/devbox/ui/statusLine.ts"],"names":[],"mappings":"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"}

package/dist/devbox/weztermMux.d.ts

@@ -0,0 +1,11 @@
+declare const WEZTERM_MUX_DIR = "/home/sprite/.devbox/wezterm";
+declare const WEZTERM_MUX_BIN_DIR = "/home/sprite/.devbox/wezterm/bin";
+declare const WEZTERM_MUX_ENV_PATH = "/home/sprite/.devbox/wezterm/env";
+declare const WEZTERM_MUX_INSTALL_DIR = "/home/sprite/.devbox/wezterm/opt";
+declare const WEZTERM_MUX_SOCKET_PATH = "/home/sprite/.devbox/wezterm/sock";
+declare const WEZTERM_MUX_CONFIG_PATH = "/home/sprite/.devbox/wezterm/wezterm.lua";
+declare const WEZTERM_MUX_RUNNER_PATH = "/home/sprite/.devbox/wezterm/run-mux.sh";
+declare const WEZTERM_MUX_SERVICE_NAME = "devbox-wezterm-mux";
+declare const WEZTERM_MUX_TCP_PORT = 32123;
+export { WEZTERM_MUX_BIN_DIR, WEZTERM_MUX_CONFIG_PATH, WEZTERM_MUX_DIR, WEZTERM_MUX_ENV_PATH, WEZTERM_MUX_INSTALL_DIR, WEZTERM_MUX_RUNNER_PATH, WEZTERM_MUX_SERVICE_NAME, WEZTERM_MUX_SOCKET_PATH, WEZTERM_MUX_TCP_PORT, };
+//# sourceMappingURL=weztermMux.d.ts.map

package/dist/devbox/weztermMux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weztermMux.d.ts","sourceRoot":"","sources":["../../src/devbox/weztermMux.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,eAAe,iCAAiC,CAAC;AACvD,QAAA,MAAM,mBAAmB,qCAA2B,CAAC;AACrD,QAAA,MAAM,oBAAoB,qCAA2B,CAAC;AACtD,QAAA,MAAM,uBAAuB,qCAA2B,CAAC;AACzD,QAAA,MAAM,uBAAuB,sCAA4B,CAAC;AAC1D,QAAA,MAAM,uBAAuB,6CAAmC,CAAC;AACjE,QAAA,MAAM,uBAAuB,4CAAkC,CAAC;AAChE,QAAA,MAAM,wBAAwB,uBAAuB,CAAC;AACtD,QAAA,MAAM,oBAAoB,QAAQ,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,CAAC"}

package/dist/devbox/weztermMux.js

@@ -0,0 +1,11 @@
+const WEZTERM_MUX_DIR = "/home/sprite/.devbox/wezterm";
+const WEZTERM_MUX_BIN_DIR = `${WEZTERM_MUX_DIR}/bin`;
+const WEZTERM_MUX_ENV_PATH = `${WEZTERM_MUX_DIR}/env`;
+const WEZTERM_MUX_INSTALL_DIR = `${WEZTERM_MUX_DIR}/opt`;
+const WEZTERM_MUX_SOCKET_PATH = `${WEZTERM_MUX_DIR}/sock`;
+const WEZTERM_MUX_CONFIG_PATH = `${WEZTERM_MUX_DIR}/wezterm.lua`;
+const WEZTERM_MUX_RUNNER_PATH = `${WEZTERM_MUX_DIR}/run-mux.sh`;
+const WEZTERM_MUX_SERVICE_NAME = "devbox-wezterm-mux";
+const WEZTERM_MUX_TCP_PORT = 32123;
+export { WEZTERM_MUX_BIN_DIR, WEZTERM_MUX_CONFIG_PATH, WEZTERM_MUX_DIR, WEZTERM_MUX_ENV_PATH, WEZTERM_MUX_INSTALL_DIR, WEZTERM_MUX_RUNNER_PATH, WEZTERM_MUX_SERVICE_NAME, WEZTERM_MUX_SOCKET_PATH, WEZTERM_MUX_TCP_PORT, };
+//# sourceMappingURL=weztermMux.js.map

package/dist/devbox/weztermMux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weztermMux.js","sourceRoot":"","sources":["../../src/devbox/weztermMux.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,8BAA8B,CAAC;AACvD,MAAM,mBAAmB,GAAG,GAAG,eAAe,MAAM,CAAC;AACrD,MAAM,oBAAoB,GAAG,GAAG,eAAe,MAAM,CAAC;AACtD,MAAM,uBAAuB,GAAG,GAAG,eAAe,MAAM,CAAC;AACzD,MAAM,uBAAuB,GAAG,GAAG,eAAe,OAAO,CAAC;AAC1D,MAAM,uBAAuB,GAAG,GAAG,eAAe,cAAc,CAAC;AACjE,MAAM,uBAAuB,GAAG,GAAG,eAAe,aAAa,CAAC;AAChE,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AACtD,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,CAAC"}

package/dist/prompts/local-scan.md

@@ -0,0 +1,32 @@
+We're migrating this dev environment from the current macOS to a Linux-based devbox. It will solely be used for local development of this repo.
+Your task is to create a detailed inventory of everything needed to recreate the local dev environment.
+We'll already have the repo checked out, so focus on any other dependencies, configs, and files needed for local operation.
+Exhaustively scan this repo and the local environment for anything needed to recreate this dev environment from scratch.
+Only include items that are required for local operation.
+Do not include secret values.
+
+Return JSON with this shape:
+- schemaVersion: number (use 2)
+- envFiles: [{ name, path, vars, usage }]
+  - envFiles are untracked .env-style files in the repo
+  - vars is a list of { name, value, isSecret, commented, hasValue }
+  - hasValue is true if the variable has a non-empty value (even if commented)
+  - value should be present for non-secret vars; use null for secrets
+  - usage should mention where the file / env vars consumed (briefly)
+- secretFiles: [{ name, path, description }]
+  - untracked non-.env files that include secrets or configs needed locally
+  - "description" should name the secrets/configs by name (no values)
+- extraArtifacts: [{ name, path, description }]
+  - other untracked files or directories that seem required for local operation
+  - keep this list tight; prefer listing a directory if all contents are needed rather than many individual files
+  - "description" should explain very briefly what the artifact(s) appear to be used for
+- externalDependencies: [{ name, version, evidence }]
+  - dependencies not installed by repo scripts but needed locally
+  - these can be CLIs, runtimes, global tools, etc.
+  - "version" refers to either the required or, if not clear, the installed version on local
+  - evidence can mention where you inferred it, should be very short
+- externalConfigs: [{ name, path, description }]
+  - config/secret files outside the repo that are required for local operation
+  - "description" should explain why they appear to be needed
+
+Return only JSON that matches the provided schema.

package/dist/prompts/local-services-scan.md

@@ -0,0 +1,17 @@
+We're capturing how to run this repo locally and any background services expected during local development.
+Scan the repo to find the primary command(s) a developer should run from the repo root to start the app locally.
+Also identify any background services the app expects to be running for local development.
+Only include commands that are required or explicitly documented in this repo.
+Do not include secret values.
+
+Return JSON with this shape:
+- schemaVersion: number (use 1)
+- appEntrypoints: [{ command, description }]
+  - command should be the exact command to run from the repo root
+  - description should be a short, human-readable explanation of what the command does
+- backgroundServices: [{ name, command, httpPort }]
+  - name should be a short identifier (e.g. "postgres")
+  - command should be the full command string to start the service
+  - httpPort is the HTTP port for proxy routing, or null if not applicable/unknown
+
+Return only JSON that matches the provided schema.

package/dist/prompts/remote-apply.md

@@ -0,0 +1,370 @@
+You're on headless dev machine, running on a Fly.io "sprite" with Ubuntu 25.04.
+It's a full linux environment with root access, and local ports are forwarded, so
+we can just run things here as if it were our local machine (i.e. use localhost).
+
+We're setting it up to be the persistent development environment for this project,
+migrating from macOS. Your task is to apply the setup plan at `{{setup_path}}` 
+to make this repo usable, with a focus on correctness, repeatability, and minimal 
+risk. We want to be able to run all the services locally for development.
+
+---
+
+Here is some information on the local environment. When setting things up for 
+development, be aware of what's already installed on the system; leverage existing 
+tools where possible. You are free to modify the system as needed, but avoid
+unnecessary changes.
+
+---
+# Sprite Environment
+
+Sprites run on pre-configured base images that include common development tools, language runtimes, and AI coding agents. The base image is upgraded automatically without affecting your overlay filesystem.
+
+## Ubuntu DevTools (Default)
+
+The default Sprite image is based on Ubuntu 25.04 and comes with a comprehensive development environment.
+
+### Operating System
+
+- **Base**: Ubuntu 25.04
+- **User**: `sprite` with passwordless sudo
+- **Shell**: bash (default), with zsh, fish, tcsh, and ksh available
+
+### Pre-installed Languages
+
+| Language | Default Version | Version Manager | Manager Shimmed? |
+|----------|-----------------|-----------------|------------------|
+| Node.js | 22.20.0 | nvm | No (requires sourcing) |
+| Python | 3.13.7 | pyenv | Yes |
+| Go | 1.25.1 | Direct install | N/A |
+| Rust | 1.90.0 | rustup | Yes |
+| Ruby | 3.4.6 | rbenv | Yes |
+| Elixir | 1.18.4 | Direct install | N/A |
+| Erlang | 28.1 | kerl | Yes |
+| Java | 25 (Temurin) | SDKMAN | No (requires sourcing) |
+| Bun | latest | Direct install | N/A |
+| Deno | latest | Direct install | N/A |
+
+### AI Coding Agents
+
+Pre-installed coding agents ready to use:
+
+| Agent | Command | Package |
+|-------|---------|---------|
+| Claude Code | `claude` | @anthropic-ai/claude-code |
+| Gemini CLI | `gemini` | @google/gemini-cli |
+| OpenAI Codex | `codex` | @openai/codex |
+| Cursor | `cursor` | cursor |
+
+### System Tools
+
+Common development tools pre-installed:
+
+- **Build tools**: build-essential, clang, autoconf, automake, libtool, pkg-config
+- **Version control**: git
+- **Editors**: vim, nano
+- **Shells**: bash, zsh, fish, tcsh, ksh
+- **Terminal**: tmux, kitty
+- **Utilities**: curl, wget, rsync, tree, htop
+- **Network**: dnsutils, iputils-ping, net-tools, openssh-client
+
+## Language Details
+
+### Node.js
+
+Default commands work immediately via shims: `node`, `npm`, `npx`, `corepack`.
+
+```bash
+# These work directly
+node --version
+npm --version
+npm install express
+npx create-next-app
+```
+
+To install or switch Node.js versions, you must source nvm first:
+
+```bash
+# Source nvm
+export NVM_DIR="/.sprite/languages/node/nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# Now nvm commands work
+nvm install 20
+nvm install 18
+nvm use 20
+nvm alias default 20
+nvm list
+```
+
+### Python
+
+Default commands work immediately via shims: `python`, `pip`, `pipenv`, `poetry`, `virtualenv`.
+
+The `pyenv` command is also shimmed and works directly:
+
+```bash
+# These work directly
+python --version
+pip --version
+pip install requests
+
+# pyenv is shimmed - works without sourcing
+pyenv install 3.12.0
+pyenv install 3.11.0
+pyenv global 3.12.0
+pyenv local 3.11.0  # Per-directory
+pyenv versions
+
+# Virtual environments
+python -m venv myenv
+source myenv/bin/activate
+
+# Or use poetry/pipenv (pre-installed)
+poetry new myproject
+pipenv install
+```
+
+### Go
+
+Default commands work immediately via shims: `go`, `gofmt`.
+
+```bash
+# These work directly
+go version
+go build
+go run main.go
+go install github.com/example/tool@latest
+```
+
+Go is installed directly without a version manager. Only one version is available at a time.
+
+### Rust
+
+Default commands work immediately via shims: `rustc`, `cargo`, `rustfmt`, `rustdoc`.
+
+The `rustup` command is also shimmed and works directly:
+
+```bash
+# These work directly
+rustc --version
+cargo --version
+cargo build
+cargo run
+
+# rustup is shimmed - works without sourcing
+rustup toolchain install nightly
+rustup toolchain install 1.75.0
+rustup default nightly
+rustup default stable
+rustup component add clippy
+rustup toolchain list
+```
+
+### Ruby
+
+Default commands work immediately via shims: `ruby`, `gem`, `bundle`, `bundler`, `irb`, `rake`.
+
+The `rbenv` command is also shimmed and works directly:
+
+```bash
+# These work directly
+ruby --version
+gem --version
+gem install rails
+bundle install
+
+# rbenv is shimmed - works without sourcing
+rbenv install 3.3.0
+rbenv install 3.2.0
+rbenv global 3.3.0
+rbenv local 3.2.0  # Per-directory
+rbenv versions
+```
+
+### Elixir & Erlang
+
+Default Elixir commands work via shims: `elixir`, `elixirc`, `iex`, `mix`.
+
+Default Erlang commands work via shims: `erl`, `erlc`, `escript`, `dialyzer`, `rebar3`.
+
+```bash
+# These work directly
+elixir --version
+iex
+mix new myapp
+
+erl -version
+rebar3 new app myapp
+```
+
+The `kerl` command is shimmed for managing Erlang versions:
+
+```bash
+# kerl is shimmed - works without sourcing
+kerl list releases
+kerl build 27.0 27.0
+kerl install 27.0 /.sprite/languages/erlang/kerl/installs/27.0
+```
+
+Elixir is installed directly for the default Erlang version. To use different Elixir versions, download precompiled releases manually.
+
+### Java
+
+Default Java commands work via shims: `java`, `javac`, `jar`, `jshell`, etc.
+
+```bash
+# These work directly
+java --version
+javac --version
+java -jar myapp.jar
+```
+
+To install or switch Java versions, you must source SDKMAN first:
+
+```bash
+# Source SDKMAN
+export SDKMAN_DIR="/.sprite/languages/java/sdkman"
+[ -s "$SDKMAN_DIR/bin/sdkman-init.sh" ] && \. "$SDKMAN_DIR/bin/sdkman-init.sh"
+
+# Now sdk commands work
+sdk list java
+sdk install java 21-tem
+sdk install java 17-tem
+sdk use java 21-tem
+sdk default java 21-tem
+```
+
+### Bun
+
+Default commands work via shims: `bun`, `bunx`.
+
+```bash
+# These work directly
+bun --version
+bun run start
+bun install
+bun test
+bunx create-next-app
+```
+
+### Deno
+
+Default command works via shim: `deno`.
+
+```bash
+# These work directly
+deno --version
+deno run script.ts
+deno task start
+deno compile app.ts
+```
+
+## Filesystem Layout
+
+Languages are installed in `/.sprite/languages/` with shims in `/.sprite/bin/`:
+
+```
+/.sprite/
+├── bin/                    # Command shims (in PATH)
+│   ├── node
+│   ├── npm
+│   ├── python
+│   ├── pyenv              # Shimmed - works directly
+│   ├── go
+│   ├── rustc
+│   ├── rustup             # Shimmed - works directly
+│   ├── ruby
+│   ├── rbenv              # Shimmed - works directly
+│   └── ...
+├── languages/
+│   ├── node/
+│   │   └── nvm/           # Must source to use nvm
+│   ├── python/
+│   │   └── pyenv/         # Shimmed via /.sprite/bin/pyenv
+│   ├── go/
+│   │   ├── versions/      # Go versions
+│   │   └── current/       # Symlink to active version
+│   ├── rust/
+│   │   ├── rustup/        # Shimmed via /.sprite/bin/rustup
+│   │   └── cargo/
+│   ├── ruby/
+│   │   └── rbenv/         # Shimmed via /.sprite/bin/rbenv
+│   ├── java/
+│   │   └── sdkman/        # Must source to use sdk
+│   ├── erlang/
+│   │   └── kerl/          # Shimmed via /.sprite/bin/kerl
+│   ├── elixir/
+│   │   └── current/       # Symlink to active version
+│   ├── bun/
+│   └── deno/
+├── etc/
+│   └── profile.d/         # Shell initialization
+└── llm.txt                 # LLM documentation
+```
+
+## Image Updates
+
+Base images are updated automatically without affecting your files:
+
+- **Your code and data**: Stored in the overlay filesystem, preserved across updates
+- **System packages**: Updated in the base image, applied on next boot
+- **Language runtimes**: Base versions updated, your installed versions preserved
+
+To check the current base image version:
+
+```bash
+cat /.sprite/version.txt
+```
+
+## LLM Integration
+
+Each Sprite includes documentation for LLMs at `/.sprite/llm.txt`. This file describes the environment and available tools, making it easy for AI assistants to understand and work with your Sprite.
+
+Additional language-specific documentation is available in each language directory:
+
+```bash
+# General environment documentation
+cat /.sprite/llm.txt
+
+# Per-language documentation
+cat /.sprite/languages/node/llm.txt
+cat /.sprite/languages/python/llm.txt
+cat /.sprite/languages/rust/llm.txt
+```
+
+
+
+---
+
+Your task is to set up the development environment for this project by following these steps:
+
+If `{{artifacts_bundle}}` and `{{artifacts_manifest}}` are present:
+1) Unpack the bundle to a temp directory.
+2) Use the manifest to copy files into their intended locations.
+3) Preserve permissions and avoid overwriting newer files unless the manifest
+   explicitly says to replace them.
+
+Then apply the setup plan in `{{setup_path}}`:
+- Install required tools/runtimes that are listed.
+- Prefer project-local installs (e.g., package manager installs in the repo)
+  over global installs.
+- Run setup commands in the repo root unless the plan specifies another path.
+- If there are multiple package managers, follow the plan’s choice; do not
+  guess.
+
+Finally, make sure the dev environment is functional:
+- Find the main entry point(s) for local dev in this repo, and make sure they work.{{entrypoints_block}}
+- If you find any missing external dependencies, install them. 
+- If you find anything that needs to be run but has not been (i.e. `npm install`, `uv sync`, `bundle install`, etc), run it.
+- If things need to be on the PATH, ensure that is set up correctly, including for new sessions.
+- If you don't know how to install something, use web search (use reputable sources only) to find the correct approach
+
+When doing these steps, lean careful / conservative:
+- Do not delete user files or reset git history.
+- Do not run arbitrary network calls unless it's required.
+- If a step is unclear or unsafe, skip it and record a TODO.
+
+Write a short, actionable summary to `.devbox/setup.todo` with:
+- What you completed (and how).
+- What you skipped (and why).
+- Exact commands the user should run to finish setup (if needed).

package/dist/scripts/fix-bashrc.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+bashrc="/home/sprite/.bashrc"
+old='trap '\''echo -ne "\033]0;${BASH_COMMAND}\007"'\'' DEBUG'
+new='trap '\''printf "\033]0;%s\007" "${BASH_COMMAND//[^[:print:]]/}"'\'' DEBUG'
+# Note: the DEBUG trap replacement appears to be legacy. If the expected line
+# isn't present (e.g., PROMPT_COMMAND-based titles), skip without failing.
+old_bind_one='bind '"'"'"\e[A": history-search-backward'"'"''
+old_bind_two='bind '"'"'"\e[B": history-search-forward'"'"''
+new_bind_one='if [[ $- == *i* ]]; then bind "\e[A": history-search-backward; fi'
+new_bind_two='if [[ $- == *i* ]]; then bind "\e[B": history-search-forward; fi'
+
+if [[ ! -f "$bashrc" ]]; then
+  echo "missing $bashrc; skipping bashrc patch" >&2
+  exit 0
+fi
+
+if grep -Fqx "$new" "$bashrc" && grep -Fqx "$new_bind_one" "$bashrc" && grep -Fqx "$new_bind_two" "$bashrc"; then
+  exit 0
+fi
+
+python3 - <<'PY'
+from pathlib import Path
+import re
+
+path = Path("/home/sprite/.bashrc")
+data = path.read_text()
+old = 'trap \'echo -ne "\\033]0;${BASH_COMMAND}\\007"\' DEBUG'
+new = 'trap \'printf "\\033]0;%s\\007" "${BASH_COMMAND//[^[:print:]]/}"\' DEBUG'
+old_bind_one = 'bind '"'"'"\\e[A": history-search-backward"'"'"''
+old_bind_two = 'bind '"'"'"\\e[B": history-search-forward"'"'"''
+new_bind_one = 'if [[ $- == *i* ]]; then bind "\\e[A": history-search-backward; fi'
+new_bind_two = 'if [[ $- == *i* ]]; then bind "\\e[B": history-search-forward; fi'
+bind_back_pattern = r'^bind .*history-search-backward.*$'
+bind_forward_pattern = r'^bind .*history-search-forward.*$'
+
+if old in data:
+    data = data.replace(old, new, 1)
+
+if new_bind_one not in data and re.search(bind_back_pattern, data, flags=re.M):
+    data = re.sub(bind_back_pattern, lambda _: new_bind_one, data, count=1, flags=re.M)
+if new_bind_two not in data and re.search(bind_forward_pattern, data, flags=re.M):
+    data = re.sub(bind_forward_pattern, lambda _: new_bind_two, data, count=1, flags=re.M)
+path.write_text(data)
+PY
+
+chmod 644 "$bashrc"