@m14i/sith 1.22.0 → 1.23.0

package/README.md

@@ -8,163 +8,115 @@
 
 Standardize and share your OpenCode setup with a fully dockerized environment, designed for seamless collaboration and CI integration.
 
-## Usage
+---
 
-### Installation
+## Why?
 
-**Install globally (recommended):**
-```bash
-npm install -g @m14i/sith
-```
-
-**Or use npx (slower, pulls image every time):**
-```bash
-npx @m14i/sith@latest
-```
+AI coding tools are powerful in isolation. They become fragile at scale:
 
-### Quick Start
+- **Context drift** — every developer has a different CLAUDE.md, different tool versions, different configs. The AI sees a different project depending on who's running it.
+- **No CI path** — running `opencode` or `claude` in a pipeline requires wiring tokens, installing tools, and hoping the environment matches local.
+- **Multiple tools** — Claude Code and OpenCode serve different use cases (Anthropic auth vs GitHub Copilot). Switching between them shouldn't require manual setup.
 
-```bash
-# Interactive terminal UI (default)
-sith
-# Type your prompt to start OpenCode with that task
-# Or use slash commands: /shell, /config, /help
-
-# Direct commands
-sith --it          # Launch Docker shell immediately
-sith --pull        # Pull prebuilt image
-sith --build       # Build from scratch
-sith --legacy      # Use legacy menu interface
-```
+Sith solves this by packaging both tools, all config, and your team's context into a single Docker image. One pull, same environment, everywhere.
 
-### Distribution Options
+| Problem | Sith answer |
+|---------|-------------|
+| Inconsistent context across team | Shared `~/.sith/` skills + CLAUDE.md, mounted at runtime |
+| AI tools hard to run in CI | Prebuilt signed image + token injection via env vars |
+| Claude Code vs OpenCode friction | Both available, same container, same command |
+| "Works on my machine" builds | Nix-pinned dependencies inside Docker |
 
-| Method | Command | Speed | Trust Model | Use Case |
-|--------|---------|-------|-------------|----------|
-| **Prebuilt (Recommended)** | `sith --pull` | ⚡ Fast | GitHub Actions + Cosign | Production, CI/CD |
-| **Local Build** | `sith --build` | 🐌 Slow | Your machine | Air-gapped, custom builds |
+---
 
-### Commands
+## Docker
 
-| Command | Description |
-|---------|-------------|
-| `sith` | Interactive terminal UI (Claude Code style) |
-| `sith --it` | Launch Docker shell immediately |
-| `sith --pull` | Pull prebuilt image from GHCR |
-| `sith --build` | Build Docker image from scratch |
-| `sith --legacy` | Use legacy menu interface |
-| `sith --help` | Show all available commands |
+The recommended path. One image, works locally and in CI.
 
-### Terminal UI Usage
+### Install the CLI
 
-When you run `sith`, you get an interactive terminal interface:
+```bash
+npm install -g @m14i/sith
+```
 
-**Prompt input:**
-- Type any text → Starts OpenCode with that prompt using Claude Sonnet 4.6
-- Example: `Fix authentication bug` → OpenCode launches with this task
+Or without installing:
 
-**Slash commands:**
-- `/shell` → Start Docker shell only (no OpenCode)
-- `/config` → Open configuration menu (pull/build options)
-- `/help` → Show available commands
+```bash
+npx @m14i/sith@latest
+```
 
-**Navigation:**
-- `Ctrl+C` or `Esc` → Exit terminal UI
+### Get the image
 
-### Prebuilt Image Details
+**Prebuilt (recommended) — pull a signed image from GHCR:**
 
-**Pull and verify:**
 ```bash
-# Pull (supports linux/amd64 and linux/arm64)
 sith --pull
+```
+
+Supports `linux/amd64` and `linux/arm64`. Images are signed with cosign and include an SBOM.
 
-# Or use Docker directly
-docker pull ghcr.io/merzoukemanouri/sith:latest
+**Verify the signature (optional):**
 
-# Verify signature (optional)
+```bash
 cosign verify \
   --certificate-identity-regexp="https://github.com/MerzoukeMansouri/sith" \
   --certificate-oidc-issuer="https://token.actions.githubusercontent.com" \
   ghcr.io/merzoukemanouri/sith:latest
 ```
 
-**Benefits:**
-- ✅ Fast - no build time
-- ✅ Multi-platform - amd64 and arm64
-- ✅ Signed - cosign verification
-- ✅ SBOM - supply chain transparency
-- ✅ Auto-updated - tracks releases
+**Build from scratch — full control, no external trust:**
 
-## Authentication
-
-Sith supports two AI providers: **Claude Code** (via Anthropic) and **OpenCode** (via GitHub Copilot).
-
-### Claude Code (claude CLI)
-
-Sith ships with the `claude` CLI. Authenticate it with your Anthropic account using a long-lived OAuth token — no API key required.
-
-**Step 1 — Generate the token (once, on your local machine):**
 ```bash
-claude setup-token
+sith --build
 ```
-Follow the browser prompt, then copy the printed token. It is valid for one year and scoped to inference only.
 
-**Step 2 — Export it:**
-```bash
-export CLAUDE_CODE_OAUTH_TOKEN=your_token_here
-```
+| | `sith --pull` | `sith --build` |
+|--|--------------|----------------|
+| Speed | Fast | Slow |
+| Trust | GitHub Actions + Cosign | Your machine |
+| Use case | Daily use, CI/CD | Air-gapped, custom builds |
 
-**Make it persistent (add to ~/.zshrc or ~/.bashrc):**
-```bash
-export CLAUDE_CODE_OAUTH_TOKEN=your_token_here
-```
+### Use it
+
+**Interactive TUI** — type a prompt or use slash commands:
 
-**Verify:**
 ```bash
-claude auth status
-# Should show: "loggedIn": true, "authMethod": "claude.ai"
+sith
 ```
 
-**Requirements:** Claude Pro, Max, Team, or Enterprise subscription.
+| In the TUI | What it does |
+|------------|-------------|
+| Type any text + Enter | Starts OpenCode with that prompt |
+| `/shell` | Drop into Docker shell (no AI) |
+| `/claude` | Switch active tool to Claude Code |
+| `/opencode` | Switch active tool to OpenCode |
+| `/config` | Pull / build options |
+| `/help` | Show commands |
+| `Ctrl+C` / `Esc` | Exit |
 
-### GitHub Copilot (opencode CLI)
+**Direct commands** — skip the TUI:
 
