alera-cli

# Alera CLI ## Overview Use the `alera` CLI to inspect and modify Alera runtime state. In Alera-managed terminals the app prepends a managed `alera` shim to `PATH` and sets `ALERA_RUNTIME_DIR`, so commands target the same runtime profile used by the UI. When creating or removing Alera workspaces, use `alera workspace add` and `alera workspace remove`. Do not run `git worktree add`, `git worktree remove`, or edit runtime metadata directly unless the user explicitly asks for low-level recovery. ## Quick Checks Start with runtime and inventory checks: These commands are the same from Bash, PowerShell, and CMD: ```bash alera runtime status alera project list alera workspace list --all ``` Use `--json` when you need machine-readable output: These commands are the same from Bash, PowerShell, and CMD: ```bash alera project --json list alera workspace --json list --all ``` Outside Alera terminals, set `ALERA_RUNTIME_DIR` or pass `--runtime-dir` after the command group. From Linux, macOS, or WSL: ```bash ALERA_RUNTIME_DIR="$HOME/.alera/runtime" alera workspace list --all alera workspace --runtime-dir "$HOME/.alera/runtime" list --all ``` From PowerShell: ```powershell $env:ALERA_RUNTIME_DIR = "$HOME\.alera\runtime" alera workspace list --all alera workspace --runtime-dir "$HOME\.alera\runtime" list --all ``` From `cmd.exe`: ```cmd set "ALERA_RUNTIME_DIR=%USERPROFILE%\.alera\runtime" alera workspace list --all alera workspace --runtime-dir "%USERPROFILE%\.alera\runtime...