@symerian/symi 3.0.20 → 3.0.22

package/docs/install/installer.md

@@ -1,405 +0,0 @@
----
-summary: "How the installer scripts work (install.sh, install-cli.sh, install.ps1), flags, and automation"
-read_when:
-  - You want to understand `jaysteelmind.github.io/getsymi/install.sh`
-  - You want to automate installs (CI / headless)
-  - You want to install from a GitHub checkout
-title: "Installer Internals"
----
-
-# Installer internals
-
-Symi ships three installer scripts, hosted at `jaysteelmind.github.io/getsymi`.
-
-| Script                             | Platform             | What it does                                                                             |
-| ---------------------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
-| [`install.sh`](#installsh)         | macOS / Linux / WSL  | Installs Node if needed, installs Symi via npm (default) or git, and can run onboarding. |
-| [`install-cli.sh`](#install-clish) | macOS / Linux / WSL  | Installs Node + Symi into a local prefix (`~/.symi`). No root required.                  |
-| [`install.ps1`](#installps1)       | Windows (PowerShell) | Installs Node if needed, installs Symi via npm (default) or git, and can run onboarding. |
-
-## Quick commands
-
-<Tabs>
-  <Tab title="install.sh">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash
-    ```
-
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash -s -- --help
-    ```
-
-  </Tab>
-  <Tab title="install-cli.sh">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash
-    ```
-
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash -s -- --help
-    ```
-
-  </Tab>
-  <Tab title="install.ps1">
-    ```powershell
-    iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1 | iex
-    ```
-
-    ```powershell
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -Tag beta -NoOnboard -DryRun
-    ```
-
-  </Tab>
-</Tabs>
-
-<Note>
-If install succeeds but `symi` is not found in a new terminal, see [Node.js troubleshooting](/install/node#troubleshooting).
-</Note>
-
----
-
-## install.sh
-
-<Tip>
-Recommended for most interactive installs on macOS/Linux/WSL.
-</Tip>
-
-### Flow (install.sh)
-
-<Steps>
-  <Step title="Detect OS">
-    Supports macOS and Linux (including WSL). If macOS is detected, installs Homebrew if missing.
-  </Step>
-  <Step title="Ensure Node.js 22+">
-    Checks Node version and installs Node 22 if needed (Homebrew on macOS, NodeSource setup scripts on Linux apt/dnf/yum).
-  </Step>
-  <Step title="Ensure Git">
-    Installs Git if missing.
-  </Step>
-  <Step title="Install Symi">
-    - `npm` method (default): global npm install
-    - `git` method: clone/update repo, install deps with pnpm, build, then install wrapper at `~/.local/bin/symi`
-  </Step>
-  <Step title="Post-install tasks">
-    - Runs `symi doctor --non-interactive` on upgrades and git installs (best effort)
-    - Attempts onboarding when appropriate (TTY available, onboarding not disabled, and bootstrap/config checks pass)
-    - Defaults `SHARP_IGNORE_GLOBAL_LIBVIPS=1`
-  </Step>
-</Steps>
-
-### Source checkout detection
-
-If run inside an Symi checkout (`package.json` + `pnpm-workspace.yaml`), the script offers:
-
-- use checkout (`git`), or
-- use global install (`npm`)
-
-If no TTY is available and no install method is set, it defaults to `npm` and warns.
-
-The script exits with code `2` for invalid method selection or invalid `--install-method` values.
-
-### Examples (install.sh)
-
-<Tabs>
-  <Tab title="Default">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash
-    ```
-  </Tab>
-  <Tab title="Skip onboarding">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash -s -- --no-onboard
-    ```
-  </Tab>
-  <Tab title="Git install">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash -s -- --install-method git
-    ```
-  </Tab>
-  <Tab title="Dry run">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash -s -- --dry-run
-    ```
-  </Tab>
-</Tabs>
-
-<AccordionGroup>
-  <Accordion title="Flags reference">
-
-| Flag                            | Description                                               |
-| ------------------------------- | --------------------------------------------------------- |
-| `--install-method npm\|git`     | Choose install method (default: `npm`). Alias: `--method` |
-| `--npm`                         | Shortcut for npm method                                   |
-| `--git`                         | Shortcut for git method. Alias: `--github`                |
-| `--version <version\|dist-tag>` | npm version or dist-tag (default: `latest`)               |
-| `--beta`                        | Use beta dist-tag if available, else fallback to `latest` |
-| `--git-dir <path>`              | Checkout directory (default: `~/symi`). Alias: `--dir`    |
-| `--no-git-update`               | Skip `git pull` for existing checkout                     |
-| `--no-prompt`                   | Disable prompts                                           |
-| `--no-onboard`                  | Skip onboarding                                           |
-| `--onboard`                     | Enable onboarding                                         |
-| `--dry-run`                     | Print actions without applying changes                    |
-| `--verbose`                     | Enable debug output (`set -x`, npm notice-level logs)     |
-| `--help`                        | Show usage (`-h`)                                         |
-
-  </Accordion>
-
-  <Accordion title="Environment variables reference">
-
-| Variable                                | Description                                   |
-| --------------------------------------- | --------------------------------------------- |
-| `SYMI_INSTALL_METHOD=git\|npm`          | Install method                                |
-| `SYMI_VERSION=latest\|next\|<semver>`   | npm version or dist-tag                       |
-| `SYMI_BETA=0\|1`                        | Use beta if available                         |
-| `SYMI_GIT_DIR=<path>`                   | Checkout directory                            |
-| `SYMI_GIT_UPDATE=0\|1`                  | Toggle git updates                            |
-| `SYMI_NO_PROMPT=1`                      | Disable prompts                               |
-| `SYMI_NO_ONBOARD=1`                     | Skip onboarding                               |
-| `SYMI_DRY_RUN=1`                        | Dry run mode                                  |
-| `SYMI_VERBOSE=1`                        | Debug mode                                    |
-| `SYMI_NPM_LOGLEVEL=error\|warn\|notice` | npm log level                                 |
-| `SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`      | Control sharp/libvips behavior (default: `1`) |
-
-  </Accordion>
-</AccordionGroup>
-
----
-
-## install-cli.sh
-
-<Info>
-Designed for environments where you want everything under a local prefix (default `~/.symi`) and no system Node dependency.
-</Info>
-
-### Flow (install-cli.sh)
-
-<Steps>
-  <Step title="Install local Node runtime">
-    Downloads Node tarball (default `22.22.0`) to `<prefix>/tools/node-v<version>` and verifies SHA-256.
-  </Step>
-  <Step title="Ensure Git">
-    If Git is missing, attempts install via apt/dnf/yum on Linux or Homebrew on macOS.
-  </Step>
-  <Step title="Install Symi under prefix">
-    Installs with npm using `--prefix <prefix>`, then writes wrapper to `<prefix>/bin/symi`.
-  </Step>
-</Steps>
-
-### Examples (install-cli.sh)
-
-<Tabs>
-  <Tab title="Default">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash
-    ```
-  </Tab>
-  <Tab title="Custom prefix + version">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash -s -- --prefix /opt/symi --version latest
-    ```
-  </Tab>
-  <Tab title="Automation JSON output">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash -s -- --json --prefix /opt/symi
-    ```
-  </Tab>
-  <Tab title="Run onboarding">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash -s -- --onboard
-    ```
-  </Tab>
-</Tabs>
-
-<AccordionGroup>
-  <Accordion title="Flags reference">
-
-| Flag                   | Description                                                                     |
-| ---------------------- | ------------------------------------------------------------------------------- |
-| `--prefix <path>`      | Install prefix (default: `~/.symi`)                                             |
-| `--version <ver>`      | Symi version or dist-tag (default: `latest`)                                    |
-| `--node-version <ver>` | Node version (default: `22.22.0`)                                               |
-| `--json`               | Emit NDJSON events                                                              |
-| `--onboard`            | Run `symi onboard` after install                                                |
-| `--no-onboard`         | Skip onboarding (default)                                                       |
-| `--set-npm-prefix`     | On Linux, force npm prefix to `~/.npm-global` if current prefix is not writable |
-| `--help`               | Show usage (`-h`)                                                               |
-
-  </Accordion>
-
-  <Accordion title="Environment variables reference">
-
-| Variable                                | Description                                                                       |
-| --------------------------------------- | --------------------------------------------------------------------------------- |
-| `SYMI_PREFIX=<path>`                    | Install prefix                                                                    |
-| `SYMI_VERSION=<ver>`                    | Symi version or dist-tag                                                          |
-| `SYMI_NODE_VERSION=<ver>`               | Node version                                                                      |
-| `SYMI_NO_ONBOARD=1`                     | Skip onboarding                                                                   |
-| `SYMI_NPM_LOGLEVEL=error\|warn\|notice` | npm log level                                                                     |
-| `SYMI_GIT_DIR=<path>`                   | Legacy cleanup lookup path (used when removing old `Peekaboo` submodule checkout) |
-| `SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`      | Control sharp/libvips behavior (default: `1`)                                     |
-
-  </Accordion>
-</AccordionGroup>
-
----
-
-## install.ps1
-
-### Flow (install.ps1)
-
-<Steps>
-  <Step title="Ensure PowerShell + Windows environment">
-    Requires PowerShell 5+.
-  </Step>
-  <Step title="Ensure Node.js 22+">
-    If missing, attempts install via winget, then Chocolatey, then Scoop.
-  </Step>
-  <Step title="Install Symi">
-    - `npm` method (default): global npm install using selected `-Tag`
-    - `git` method: clone/update repo, install/build with pnpm, and install wrapper at `%USERPROFILE%\.local\bin\symi.cmd`
-  </Step>
-  <Step title="Post-install tasks">
-    Adds needed bin directory to user PATH when possible, then runs `symi doctor --non-interactive` on upgrades and git installs (best effort).
-  </Step>
-</Steps>
-
-### Examples (install.ps1)
-
-<Tabs>
-  <Tab title="Default">
-    ```powershell
-    iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1 | iex
-    ```
-  </Tab>
-  <Tab title="Git install">
-    ```powershell
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -InstallMethod git
-    ```
-  </Tab>
-  <Tab title="Custom git directory">
-    ```powershell
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -InstallMethod git -GitDir "C:\symi"
-    ```
-  </Tab>
-  <Tab title="Dry run">
-    ```powershell
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -DryRun
-    ```
-  </Tab>
-  <Tab title="Debug trace">
-    ```powershell
-    # install.ps1 has no dedicated -Verbose flag yet.
-    Set-PSDebug -Trace 1
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -NoOnboard
-    Set-PSDebug -Trace 0
-    ```
-  </Tab>
-</Tabs>
-
-<AccordionGroup>
-  <Accordion title="Flags reference">
-
-| Flag                      | Description                                        |
-| ------------------------- | -------------------------------------------------- |
-| `-InstallMethod npm\|git` | Install method (default: `npm`)                    |
-| `-Tag <tag>`              | npm dist-tag (default: `latest`)                   |
-| `-GitDir <path>`          | Checkout directory (default: `%USERPROFILE%\symi`) |
-| `-NoOnboard`              | Skip onboarding                                    |
-| `-NoGitUpdate`            | Skip `git pull`                                    |
-| `-DryRun`                 | Print actions only                                 |
-
-  </Accordion>
-
-  <Accordion title="Environment variables reference">
-
-| Variable                       | Description        |
-| ------------------------------ | ------------------ |
-| `SYMI_INSTALL_METHOD=git\|npm` | Install method     |
-| `SYMI_GIT_DIR=<path>`          | Checkout directory |
-| `SYMI_NO_ONBOARD=1`            | Skip onboarding    |
-| `SYMI_GIT_UPDATE=0`            | Disable git pull   |
-| `SYMI_DRY_RUN=1`               | Dry run mode       |
-
-  </Accordion>
-</AccordionGroup>
-
-<Note>
-If `-InstallMethod git` is used and Git is missing, the script exits and prints the Git for Windows link.
-</Note>
-
----
-
-## CI and automation
-
-Use non-interactive flags/env vars for predictable runs.
-
-<Tabs>
-  <Tab title="install.sh (non-interactive npm)">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash -s -- --no-prompt --no-onboard
-    ```
-  </Tab>
-  <Tab title="install.sh (non-interactive git)">
-    ```bash
-    SYMI_INSTALL_METHOD=git SYMI_NO_PROMPT=1 \
-      curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash
-    ```
-  </Tab>
-  <Tab title="install-cli.sh (JSON)">
-    ```bash
-    curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install-cli.sh | bash -s -- --json --prefix /opt/symi
-    ```
-  </Tab>
-  <Tab title="install.ps1 (skip onboarding)">
-    ```powershell
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -NoOnboard
-    ```
-  </Tab>
-</Tabs>
-
----
-
-## Troubleshooting
-
-<AccordionGroup>
-  <Accordion title="Why is Git required?">
-    Git is required for `git` install method. For `npm` installs, Git is still checked/installed to avoid `spawn git ENOENT` failures when dependencies use git URLs.
-  </Accordion>
-
-  <Accordion title="Why does npm hit EACCES on Linux?">
-    Some Linux setups point npm global prefix to root-owned paths. `install.sh` can switch prefix to `~/.npm-global` and append PATH exports to shell rc files (when those files exist).
-  </Accordion>
-
-  <Accordion title="sharp/libvips issues">
-    The scripts default `SHARP_IGNORE_GLOBAL_LIBVIPS=1` to avoid sharp building against system libvips. To override:
-
-    ```bash
-    SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://jaysteelmind.github.io/getsymi/install.sh | bash
-    ```
-
-  </Accordion>
-
-  <Accordion title='Windows: "npm error spawn git / ENOENT"'>
-    Install Git for Windows, reopen PowerShell, rerun installer.
-  </Accordion>
-
-  <Accordion title='Windows: "symi is not recognized"'>
-    Run `npm config get prefix`, append `\bin`, add that directory to user PATH, then reopen PowerShell.
-  </Accordion>
-
-  <Accordion title="Windows: how to get verbose installer output">
-    `install.ps1` does not currently expose a `-Verbose` switch.
-    Use PowerShell tracing for script-level diagnostics:
-
-    ```powershell
-    Set-PSDebug -Trace 1
-    & ([scriptblock]::Create((iwr -useb https://jaysteelmind.github.io/getsymi/install.ps1))) -NoOnboard
-    Set-PSDebug -Trace 0
-    ```
-
-  </Accordion>
-
-  <Accordion title="symi not found after install">
-    Usually a PATH issue. See [Node.js troubleshooting](/install/node#troubleshooting).
-  </Accordion>
-</AccordionGroup>

package/docs/install/macos-vm.md

@@ -1,281 +0,0 @@
----
-summary: "Run Symi in a sandboxed macOS VM (local or hosted) when you need isolation or iMessage"
-read_when:
-  - You want Symi isolated from your main macOS environment
-  - You want iMessage integration (BlueBubbles) in a sandbox
-  - You want a resettable macOS environment you can clone
-  - You want to compare local vs hosted macOS VM options
-title: "macOS VMs"
----
-
-# Symi on macOS VMs (Sandboxing)
-
-## Recommended default (most users)
-
-- **Small Linux VPS** for an always-on Gateway and low cost. See [VPS hosting](/vps).
-- **Dedicated hardware** (Mac mini or Linux box) if you want full control and a **residential IP** for browser automation. Many sites block data center IPs, so local browsing often works better.
-- **Hybrid:** keep the Gateway on a cheap VPS, and connect your Mac as a **node** when you need browser/UI automation. See [Nodes](/nodes) and [Gateway remote](/gateway/remote).
-
-Use a macOS VM when you specifically need macOS-only capabilities (iMessage/BlueBubbles) or want strict isolation from your daily Mac.
-
-## macOS VM options
-
-### Local VM on your Apple Silicon Mac (Lume)
-
-Run Symi in a sandboxed macOS VM on your existing Apple Silicon Mac using [Lume](https://cua.ai/docs/lume).
-
-This gives you:
-
-- Full macOS environment in isolation (your host stays clean)
-- iMessage support via BlueBubbles (impossible on Linux/Windows)
-- Instant reset by cloning VMs
-- No extra hardware or cloud costs
-
-### Hosted Mac providers (cloud)
-
-If you want macOS in the cloud, hosted Mac providers work too:
-
-- [MacStadium](https://www.macstadium.com/) (hosted Macs)
-- Other hosted Mac vendors also work; follow their VM + SSH docs
-
-Once you have SSH access to a macOS VM, continue at step 6 below.
-
----
-
-## Quick path (Lume, experienced users)
-
-1. Install Lume
-2. `lume create symi --os macos --ipsw latest`
-3. Complete Setup Assistant, enable Remote Login (SSH)
-4. `lume run symi --no-display`
-5. SSH in, install Symi, configure channels
-6. Done
-
----
-
-## What you need (Lume)
-
-- Apple Silicon Mac (M1/M2/M3/M4)
-- macOS Sequoia or later on the host
-- ~60 GB free disk space per VM
-- ~20 minutes
-
----
-
-## 1) Install Lume
-
-```bash
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
-```
-
-If `~/.local/bin` isn't in your PATH:
-
-```bash
-echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
-```
-
-Verify:
-
-```bash
-lume --version
-```
-
-Docs: [Lume Installation](https://cua.ai/docs/lume/guide/getting-started/installation)
-
----
-
-## 2) Create the macOS VM
-
-```bash
-lume create symi --os macos --ipsw latest
-```
-
-This downloads macOS and creates the VM. A VNC window opens automatically.
-
-Note: The download can take a while depending on your connection.
-
----
-
-## 3) Complete Setup Assistant
-
-In the VNC window:
-
-1. Select language and region
-2. Skip Apple ID (or sign in if you want iMessage later)
-3. Create a user account (remember the username and password)
-4. Skip all optional features
-
-After setup completes, enable SSH:
-
-1. Open System Settings → General → Sharing
-2. Enable "Remote Login"
-
----
-
-## 4) Get the VM's IP address
-
-```bash
-lume get symi
-```
-
-Look for the IP address (usually `192.168.64.x`).
-
----
-
-## 5) SSH into the VM
-
-```bash
-ssh youruser@192.168.64.X
-```
-
-Replace `youruser` with the account you created, and the IP with your VM's IP.
-
----
-
-## 6) Install Symi
-
-Inside the VM:
-
-```bash
-npm install -g @symerian/symi@latest
-symi onboard --install-daemon
-```
-
-Follow the onboarding prompts to set up your model provider (Anthropic, OpenAI, etc.).
-
----
-
-## 7) Configure channels
-
-Edit the config file:
-
-```bash
-nano ~/.symi/symi.json
-```
-
-Add your channels:
-
-```json
-{
-  "channels": {
-    "whatsapp": {
-      "dmPolicy": "allowlist",
-      "allowFrom": ["+15551234567"]
-    },
-    "telegram": {
-      "botToken": "YOUR_BOT_TOKEN"
-    }
-  }
-}
-```
-
-Then login to WhatsApp (scan QR):
-
-```bash
-symi channels login
-```
-
----
-
-## 8) Run the VM headlessly
-
-Stop the VM and restart without display:
-
-```bash
-lume stop symi
-lume run symi --no-display
-```
-
-The VM runs in the background. Symi's daemon keeps the gateway running.
-
-To check status:
-
-```bash
-ssh youruser@192.168.64.X "symi status"
-```
-
----
-
-## Bonus: iMessage integration
-
-This is the killer feature of running on macOS. Use [BlueBubbles](https://bluebubbles.app) to add iMessage to Symi.
-
-Inside the VM:
-
-1. Download BlueBubbles from bluebubbles.app
-2. Sign in with your Apple ID
-3. Enable the Web API and set a password
-4. Point BlueBubbles webhooks at your gateway (example: `https://your-gateway-host:3000/bluebubbles-webhook?password=<password>`)
-
-Add to your Symi config:
-
-```json
-{
-  "channels": {
-    "bluebubbles": {
-      "serverUrl": "http://localhost:1234",
-      "password": "your-api-password",
-      "webhookPath": "/bluebubbles-webhook"
-    }
-  }
-}
-```
-
-Restart the gateway. Now your agent can send and receive iMessages.
-
-Full setup details: [BlueBubbles channel](/channels/bluebubbles)
-
----
-
-## Save a golden image
-
-Before customizing further, snapshot your clean state:
-
-```bash
-lume stop symi
-lume clone symi symi-golden
-```
-
-Reset anytime:
-
-```bash
-lume stop symi && lume delete symi
-lume clone symi-golden symi
-lume run symi --no-display
-```
-
----
-
-## Running 24/7
-
-Keep the VM running by:
-
-- Keeping your Mac plugged in
-- Disabling sleep in System Settings → Energy Saver
-- Using `caffeinate` if needed
-
-For true always-on, consider a dedicated Mac mini or a small VPS. See [VPS hosting](/vps).
-
----
-
-## Troubleshooting
-
-| Problem                  | Solution                                                                       |
-| ------------------------ | ------------------------------------------------------------------------------ |
-| Can't SSH into VM        | Check "Remote Login" is enabled in VM's System Settings                        |
-| VM IP not showing        | Wait for VM to fully boot, run `lume get symi` again                           |
-| Lume command not found   | Add `~/.local/bin` to your PATH                                                |
-| WhatsApp QR not scanning | Ensure you're logged into the VM (not host) when running `symi channels login` |
-
----
-
-## Related docs
-
-- [VPS hosting](/vps)
-- [Nodes](/nodes)
-- [Gateway remote](/gateway/remote)
-- [BlueBubbles channel](/channels/bluebubbles)
-- [Lume Quickstart](https://cua.ai/docs/lume/guide/getting-started/quickstart)
-- [Lume CLI Reference](https://cua.ai/docs/lume/reference/cli-reference)
-- [Unattended VM Setup](https://cua.ai/docs/lume/guide/fundamentals/unattended-setup) (advanced)
-- [Docker Sandboxing](/install/docker) (alternative isolation approach)