-Sith uses **Claude Sonnet 4.6 via GitHub Copilot** by default for OpenCode. Requires a GitHub token with Copilot access.
-
-**Automatic (recommended):**
-If you have GitHub CLI (`gh`) installed and authenticated, Sith automatically fetches your token:
 ```bash
-sith  # Auto-detects token via gh auth token
+sith shell                        # Raw Nix shell inside Docker (alias: sith --it)
+sith opencode -p "fix the bug"    # OpenCode starts immediately with your task
+sith claude -p "fix the bug"      # Claude Code starts immediately with your task
 ```
 
-**Manual token:**
-If you don't have `gh` CLI or prefer manual setup:
+**Skills:**
 
-1. Ensure you have GitHub Copilot access
-2. Create a token at https://github.com/settings/tokens
-3. Required scopes: `copilot`, `repo`, `read:org`
-4. Export it:
 ```bash
-export GITHUB_TOKEN=gho_your_token_here
-sith
+sith skills    # Install / manage skills from catalog (~/.sith/skills/)
 ```
 
-**Make it persistent (add to ~/.zshrc or ~/.bashrc):**
-```bash
-export GITHUB_TOKEN=$(gh auth token)
-```
+### Cleanup & Uninstall
 
-**Inside container:**
-Once OpenCode starts, authenticate with GitHub Copilot:
 ```bash
-opencode providers login
-# Follow prompts to authenticate with GitHub
+sith --docker-cleanup    # Remove sith Docker images (sith:latest + prebuilt GHCR image)
+sith --uninstall         # Remove ~/.sith/ (skills, config, nix files)
 ```
 
 ### CI / GitHub Actions
 
-Add both tokens as repository secrets, then pass them to the container:
-
 ```yaml
 - name: Run sith
   env:
@@ -177,98 +129,70 @@ Add both tokens as repository secrets, then pass them to the container:
       ghcr.io/merzoukemanouri/sith:latest "claude auth status"
 ```
 
-Generate `CLAUDE_CODE_OAUTH_TOKEN` once with `claude setup-token` and store it in **Settings → Secrets → Actions** as `CLAUDE_CODE_OAUTH_TOKEN`.
+See [Authentication](./doc/AUTH_CLAUDE.md) for how to generate the tokens.
 
-## Features
+---
 
-- **Claude Code-style UI**: Interactive terminal interface with prompt input and slash commands
-- **OpenCode Integration**: Start coding with a simple text prompt
-- **Model Selection**: Uses Claude Sonnet 4.6 via GitHub Copilot by default
-- **Prebuilt Images**: Pull verified images from GitHub Container Registry
-- **Image Signing**: All images signed with cosign for supply chain security
-- **SBOM Attestation**: Software Bill of Materials included with every image
-- **Dockerized Environment**: Consistent setup across machines
-- **Nix Integration**: Full development environment with all tools
-- **CI-Ready**: Standardize builds across local and CI pipelines
-- **Non-root User**: Images run as non-root user (UID 1000) for better security
+## Direct Nix
 
-## Security
+No Docker. Runs the same Nix environment natively on your machine.
 
-### Image Verification
+```bash
+sith --nix-install    # Install Nix package manager (once)
+sith --nix            # Launch Nix shell directly
+```
 
-All Docker images published to `ghcr.io/merzoukemanouri/sith` are:
-- **Signed with cosign** using keyless signing (OIDC)
-- **Include SBOM** (Software Bill of Materials) for transparency
-- **Built automatically** via GitHub Actions with provenance
+Or via the `nix` subcommand:
+
+```bash
+sith nix --install    # Install Nix
+sith nix --shell      # Run Nix shell
+```
 
-See [SECURITY.md](./SECURITY.md) for detailed security practices and considerations.
+**Cleanup:**
 
-### Trust Model
+```bash
+sith --nix-cleanup      # Remove ~/.sith/nix/ + run nix-collect-garbage -d
+sith --nix-uninstall    # Fully remove Nix from system (daemon, /nix/store) — needs sudo
+```
 
-**Prebuilt Images:**
-- Built by GitHub Actions on public infrastructure
-- Signed with Sigstore keyless signing
-- Verifiable provenance chain from source to image
-- Trade-off: Trust GitHub's build infrastructure
+See [doc/NIX_INSTALLATION.md](./doc/NIX_INSTALLATION.md) for full setup guide.
 
-**Local Builds:**
-- Full control over build environment
-- Can inspect Dockerfile before building
-- No dependency on external registries
-- Trade-off: Slower, manual security updates
+---
 
-For more details, see the [Docker Distribution Guide](./doc/QUICKSTART.md#docker-distribution).
+## Authentication
 
-## Development
+Two AI providers, two token setups:
 
-For contributors working on the CLI:
+- **Claude Code** (Anthropic OAuth) → [doc/AUTH_CLAUDE.md](./doc/AUTH_CLAUDE.md)
+- **OpenCode** (GitHub Copilot) → [doc/AUTH_OPENCODE.md](./doc/AUTH_OPENCODE.md)
 
-```bash
-# Install dependencies
-pnpm install
+---
 
-# Run in development mode (no build)
-pnpm dev
+## Development
 
-# Build and test
+```bash
+pnpm install       # Install dependencies
+pnpm dev           # Run in development mode (no build)
 pnpm dev:build     # Build and run CLI
 pnpm dev:shell     # Build and launch shell
-
-# Type checking
-pnpm typecheck
-
-# Clean build artifacts
-pnpm clean
+pnpm typecheck     # Type checking
+pnpm clean         # Clean build artifacts
 ```
 
-## Publishing
-
-Automated releases using semantic-release and conventional commits.
+---
 
-### For Maintainers
+## Publishing
 
-**Commit Format:**
-- `feat:` - New feature (triggers minor version bump)
-- `fix:` - Bug fix (triggers patch version bump)
-- `BREAKING CHANGE:` - Breaking change (triggers major version bump)
-- `chore:`, `docs:`, `style:` - No release
+Automated via semantic-release and conventional commits.
 
-**Release Process:**
-1. Commit changes following conventional commit format
-2. Push to `main` branch
-3. GitHub Action automatically:
-   - Analyzes commits and determines version bump
-   - Generates CHANGELOG.md
-   - Creates GitHub release
-   - Publishes to npm
+| Prefix | Effect |
+|--------|--------|
+| `feat:` | Minor version bump |
+| `fix:` | Patch version bump |
+| `BREAKING CHANGE:` | Major version bump |
+| `chore:` `docs:` `style:` | No release |
 
-**Example:**
-```bash
-git commit -m "feat: add new interactive menu option"
-git push origin main
-# Automatic release triggered!
-```
+Push to `main` → GitHub Action bumps version, generates CHANGELOG, publishes to npm.
 
-**Requirements:**
-- `NPM_TOKEN` secret configured in GitHub repository settings
-- Commits must follow conventional commit format
+**Requirements:** `NPM_TOKEN` secret in repository settings.

package/dist/commands/docker.d.ts

@@ -1,4 +1,3 @@
 import type { DockerCommandOptions } from "../types.js";
 export declare function dockerCommand(options: DockerCommandOptions): Promise<void>;
-export declare function runShellDirect(): Promise<void>;
 //# sourceMappingURL=docker.d.ts.map

package/dist/commands/docker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["file:///home/runner/work/sith/sith/src/commands/docker.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEX,oBAAoB,EAEpB,MAAM,aAAa,CAAC;AAqTrB,wBAAsB,aAAa,CAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD"}
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["file:///home/runner/work/sith/sith/src/commands/docker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAwBxD,wBAAsB,aAAa,CAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/commands/maintenance.d.ts

@@ -0,0 +1,5 @@
+export declare function dockerCleanupCommand(): Promise<void>;
+export declare function nixCleanupCommand(): Promise<void>;
+export declare function nixUninstallCommand(): Promise<void>;
+export declare function uninstallCommand(): Promise<void>;
+//# sourceMappingURL=maintenance.d.ts.map

package/dist/commands/maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["file:///home/runner/work/sith/sith/src/commands/maintenance.ts"],"names":[],"mappings":"AAkBA,wBAAsB,oBAAoB,kBAwBzC;AAED,wBAAsB,iBAAiB,kBAqBtC;AAED,wBAAsB,mBAAmB,kBAmExC;AAED,wBAAsB,gBAAgB,kBAwBrC"}

package/dist/index.js

@@ -42961,35 +42961,20 @@ which.sync = whichSync
 
 /***/ }),
 
-/***/ 5515:
-/***/ ((module, __webpack_exports__, __nccwpck_require__) => {
+/***/ 3361:
+/***/ ((__unused_webpack_module, __webpack_exports__, __nccwpck_require__) => {
 
-__nccwpck_require__.a(module, async (__webpack_handle_async_dependencies__, __webpack_async_result__) => { try {
 /* harmony export */ __nccwpck_require__.d(__webpack_exports__, {
 /* harmony export */   Q: () => (/* binding */ dockerCommand)
 /* harmony export */ });
-/* unused harmony export runShellDirect */
 /* harmony import */ var node_fs__WEBPACK_IMPORTED_MODULE_0__ = __nccwpck_require__(3024);
 /* harmony import */ var node_fs__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__nccwpck_require__.n(node_fs__WEBPACK_IMPORTED_MODULE_0__);
 /* harmony import */ var node_path__WEBPACK_IMPORTED_MODULE_1__ = __nccwpck_require__(6760);
 /* harmony import */ var node_path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__nccwpck_require__.n(node_path__WEBPACK_IMPORTED_MODULE_1__);
 /* harmony import */ var node_url__WEBPACK_IMPORTED_MODULE_2__ = __nccwpck_require__(3136);
 /* harmony import */ var node_url__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__nccwpck_require__.n(node_url__WEBPACK_IMPORTED_MODULE_2__);
-/* harmony import */ var execa__WEBPACK_IMPORTED_MODULE_9__ = __nccwpck_require__(6181);
-/* harmony import */ var ink__WEBPACK_IMPORTED_MODULE_3__ = __nccwpck_require__(3816);
-/* harmony import */ var react__WEBPACK_IMPORTED_MODULE_4__ = __nccwpck_require__(2864);
-/* harmony import */ var react__WEBPACK_IMPORTED_MODULE_4___default = /*#__PURE__*/__nccwpck_require__.n(react__WEBPACK_IMPORTED_MODULE_4__);
-/* harmony import */ var _config_js__WEBPACK_IMPORTED_MODULE_5__ = __nccwpck_require__(6878);
-/* harmony import */ var _utils_launcher_js__WEBPACK_IMPORTED_MODULE_6__ = __nccwpck_require__(5800);
-/* harmony import */ var _nix_js__WEBPACK_IMPORTED_MODULE_7__ = __nccwpck_require__(9922);
-/* harmony import */ var _skills_js__WEBPACK_IMPORTED_MODULE_8__ = __nccwpck_require__(9805);
-var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([ink__WEBPACK_IMPORTED_MODULE_3__, _skills_js__WEBPACK_IMPORTED_MODULE_8__]);
-([ink__WEBPACK_IMPORTED_MODULE_3__, _skills_js__WEBPACK_IMPORTED_MODULE_8__] = __webpack_async_dependencies__.then ? (await __webpack_async_dependencies__)() : __webpack_async_dependencies__);
-
-
-
-
-
+/* harmony import */ var execa__WEBPACK_IMPORTED_MODULE_4__ = __nccwpck_require__(6181);
+/* harmony import */ var _config_js__WEBPACK_IMPORTED_MODULE_3__ = __nccwpck_require__(6878);
 
 
 
@@ -43001,217 +42986,15 @@ function findProjectRoot(startDir) {
     let currentDir = startDir;
     const rootPath = node_path__WEBPACK_IMPORTED_MODULE_1___default().parse(currentDir).root;
     while (currentDir !== rootPath) {
-        const dockerPath = node_path__WEBPACK_IMPORTED_MODULE_1___default().join(currentDir, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.folderName);
+        const dockerPath = node_path__WEBPACK_IMPORTED_MODULE_1___default().join(currentDir, _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.folderName);
         if (node_fs__WEBPACK_IMPORTED_MODULE_0___default().existsSync(dockerPath) && node_fs__WEBPACK_IMPORTED_MODULE_0___default().statSync(dockerPath).isDirectory()) {
             return currentDir;
         }
         currentDir = node_path__WEBPACK_IMPORTED_MODULE_1___default().dirname(currentDir);
     }
-    throw new Error(`Could not find project root (${_config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.folderName}/ folder not found)`);
+    throw new Error(`Could not find project root (${_config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.folderName}/ folder not found)`);
 }
 const rootDir = findProjectRoot(__dirname);
-const menuItems = [
-    { label: "Enter Shell", value: "shell", icon: "🚀" },
-    { label: "Manage Skills", value: "skills", icon: "🧠" },
-    { label: "Configuration", value: "config", icon: "⚙️" },
-];
-const configMenuItems = [
-    { label: "Pull prebuilt image (recommended)", value: "pull", icon: "📦" },
-    { label: "Build Docker image from scratch", value: "build", icon: "🔨" },
-    { label: "Install Nix locally (no Docker)", value: "nix", icon: "❄️" },
-    { label: "Back", value: "back", icon: "◀️" },
-];
-function Logo() {
-    return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column", marginBottom: 1 },
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column" }, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .ASCII_LOGO */ .mF.map((line, index) => (
-        // biome-ignore lint/suspicious/noArrayIndexKey: static array, order never changes
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { key: index, color: "red", bold: true }, line)))),
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { borderStyle: "double", borderColor: "red", paddingX: 2, marginTop: 1 },
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { color: "red", bold: true }, "SITH - Docker Manager"))));
-}
-function BuildingSpinner({ step }) {
-    const [frame, setFrame] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)(0);
-    (0,react__WEBPACK_IMPORTED_MODULE_4__.useEffect)(() => {
-        const timer = setInterval(() => {
-            setFrame((prev) => (prev + 1) % _config_js__WEBPACK_IMPORTED_MODULE_5__/* .SPINNER_CONFIG */ .ZC.frames.length);
-        }, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .SPINNER_CONFIG */ .ZC.interval);
-        return () => clearInterval(timer);
-    }, []);
-    return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column", marginTop: 1 },
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { color: "cyan" },
-            _config_js__WEBPACK_IMPORTED_MODULE_5__/* .SPINNER_CONFIG */ .ZC.frames[frame],
-            " ",
-            step)));
-}
-function Menu() {
-    const { exit } = (0,ink__WEBPACK_IMPORTED_MODULE_3__/* .useApp */ .nm)();
-    const [selectedIndex, setSelectedIndex] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)(0);
-    const [isProcessing, setIsProcessing] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)(false);
-    const [processStep, setProcessStep] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)("");
-    const [processComplete, setProcessComplete] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)(false);
-    const [processError, setProcessError] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)(null);
-    const [currentMenu, setCurrentMenu] = (0,react__WEBPACK_IMPORTED_MODULE_4__.useState)("main");
-    (0,ink__WEBPACK_IMPORTED_MODULE_3__/* .useInput */ .Ge)((_input, key) => {
-        if (isProcessing) {
-            return;
-        }
-        // Exit on any key press when process is complete or errored
-        if (processComplete || processError) {
-            exit();
-            return;
-        }
-        const items = currentMenu === "main" ? menuItems : configMenuItems;
-        if (key.upArrow) {
-            setSelectedIndex((prev) => (prev > 0 ? prev - 1 : items.length - 1));
-        }
-        else if (key.downArrow) {
-            setSelectedIndex((prev) => (prev < items.length - 1 ? prev + 1 : 0));
-        }
-        else if (key.return) {
-            handleSelection(items[selectedIndex].value);
-        }
-    });
-    async function handleSelection(value) {
-        switch (value) {
-            case "shell":
-                exit();
-                await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_6__/* .launchShell */ .k1)();
-                return;
-            case "skills":
-                exit();
-                (0,_skills_js__WEBPACK_IMPORTED_MODULE_8__/* .skillsCommand */ .a)();
-                return;
-            case "config":
-                setCurrentMenu("config");
-                setSelectedIndex(0);
-                return;
-            case "back":
-                setCurrentMenu("main");
-                setSelectedIndex(0);
-                return;
-            case "pull":
-                await handlePullCommand();
-                break;
-            case "build":
-                await handleBuildCommand();
-                break;
-            case "nix":
-                await handleNixCommand();
-                break;
-            default:
-                break;
-        }
-    }
-    async function handlePullCommand() {
-        setIsProcessing(true);
-        setProcessStep("Pulling prebuilt Docker image...");
-        try {
-            await (0,execa__WEBPACK_IMPORTED_MODULE_9__/* .execa */ .Ho)("docker", ["pull", _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.prebuiltImage], {
-                stdio: "inherit",
-            });
-            // Tag the pulled image with local name for compatibility
-            await (0,execa__WEBPACK_IMPORTED_MODULE_9__/* .execa */ .Ho)("docker", ["tag", _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.prebuiltImage, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName], {
-                stdio: "inherit",
-            });
-            setIsProcessing(false);
-            setProcessComplete(true);
-            setProcessStep("");
-        }
-        catch (error) {
-            setIsProcessing(false);
-            setProcessError(error instanceof Error ? error.message : "Pull failed");
-        }
-    }
-    async function handleNixCommand() {
-        setIsProcessing(true);
-        setProcessStep("Installing Nix locally...");
-        try {
-            await (0,_nix_js__WEBPACK_IMPORTED_MODULE_7__/* .installNix */ .Fh)();
-            await (0,_nix_js__WEBPACK_IMPORTED_MODULE_7__/* .copyNixFiles */ .Qi)();
-            setIsProcessing(false);
-            setProcessComplete(true);
-            setProcessStep("");
-        }
-        catch (error) {
-            setIsProcessing(false);
-            setProcessError(error instanceof Error ? error.message : "Nix installation failed");
-        }
-    }
-    async function handleBuildCommand() {
-        setIsProcessing(true);
-        setProcessStep("Building Docker image from scratch...");
-        try {
-            const dockerfilePath = node_path__WEBPACK_IMPORTED_MODULE_1___default().join(rootDir, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.folderName, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.dockerfileName);
-            if (!node_fs__WEBPACK_IMPORTED_MODULE_0___default().existsSync(dockerfilePath)) {
-                throw new Error(`Dockerfile not found at: ${dockerfilePath}`);
-            }
-            await (0,execa__WEBPACK_IMPORTED_MODULE_9__/* .execa */ .Ho)("docker", ["build", "-f", dockerfilePath, "-t", _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName, rootDir], {
-                stdio: "inherit",
-            });
-            setIsProcessing(false);
-            setProcessComplete(true);
-            setProcessStep("");
-        }
-        catch (error) {
-            setIsProcessing(false);
-            setProcessError(error instanceof Error ? error.message : "Operation failed");
-        }
-    }
-    // Render error state
-    if (processError) {
-        return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column" },
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(Logo, null),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { color: "red" },
-                    "\u274C Operation failed: ",
-                    processError)),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { dimColor: true }, "Press any key to exit..."))));
-    }
-    // Render success state
-    if (processComplete) {
-        return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column" },
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(Logo, null),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { color: "green" }, "\u2705 Docker image ready!")),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { dimColor: true },
-                    "Image: ",
-                    _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName)),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { dimColor: true }, "Run: sith --it")),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { dimColor: true }, "Press any key to exit..."))));
-    }
-    // Render processing state
-    if (isProcessing) {
-        return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column" },
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(Logo, null),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(BuildingSpinner, { step: processStep }),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-                react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { dimColor: true },
-                    "Root: ",
-                    rootDir))));
-    }
-    // Render menu state
-    const items = currentMenu === "main" ? menuItems : configMenuItems;
-    const menuTitle = currentMenu === "main" ? "What would you like to do?" : "Configuration";
-    return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column" },
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(Logo, null),
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column", marginTop: 1 },
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { bold: true }, menuTitle),
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { flexDirection: "column", marginTop: 1 }, items.map((item, index) => {
-                const isSelected = index === selectedIndex;
-                return (react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { key: item.value, marginY: 0 },
-                    react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { color: isSelected ? "cyan" : undefined },
-                        isSelected ? "❯ " : "  ",
-                        item.icon,
-                        " ",
-                        item.label)));
-            }))),
-        react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Box */ .az, { marginTop: 1 },
-            react__WEBPACK_IMPORTED_MODULE_4___default().createElement(ink__WEBPACK_IMPORTED_MODULE_3__/* .Text */ .EY, { dimColor: true }, "Use arrow keys to navigate, Enter to select"))));
-}
 async function dockerCommand(options) {
     if (options.build) {
         await buildDocker();
@@ -43221,36 +43004,25 @@ async function dockerCommand(options) {
         await pullDocker();
         return;
     }
-    // Check if stdin supports raw mode (interactive terminal)
-    if (!process.stdin.isTTY) {
-        console.error("Error: Interactive mode requires a TTY terminal");
-        console.error("Use --build or --pull flag for non-interactive mode");
-        process.exit(1);
-    }
-    // Render the interactive menu
-    (0,ink__WEBPACK_IMPORTED_MODULE_3__/* .render */ .XX)(react__WEBPACK_IMPORTED_MODULE_4___default().createElement(Menu, null));
-}
-async function runShellDirect() {
-    await launchShell();
 }
 async function pullDocker() {
     console.log("📦 Pulling prebuilt Docker image...");
     console.log();
     try {
-        console.log(`Source: ${_config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.prebuiltImage}`);
-        console.log(`Target: ${_config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName}`);
+        console.log(`Source: ${_config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.prebuiltImage}`);
+        console.log(`Target: ${_config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.imageName}`);
         console.log();
-        await (0,execa__WEBPACK_IMPORTED_MODULE_9__/* .execa */ .Ho)("docker", ["pull", _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.prebuiltImage], {
+        await (0,execa__WEBPACK_IMPORTED_MODULE_4__/* .execa */ .Ho)("docker", ["pull", _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.prebuiltImage], {
             stdio: "inherit",
         });
         console.log();
         console.log("🏷️  Tagging image for local use...");
-        await (0,execa__WEBPACK_IMPORTED_MODULE_9__/* .execa */ .Ho)("docker", ["tag", _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.prebuiltImage, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName], {
+        await (0,execa__WEBPACK_IMPORTED_MODULE_4__/* .execa */ .Ho)("docker", ["tag", _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.prebuiltImage, _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.imageName], {
             stdio: "inherit",
         });
         console.log();
         console.log("✅ Docker image ready!");
-        console.log(`Image: ${_config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName}`);
+        console.log(`Image: ${_config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.imageName}`);
         console.log();
         console.log("Run: sith --it");
     }
@@ -43266,19 +43038,19 @@ async function buildDocker() {
     console.log("🔨 Building Docker image from scratch...");
     console.log();
     try {
-        const dockerfilePath = node_path__WEBPACK_IMPORTED_MODULE_1___default().join(rootDir, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.folderName, _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.dockerfileName);
+        const dockerfilePath = node_path__WEBPACK_IMPORTED_MODULE_1___default().join(rootDir, _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.folderName, _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.dockerfileName);
         if (!node_fs__WEBPACK_IMPORTED_MODULE_0___default().existsSync(dockerfilePath)) {
             throw new Error(`Dockerfile not found at: ${dockerfilePath}`);
         }
         console.log(`Root: ${rootDir}`);
         console.log(`Dockerfile: ${dockerfilePath}`);
         console.log();
-        await (0,execa__WEBPACK_IMPORTED_MODULE_9__/* .execa */ .Ho)("docker", ["build", "-f", dockerfilePath, "-t", _config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName, rootDir], {
+        await (0,execa__WEBPACK_IMPORTED_MODULE_4__/* .execa */ .Ho)("docker", ["build", "-f", dockerfilePath, "-t", _config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.imageName, rootDir], {
             stdio: "inherit",
         });
         console.log();
         console.log("✅ Docker image built successfully!");
-        console.log(`Image: ${_config_js__WEBPACK_IMPORTED_MODULE_5__/* .DOCKER_CONFIG */ .e6.imageName}`);
+        console.log(`Image: ${_config_js__WEBPACK_IMPORTED_MODULE_3__/* .DOCKER_CONFIG */ .e6.imageName}`);
         console.log();
         console.log("Run: sith --it");
     }
@@ -43291,8 +43063,162 @@ async function buildDocker() {
     }
 }
 
-__webpack_async_result__();
-} catch(e) { __webpack_async_result__(e); } });
+
+/***/ }),
+
+/***/ 6656:
+/***/ ((__unused_webpack_module, __webpack_exports__, __nccwpck_require__) => {
+
+
+// EXPORTS
+__nccwpck_require__.d(__webpack_exports__, {
+  Yb: () => (/* binding */ dockerCleanupCommand),
+  V: () => (/* binding */ nixCleanupCommand),
+  be: () => (/* binding */ nixUninstallCommand),
+  Wd: () => (/* binding */ uninstallCommand)
+});
+
+// EXTERNAL MODULE: external "node:child_process"
+var external_node_child_process_ = __nccwpck_require__(1421);
+// EXTERNAL MODULE: external "node:fs"
+var external_node_fs_ = __nccwpck_require__(3024);
+// EXTERNAL MODULE: external "node:os"
+var external_node_os_ = __nccwpck_require__(8161);
+// EXTERNAL MODULE: external "node:path"
+var external_node_path_ = __nccwpck_require__(6760);
+;// CONCATENATED MODULE: external "node:readline"
+const external_node_readline_namespaceObject = __WEBPACK_EXTERNAL_createRequire(import.meta.url)("node:readline");
+// EXTERNAL MODULE: ./node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/index.js + 3 modules
+var source = __nccwpck_require__(9611);
+// EXTERNAL MODULE: ./src/config.ts
+var config = __nccwpck_require__(6878);
+;// CONCATENATED MODULE: ./src/commands/maintenance.ts
+
+
+
+
+
+
+
+async function maintenance_confirm(question) {
+    const rl = (0,external_node_readline_namespaceObject.createInterface)({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y");
+        });
+    });
+}
+async function dockerCleanupCommand() {
+    console.log(source/* default */.Ay.cyan("Cleaning up sith Docker images..."));
+    const images = [config/* DOCKER_CONFIG */.e6.imageName, config/* DOCKER_CONFIG */.e6.prebuiltImage];
+    let removed = 0;
+    for (const image of images) {
+        try {
+            (0,external_node_child_process_.execSync)(`docker image inspect ${image} 2>/dev/null`, {
+                stdio: "ignore",
+            });
+            console.log(source/* default */.Ay.dim(`  Removing ${image}...`));
+            (0,external_node_child_process_.execSync)(`docker rmi ${image}`, { stdio: "inherit" });
+            removed++;
+        }
+        catch {
+            // image not present
+        }
+    }
+    if (removed === 0) {
+        console.log(source/* default */.Ay.yellow("No sith Docker images found."));
+    }
+    else {
+        console.log(source/* default */.Ay.green(`✓ Removed ${removed} image(s).`));
+    }
+}
+async function nixCleanupCommand() {
+    const nixDir = (0,external_node_path_.join)((0,external_node_os_.homedir)(), ".sith", "nix");
+    console.log(source/* default */.Ay.cyan("Cleaning up sith Nix files..."));
+    if ((0,external_node_fs_.existsSync)(nixDir)) {
+        (0,external_node_fs_.rmSync)(nixDir, { recursive: true, force: true });
+        console.log(source/* default */.Ay.green(`✓ Removed ${nixDir}`));
+    }
+    else {
+        console.log(source/* default */.Ay.yellow(`${nixDir} not found — nothing to remove.`));
+    }
+    console.log(source/* default */.Ay.cyan("Running nix-collect-garbage..."));
+    try {
+        (0,external_node_child_process_.execSync)("nix-collect-garbage -d", { stdio: "inherit" });
+        console.log(source/* default */.Ay.green("✓ Nix store garbage collected."));
+    }
+    catch {
+        console.log(source/* default */.Ay.yellow("nix-collect-garbage failed — Nix may not be installed."));
+    }
+}
+async function nixUninstallCommand() {
+    console.log(source/* default */.Ay.yellow("This will fully remove Nix from your system:"));
+    console.log(source/* default */.Ay.dim("  /nix/store, Nix daemon, shell profile entries"));
+    console.log();
+    const ok = await maintenance_confirm(source/* default */.Ay.red("Continue? [y/N] "));
+    if (!ok) {
+        console.log(source/* default */.Ay.dim("Aborted."));
+        return;
+    }
+    const platform = process.platform;
+    if (platform === "darwin") {
+        console.log(source/* default */.Ay.cyan("Uninstalling Nix (macOS multi-user)..."));
+        try {
+            // Official macOS uninstall sequence
+            (0,external_node_child_process_.execSync)("sudo launchctl unload /Library/LaunchDaemons/org.nixos.nix-daemon.plist 2>/dev/null || true", { stdio: "inherit" });
+            (0,external_node_child_process_.execSync)("sudo rm -f /Library/LaunchDaemons/org.nixos.nix-daemon.plist", {
+                stdio: "inherit",
+            });
+            (0,external_node_child_process_.execSync)("sudo diskutil apfs deleteVolume /nix 2>/dev/null || sudo rm -rf /nix", { stdio: "inherit" });
+            (0,external_node_child_process_.execSync)("sudo rm -rf /etc/nix /etc/profile.d/nix.sh /etc/bashrc.d/nix.sh", { stdio: "inherit" });
+            console.log(source/* default */.Ay.green("✓ Nix removed. Remove nix lines from ~/.zshrc / ~/.bashrc manually if present."));
+        }
+        catch (_e) {
+            console.log(source/* default */.Ay.red("Uninstall failed. Run with sudo or check errors above."));
+        }
+    }
+    else if (platform === "linux") {
+        console.log(source/* default */.Ay.cyan("Uninstalling Nix (Linux)..."));
+        try {
+            (0,external_node_child_process_.execSync)("sudo systemctl stop nix-daemon 2>/dev/null || true", {
+                stdio: "inherit",
+            });
+            (0,external_node_child_process_.execSync)("sudo systemctl disable nix-daemon 2>/dev/null || true", {
+                stdio: "inherit",
+            });
+            (0,external_node_child_process_.execSync)("sudo rm -rf /nix /etc/nix", { stdio: "inherit" });
+            console.log(source/* default */.Ay.green("✓ Nix removed. Remove nix lines from ~/.profile / ~/.bashrc manually if present."));
+        }
+        catch {
+            console.log(source/* default */.Ay.red("Uninstall failed. Run with sudo or check errors above."));
+        }
+    }
+    else {
+        console.log(source/* default */.Ay.red(`Unsupported platform: ${platform}. Uninstall manually.`));
+    }
+}
+async function uninstallCommand() {
+    const sithDir = (0,external_node_path_.join)((0,external_node_os_.homedir)(), ".sith");
+    console.log(source/* default */.Ay.yellow("This will delete:"));
+    console.log(source/* default */.Ay.dim(`  ${sithDir}  (skills, config, nix files)`));
+    console.log();
+    const ok = await maintenance_confirm(source/* default */.Ay.red("Continue? [y/N] "));
+    if (!ok) {
+        console.log(source/* default */.Ay.dim("Aborted."));
+        return;
+    }
+    if ((0,external_node_fs_.existsSync)(sithDir)) {
+        (0,external_node_fs_.rmSync)(sithDir, { recursive: true, force: true });
+        console.log(source/* default */.Ay.green(`✓ Removed ${sithDir}`));
+    }
+    else {
+        console.log(source/* default */.Ay.yellow(`${sithDir} not found — nothing to remove.`));
+    }
+    console.log();
+    console.log(source/* default */.Ay.dim(`Run ${source/* default */.Ay.bold("npm uninstall -g sith")} to remove the CLI.`));
+}
+
 
 /***/ }),
 
@@ -43301,11 +43227,9 @@ __webpack_async_result__();
 
 /* harmony export */ __nccwpck_require__.d(__webpack_exports__, {
 /* harmony export */   Dv: () => (/* binding */ nixCommand),
-/* harmony export */   Fh: () => (/* binding */ installNix),
-/* harmony export */   Qi: () => (/* binding */ copyNixFiles),
 /* harmony export */   nb: () => (/* binding */ runNixShell)
 /* harmony export */ });
-/* unused harmony exports parseNixVersionOutput, checkNixInstalled */
+/* unused harmony exports parseNixVersionOutput, checkNixInstalled, installNix, copyNixFiles */
 /* harmony import */ var node_fs__WEBPACK_IMPORTED_MODULE_0__ = __nccwpck_require__(3024);
 /* harmony import */ var node_fs__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__nccwpck_require__.n(node_fs__WEBPACK_IMPORTED_MODULE_0__);
 /* harmony import */ var node_os__WEBPACK_IMPORTED_MODULE_1__ = __nccwpck_require__(8161);
@@ -44018,10 +43942,10 @@ __webpack_async_result__();
 /* harmony export */ __nccwpck_require__.d(__webpack_exports__, {
 /* harmony export */   XI: () => (/* binding */ SKILLS_CATALOG),
 /* harmony export */   Z3: () => (/* binding */ NIX_CONFIG),
-/* harmony export */   ZC: () => (/* binding */ SPINNER_CONFIG),
 /* harmony export */   e6: () => (/* binding */ DOCKER_CONFIG),
 /* harmony export */   mF: () => (/* binding */ ASCII_LOGO)
 /* harmony export */ });
+/* unused harmony export SPINNER_CONFIG */
 // Predefined skill catalog — skills are installed to ~/.sith/skills/<name>/
 const SKILLS_CATALOG = [
     {
@@ -44119,16 +44043,18 @@ __nccwpck_require__.a(module, async (__webpack_handle_async_dependencies__, __we
 /* harmony import */ var node_path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__nccwpck_require__.n(node_path__WEBPACK_IMPORTED_MODULE_1__);
 /* harmony import */ var node_url__WEBPACK_IMPORTED_MODULE_2__ = __nccwpck_require__(3136);
 /* harmony import */ var node_url__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__nccwpck_require__.n(node_url__WEBPACK_IMPORTED_MODULE_2__);
-/* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_10__ = __nccwpck_require__(9611);
+/* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_11__ = __nccwpck_require__(9611);
 /* harmony import */ var commander__WEBPACK_IMPORTED_MODULE_3__ = __nccwpck_require__(2202);
-/* harmony import */ var update_notifier__WEBPACK_IMPORTED_MODULE_9__ = __nccwpck_require__(6213);
-/* harmony import */ var _commands_docker_js__WEBPACK_IMPORTED_MODULE_4__ = __nccwpck_require__(5515);
-/* harmony import */ var _commands_nix_js__WEBPACK_IMPORTED_MODULE_5__ = __nccwpck_require__(9922);
-/* harmony import */ var _commands_skills_js__WEBPACK_IMPORTED_MODULE_6__ = __nccwpck_require__(9805);
-/* harmony import */ var _components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_7__ = __nccwpck_require__(3535);
-/* harmony import */ var _utils_launcher_js__WEBPACK_IMPORTED_MODULE_8__ = __nccwpck_require__(5800);
-var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([_commands_docker_js__WEBPACK_IMPORTED_MODULE_4__, _commands_skills_js__WEBPACK_IMPORTED_MODULE_6__, _components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_7__]);
-([_commands_docker_js__WEBPACK_IMPORTED_MODULE_4__, _commands_skills_js__WEBPACK_IMPORTED_MODULE_6__, _components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_7__] = __webpack_async_dependencies__.then ? (await __webpack_async_dependencies__)() : __webpack_async_dependencies__);
+/* harmony import */ var update_notifier__WEBPACK_IMPORTED_MODULE_10__ = __nccwpck_require__(6213);
+/* harmony import */ var _commands_docker_js__WEBPACK_IMPORTED_MODULE_4__ = __nccwpck_require__(3361);
+/* harmony import */ var _commands_maintenance_js__WEBPACK_IMPORTED_MODULE_5__ = __nccwpck_require__(6656);
+/* harmony import */ var _commands_nix_js__WEBPACK_IMPORTED_MODULE_6__ = __nccwpck_require__(9922);
+/* harmony import */ var _commands_skills_js__WEBPACK_IMPORTED_MODULE_7__ = __nccwpck_require__(9805);
+/* harmony import */ var _components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_8__ = __nccwpck_require__(3535);
+/* harmony import */ var _utils_launcher_js__WEBPACK_IMPORTED_MODULE_9__ = __nccwpck_require__(5800);
+var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([_commands_skills_js__WEBPACK_IMPORTED_MODULE_7__, _components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_8__]);
+([_commands_skills_js__WEBPACK_IMPORTED_MODULE_7__, _components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_8__] = __webpack_async_dependencies__.then ? (await __webpack_async_dependencies__)() : __webpack_async_dependencies__);
+
 
 
 
@@ -44148,12 +44074,12 @@ const PROGRAM_NAME = "sith";
 const PROGRAM_VERSION = pkg.version;
 const PROGRAM_DESCRIPTION = "Turn your context to the dark side. Standardize and share your OpenCode setup with a fully dockerized environment, designed for seamless collaboration and CI integration.";
 // Check for updates (automatic background check)
-const notifier = (0,update_notifier__WEBPACK_IMPORTED_MODULE_9__/* ["default"] */ .A)({ pkg });
+const notifier = (0,update_notifier__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .A)({ pkg });
 notifier.notify();
 async function checkForUpdates() {
-    console.log(chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.cyan("Checking for updates..."));
+    console.log(chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.cyan("Checking for updates..."));
     // Force update check by setting updateCheckInterval to 0
-    const notifier = (0,update_notifier__WEBPACK_IMPORTED_MODULE_9__/* ["default"] */ .A)({
+    const notifier = (0,update_notifier__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .A)({
         pkg,
         updateCheckInterval: 0,
     });
@@ -44162,12 +44088,12 @@ async function checkForUpdates() {
     const update = notifier.update;
     if (update && update.latest !== pkg.version) {
         console.log();
-        console.log(chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.green(`Update available: ${chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.dim(pkg.version)} → ${chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.bold(update.latest)}`));
-        console.log(chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.cyan(`Run ${chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.bold(`npm install -g ${pkg.name}`)} to update`));
+        console.log(chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.green(`Update available: ${chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.dim(pkg.version)} → ${chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.bold(update.latest)}`));
+        console.log(chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.cyan(`Run ${chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.bold(`npm install -g ${pkg.name}`)} to update`));
         console.log();
     }
     else {
-        console.log(chalk__WEBPACK_IMPORTED_MODULE_10__/* ["default"] */ .Ay.green(`✓ You're on the latest version (${pkg.version})`));
+        console.log(chalk__WEBPACK_IMPORTED_MODULE_11__/* ["default"] */ .Ay.green(`✓ You're on the latest version (${pkg.version})`));
     }
 }
 function createProgram() {
@@ -44182,52 +44108,57 @@ function createProgram() {
         .option("--nix", "Use native Nix shell (no Docker)")
         .option("--nix-install", "Install Nix package manager locally")
         .option("--update", "Check for updates")
-        .option("--legacy", "Use legacy menu interface");
-    // Default action - show terminal UI or legacy menu
+        .option("--docker-cleanup", "Remove sith Docker images from local machine")
+        .option("--nix-cleanup", "Remove ~/.sith/nix and run nix-collect-garbage")
+        .option("--nix-uninstall", "Fully remove Nix from the system (daemon, /nix/store)")
+        .option("--uninstall", "Remove ~/.sith config directory");
+    // Default action - show terminal UI
     program.action(async (options) => {
-        if (options.update) {
+        if (options.dockerCleanup) {
+            await (0,_commands_maintenance_js__WEBPACK_IMPORTED_MODULE_5__/* .dockerCleanupCommand */ .Yb)();
+        }
+        else if (options.nixCleanup) {
+            await (0,_commands_maintenance_js__WEBPACK_IMPORTED_MODULE_5__/* .nixCleanupCommand */ .V)();
+        }
+        else if (options.nixUninstall) {
+            await (0,_commands_maintenance_js__WEBPACK_IMPORTED_MODULE_5__/* .nixUninstallCommand */ .be)();
+        }
+        else if (options.uninstall) {
+            await (0,_commands_maintenance_js__WEBPACK_IMPORTED_MODULE_5__/* .uninstallCommand */ .Wd)();
+        }
+        else if (options.update) {
             await checkForUpdates();
         }
         else if (options.nix) {
-            await (0,_commands_nix_js__WEBPACK_IMPORTED_MODULE_5__/* .runNixShell */ .nb)();
+            await (0,_commands_nix_js__WEBPACK_IMPORTED_MODULE_6__/* .runNixShell */ .nb)();
         }
         else if (options.nixInstall) {
-            await (0,_commands_nix_js__WEBPACK_IMPORTED_MODULE_5__/* .nixCommand */ .Dv)({ install: true });
+            await (0,_commands_nix_js__WEBPACK_IMPORTED_MODULE_6__/* .nixCommand */ .Dv)({ install: true });
         }
         else if (options.it) {
-            await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_8__/* .launchShell */ .k1)();
+            await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_9__/* .launchShell */ .k1)();
         }
-        else if (options.legacy || options.pull || options.build) {
-            // Use legacy menu for explicit pull/build or --legacy flag
+        else if (options.pull || options.build) {
             await (0,_commands_docker_js__WEBPACK_IMPORTED_MODULE_4__/* .dockerCommand */ .Q)(options);
         }
         else {
             // Default: show new terminal UI
-            (0,_components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_7__/* .renderTerminalUI */ .t)();
+            (0,_components_TerminalUI_js__WEBPACK_IMPORTED_MODULE_8__/* .renderTerminalUI */ .t)();
         }
     });
-    // Docker command - explicit Docker management
-    program
-        .command("docker")
-        .description("Manage Docker environment")
-        .option("--pull", "Pull prebuilt Docker image (recommended)")
-        .option("--build", "Build the Docker image from scratch")
-        .action(async (options) => {
-        await (0,_commands_docker_js__WEBPACK_IMPORTED_MODULE_4__/* .dockerCommand */ .Q)(options);
-    });
     // Shell command - direct interactive shell (bypasses menu)
     program
         .command("shell")
         .description("Run interactive shell in Docker container")
         .action(async () => {
-        await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_8__/* .launchShell */ .k1)();
+        await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_9__/* .launchShell */ .k1)();
     });
     // Skills command - install/uninstall skills from catalog
     program
         .command("skills")
         .description("Manage skills (~/.sith/skills/)")
         .action(() => {
-        (0,_commands_skills_js__WEBPACK_IMPORTED_MODULE_6__/* .skillsCommand */ .a)();
+        (0,_commands_skills_js__WEBPACK_IMPORTED_MODULE_7__/* .skillsCommand */ .a)();
     });
     // Nix command - native Nix environment
     program
@@ -44236,7 +44167,7 @@ function createProgram() {
         .option("--install", "Install Nix package manager")
         .option("--shell", "Run Nix shell")
         .action(async (options) => {
-        await (0,_commands_nix_js__WEBPACK_IMPORTED_MODULE_5__/* .nixCommand */ .Dv)(options);
+        await (0,_commands_nix_js__WEBPACK_IMPORTED_MODULE_6__/* .nixCommand */ .Dv)(options);
     });
     // OpenCode command - launch OpenCode in Docker
     program
@@ -44244,7 +44175,7 @@ function createProgram() {
         .description("Launch OpenCode in Docker")
         .option("-p, --prompt <prompt>", "Prompt to pass to OpenCode")
         .action(async (options) => {
-        await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_8__/* .launchOpencode */ .Tg)(options.prompt);
+        await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_9__/* .launchOpencode */ .Tg)(options.prompt);
     });
     // Claude command - launch Claude Code in Docker
     program
@@ -44252,7 +44183,7 @@ function createProgram() {
         .description("Launch Claude Code in Docker")
         .option("-p, --prompt <prompt>", "Prompt to pass to Claude Code")
         .action(async (options) => {
-        await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_8__/* .launchClaude */ .Q7)(options.prompt);
+        await (0,_utils_launcher_js__WEBPACK_IMPORTED_MODULE_9__/* .launchClaude */ .Q7)(options.prompt);
     });
     return program;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m14i/sith",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "Turn your context to the dark side. Standardize and share your OpenCode setup with a fully dockerized environment, designed for seamless collaboration and CI integration.",
   "type": "module",
   "repository": {