@cruxgarden/cli 0.0.1

package/.nvmrc

@@ -0,0 +1 @@
+22.13.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Crux Garden
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,391 @@
+# Crux Garden CLI
+
+CLI tool to manage the Crux Garden Nursery environment with Docker.
+
+The **Nursery** is a production-like demo environment with sample data, perfect for trials, demos, and showcasing features.
+
+## Prerequisites
+
+- [Docker](https://docs.docker.com/get-docker/) installed and running
+- [Node.js](https://nodejs.org/) 18 or higher
+
+## Installation
+
+### Install from npm
+
+Install globally with npm:
+
+```bash
+npm install -g @cruxgarden/cli
+```
+
+Or use with npx (no installation required):
+
+```bash
+npx @cruxgarden/cli nursery start
+```
+
+### Local Development
+
+To develop or test the CLI locally:
+
+```bash
+# Clone the repository
+git clone https://github.com/CruxGarden/cli.git
+cd cli
+
+# Install dependencies
+npm install
+
+# Link the CLI globally for testing
+npm link
+
+# Now you can use the `crux` command
+crux --help
+
+# When done, unlink
+npm unlink -g @cruxgarden/cli
+```
+
+## Quick Start
+
+Start the Nursery environment:
+
+```bash
+crux nursery start
+```
+
+The API will be available at `http://localhost:3001` with demo data loaded.
+
+View logs:
+
+```bash
+crux nursery logs
+```
+
+Stop the environment:
+
+```bash
+crux nursery stop
+```
+
+## Commands
+
+All commands are scoped under `crux nursery`:
+
+### `crux nursery start`
+
+Start the Nursery environment (PostgreSQL, Redis, Migrations, and API with demo data).
+
+```bash
+crux nursery start
+```
+
+**Options:**
+
+- `--db-only` - Start only database services (PostgreSQL and Redis)
+
+### `crux nursery stop`
+
+Stop the Nursery environment. Data is preserved.
+
+```bash
+crux nursery stop
+```
+
+### `crux nursery restart`
+
+Restart the Nursery environment.
+
+```bash
+crux nursery restart
+```
+
+### `crux nursery status`
+
+Show the status of all Nursery services.
+
+```bash
+crux nursery status
+```
+
+### `crux nursery logs`
+
+View logs from all Nursery services.
+
+```bash
+crux nursery logs
+
+# Follow logs (like tail -f)
+crux nursery logs -f
+```
+
+### `crux nursery pull`
+
+Pull the latest API image from GitHub Container Registry.
+
+```bash
+crux nursery pull
+```
+
+### `crux nursery reset`
+
+Complete fresh reset: stops everything, deletes all data and volumes, pulls the latest image, and starts fresh. **Warning: This deletes all data!**
+
+```bash
+crux nursery reset
+```
+
+### `crux nursery clean`
+
+Stop and remove all Nursery containers and volumes. **Warning: This deletes all data!**
+
+```bash
+crux nursery clean
+```
+
+### `crux nursery db start`
+
+Start only Nursery database services (PostgreSQL and Redis).
+
+```bash
+crux nursery db start
+```
+
+### `crux nursery db stop`
+
+Stop Nursery database services.
+
+```bash
+crux nursery db stop
+```
+
+### `crux nursery db connect`
+
+Connect to the Nursery PostgreSQL database with `psql`.
+
+```bash
+crux nursery db connect
+```
+
+Useful psql commands:
+
+- `\dt` - List all tables
+- `\d table_name` - Describe a table
+- `\q` - Quit
+
+### `crux nursery redis connect`
+
+Connect to Nursery Redis with `redis-cli`.
+
+```bash
+crux nursery redis connect
+```
+
+### `crux nursery api connect`
+
+Open a shell in the Nursery API container.
+
+```bash
+crux nursery api connect
+```
+
+## What is the Nursery?
+
+The Nursery is a production-like demo environment that:
+
+- **Uses the published Docker image** from `ghcr.io/cruxgarden/api:latest`
+- **Includes demo data** - Sample cruxes, paths, and relationships for showcasing
+- **Runs standalone** - Bundled PostgreSQL and Redis, no external dependencies
+- **Perfect for demos** - Show features to stakeholders, QA testing, trials
+
+**Services:**
+
+- **API**: `http://localhost:3001` - Crux Garden API (published image with demo data)
+- **PostgreSQL**: `localhost:5433` - Database
+- **Redis**: `localhost:6380` - Cache
+
+## Environment Variables
+
+The Nursery environment has defaults for all environment variables, so a `.env` file is optional. However, you can override any variable by creating a `.env` file in your working directory:
+
+```bash
+# JWT (has dev default, but you should use a different one)
+JWT_SECRET=your-super-secret-jwt-key-min-32-chars
+
+# AWS (defaults to "dummy" values)
+AWS_ACCESS_KEY_ID=your-key
+AWS_SECRET_ACCESS_KEY=your-secret
+AWS_REGION=us-east-1
+FROM_EMAIL_ADDRESS=demo@example.com
+
+# Optional overrides
+CORS_ORIGIN=*
+LOG_LEVEL=info
+PORT=3001
+```
+
+## Common Workflows
+
+### Demo/Trial Setup
+
+Use the Nursery environment for demos, trials, or showcasing features:
+
+```bash
+# First time setup - pulls image and starts with demo data
+crux nursery start
+
+# View the demo at http://localhost:3001
+
+# Stop (keeps data for next demo)
+crux nursery stop
+
+# Restart for another demo
+crux nursery start
+
+# Get latest updates and fresh data
+crux nursery reset
+```
+
+### Testing Latest Changes
+
+Pull the latest published image and test:
+
+```bash
+# Pull latest image
+crux nursery pull
+
+# Restart with latest image
+crux nursery restart
+
+# Or do a complete fresh reset
+crux nursery reset
+```
+
+### Database Exploration
+
+Connect to the database to explore the demo data:
+
+```bash
+# Start the environment
+crux nursery start
+
+# Connect to PostgreSQL
+crux nursery db connect
+
+# In psql:
+# \dt - list tables
+# SELECT * FROM cruxes; - view demo cruxes
+# \q - quit
+```
+
+## Troubleshooting
+
+### Port already in use
+
+If you get an error about ports being in use, stop any existing services:
+
+```bash
+# Check what's using the ports
+lsof -i :3001  # Nursery API
+lsof -i :5433  # Nursery PostgreSQL
+lsof -i :6380  # Nursery Redis
+
+# Stop the Nursery
+crux nursery stop
+
+# Or clean everything
+crux nursery clean
+```
+
+### Containers won't start
+
+Try cleaning and restarting:
+
+```bash
+crux nursery clean
+crux nursery start
+```
+
+### Database connection issues
+
+Make sure the database is healthy:
+
+```bash
+crux nursery status
+```
+
+You should see `Up (healthy)` for postgres.
+
+### Nursery image is outdated
+
+Pull the latest image and restart:
+
+```bash
+crux nursery pull
+crux nursery restart
+
+# Or do a complete fresh reset
+crux nursery reset
+```
+
+### Docker daemon not running
+
+Make sure Docker Desktop (or Docker daemon) is running:
+
+```bash
+docker ps
+```
+
+If you get an error, start Docker Desktop.
+
+## Development Scripts
+
+The CLI also exposes npm scripts that you can use during development:
+
+```bash
+# Run tests
+npm test
+
+# Format code with Prettier
+npm run format
+
+# Run nursery commands directly (for testing)
+npm run docker:nursery
+npm run docker:nursery:logs
+npm run docker:nursery:down
+npm run docker:nursery:clean
+npm run docker:nursery:reset
+npm run docker:nursery:pull
+npm run docker:nursery:db
+npm run docker:nursery:db:stop
+npm run docker:nursery:db:connect
+npm run docker:nursery:redis:connect
+npm run docker:nursery:api:connect
+```
+
+## Future Features
+
+This CLI will eventually support:
+
+- **Cloud mode** - Login and interact with the official Crux Garden API at `api.crux.garden`
+- **Data operations** - Export, import, and sync data between environments
+- **Multi-instance management** - Switch between local and cloud instances
+
+## API Development
+
+If you're developing the Crux Garden API itself, use the npm scripts in the [API repository](https://github.com/CruxGarden/api) instead of this CLI. This CLI is specifically for running the published Nursery environment.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT
+
+## Links
+
+- [API Repository](https://github.com/CruxGarden/api)
+- [Documentation](https://github.com/CruxGarden/api#readme)
+- [Issues](https://github.com/CruxGarden/cli/issues)

package/bin/crux.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import {
+  showBanner,
+  startNursery,
+  stopNursery,
+  restartNursery,
+  statusNursery,
+  logsNursery,
+  cleanNursery,
+  pullNursery,
+  resetNursery,
+  connectNurseryDb,
+  connectNurseryRedis,
+  connectNurseryApi,
+  stopNurseryDb,
+} from "../lib/commands.js";
+
+program
+  .name("crux")
+  .description("Crux Garden CLI - Nursery Environment Manager")
+  .version("0.1.0");
+
+// Nursery environment commands
+const nursery = program
+  .command("nursery")
+  .description("Manage the Nursery environment (demo/trial environment)");
+
+nursery
+  .command("start")
+  .description("Start the Nursery environment (postgres, redis, api)")
+  .option("--db-only", "Start only database services (postgres, redis)")
+  .option("--no-banner", "Hide the startup banner")
+  .action((options) => {
+    if (!options.noBanner) showBanner();
+    startNursery(options);
+  });
+
+nursery
+  .command("stop")
+  .description("Stop the Nursery environment")
+  .action(stopNursery);
+
+nursery
+  .command("restart")
+  .description("Restart the Nursery environment")
+  .action(restartNursery);
+
+nursery
+  .command("status")
+  .description("Show status of Nursery services")
+  .action(statusNursery);
+
+nursery
+  .command("logs")
+  .description("Show logs from Nursery services")
+  .option("-f, --follow", "Follow log output")
+  .action(logsNursery);
+
+nursery
+  .command("clean")
+  .description("Stop and remove all Nursery containers and volumes")
+  .action(cleanNursery);
+
+nursery
+  .command("pull")
+  .description("Pull the latest API image from ghcr.io")
+  .action(pullNursery);
+
+nursery
+  .command("reset")
+  .description("Complete fresh reset (stop, clean, pull latest image, restart)")
+  .action(resetNursery);
+
+// Nursery database commands
+const nurseryDb = nursery
+  .command("db")
+  .description("Manage Nursery database services");
+
+nurseryDb
+  .command("start")
+  .description("Start only Nursery database services (postgres, redis)")
+  .action(() => startNursery({ dbOnly: true }));
+
+nurseryDb
+  .command("stop")
+  .description("Stop Nursery database services")
+  .action(stopNurseryDb);
+
+nurseryDb
+  .command("connect")
+  .description("Connect to the Nursery PostgreSQL database")
+  .action(connectNurseryDb);
+
+// Nursery Redis commands
+const nurseryRedis = nursery
+  .command("redis")
+  .description("Manage Nursery Redis");
+
+nurseryRedis
+  .command("connect")
+  .description("Connect to Nursery Redis")
+  .action(connectNurseryRedis);
+
+// Nursery API commands
+const nurseryApi = nursery.command("api").description("Manage Nursery API");
+
+nurseryApi
+  .command("connect")
+  .description("Open a shell in the Nursery API container")
+  .action(connectNurseryApi);
+
+program.parse();

package/docker/docker-compose.nursery.yml

@@ -0,0 +1,109 @@
+# Nursery Environment - Standalone Configuration
+# Production-like demo environment with sample data
+# Uses published Docker image with bundled PostgreSQL and Redis
+# Perfect for: demos, trials, showcasing features, onboarding
+# Usage: npm run docker:nursery
+
+services:
+  # PostgreSQL Database
+  postgres:
+    image: postgres:16-alpine
+    container_name: cruxgarden-postgres-nursery
+    environment:
+      POSTGRES_DB: cruxgarden
+      POSTGRES_USER: cruxgarden
+      POSTGRES_PASSWORD: cruxgarden_nursery_password
+    ports:
+      - "5433:5432"
+    volumes:
+      - postgres_data_nursery:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U cruxgarden"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  # Redis Cache
+  redis:
+    image: redis:7-alpine
+    container_name: cruxgarden-redis-nursery
+    command: redis-server --appendonly yes
+    ports:
+      - "6380:6379"
+    volumes:
+      - redis_data_nursery:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  # Database Migrations (runs once before API starts)
+  migrations:
+    image: ghcr.io/cruxgarden/api:latest
+    container_name: cruxgarden-migrations-nursery
+    depends_on:
+      postgres:
+        condition: service_healthy
+    environment:
+      NODE_ENV: production
+      DATABASE_URL: postgresql://cruxgarden:cruxgarden_nursery_password@postgres:5432/cruxgarden
+    command: ["npm", "run", "migrate:nursery"]
+    restart: "no"
+
+  # Crux Garden API - Nursery Configuration
+  api:
+    image: ghcr.io/cruxgarden/api:latest
+    container_name: cruxgarden-api-nursery
+    restart: unless-stopped
+    depends_on:
+      migrations:
+        condition: service_completed_successfully
+      redis:
+        condition: service_healthy
+    ports:
+      - "${PORT:-3001}:3000"
+    environment:
+      # Application
+      NODE_ENV: production
+      PORT: 3000
+      HOSTNAME: 0.0.0.0
+
+      # Bundled Services
+      DATABASE_URL: postgresql://cruxgarden:cruxgarden_nursery_password@postgres:5432/cruxgarden
+      REDIS_URL: redis://redis:6379
+
+      # Security
+      JWT_SECRET: ${JWT_SECRET:-your-super-secret-jwt-key-min-32-chars-for-development-only}
+
+      # AWS SES (optional for nursery)
+      AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID:-dummy}
+      AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY:-dummy}
+      AWS_REGION: ${AWS_REGION:-us-east-1}
+      FROM_EMAIL_ADDRESS: ${FROM_EMAIL_ADDRESS:-noreply@example.com}
+
+      # Optional Configuration
+      CORS_ORIGIN: ${CORS_ORIGIN:-*}
+      LOG_LEVEL: ${LOG_LEVEL:-info}
+      DB_POOL_MIN: ${DB_POOL_MIN:-2}
+      DB_POOL_MAX: ${DB_POOL_MAX:-10}
+      DB_POOL_IDLE_TIMEOUT: ${DB_POOL_IDLE_TIMEOUT:-30000}
+      DB_POOL_ACQUIRE_TIMEOUT: ${DB_POOL_ACQUIRE_TIMEOUT:-60000}
+      RATE_LIMIT_TTL: ${RATE_LIMIT_TTL:-60000}
+      RATE_LIMIT_MAX: ${RATE_LIMIT_MAX:-100}
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "node",
+          "-e",
+          "require('http').get('http://localhost:3000/', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})",
+        ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+volumes:
+  postgres_data_nursery:
+  redis_data_nursery:

package/lib/commands.js

@@ -0,0 +1,304 @@
+import { execSync, spawn } from "child_process";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import readline from "readline";
+import chalk from "chalk";
+import ora from "ora";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const dockerDir = join(__dirname, "..", "docker");
+
+// Colors
+const SUCCESS_GREEN = "#9BD39B";
+
+export function showBanner() {
+  // Check if banner was already shown in this shell session
+  if (process.env.CRUX_BANNER_SHOWN) return;
+
+  // Custom ASCII art - replace this with your own!
+  const banner = `
+ ██████╗██████╗ ██╗   ██╗██╗  ██╗
+██╔════╝██╔══██╗██║   ██║╚██╗██╔╝
+██║     ██████╔╝██║   ██║ ╚███╔╝
+██║     ██╔══██╗██║   ██║ ██╔██╗
+╚██████╗██║  ██║╚██████╔╝██╔╝ ██╗
+ ╚═════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝
+
+ ██████╗  █████╗ ██████╗ ██████╗ ███████╗███╗   ██╗
+██╔════╝ ██╔══██╗██╔══██╗██╔══██╗██╔════╝████╗  ██║
+██║  ███╗███████║██████╔╝██║  ██║█████╗  ██╔██╗ ██║
+██║   ██║██╔══██║██╔══██╗██║  ██║██╔══╝  ██║╚██╗██║
+╚██████╔╝██║  ██║██║  ██║██████╔╝███████╗██║ ╚████║
+ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚══════╝╚═╝  ╚═══╝`;
+
+  console.log(chalk.hex(SUCCESS_GREEN)(banner));
+  console.log(chalk.gray("  Nursery Environment - Demo & Trial\n"));
+
+  // Set environment variable so it persists for this shell session
+  process.env.CRUX_BANNER_SHOWN = "1";
+}
+
+function runCommand(command, options = {}) {
+  try {
+    return execSync(command, {
+      cwd: dockerDir,
+      stdio: options.silent ? "pipe" : "inherit",
+      encoding: "utf-8",
+      ...options,
+    });
+  } catch (error) {
+    if (!options.ignoreError) {
+      console.error(chalk.red(`Error: ${error.message}`));
+      process.exit(1);
+    }
+    return null;
+  }
+}
+
+function askConfirmation(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+
+// ============================================================================
+// Nursery Environment Commands
+// ============================================================================
+
+export async function startNursery(options) {
+  const spinner = ora("Starting Crux Garden Nursery environment...").start();
+
+  try {
+    if (options.dbOnly) {
+      spinner.text = "Starting nursery database services (postgres, redis)...";
+      runCommand(
+        "docker-compose -f docker-compose.nursery.yml up -d postgres redis",
+        { silent: true },
+      );
+      spinner.succeed("Nursery database services started!");
+      console.log(chalk.hex(SUCCESS_GREEN)("\n✓ PostgreSQL running on:"), "localhost:5433");
+      console.log(chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"), "localhost:6380");
+    } else {
+      spinner.text =
+        "Starting nursery services (postgres, redis, migrations, api)...";
+      runCommand("docker-compose -f docker-compose.nursery.yml up -d", {
+        silent: true,
+      });
+      spinner.succeed("Crux Garden Nursery environment started!");
+      console.log(chalk.hex(SUCCESS_GREEN)("\n✓ API running on:"), "http://localhost:3001");
+      console.log(chalk.hex(SUCCESS_GREEN)("✓ PostgreSQL running on:"), "localhost:5433");
+      console.log(chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"), "localhost:6380");
+      console.log(
+        chalk.yellow(
+          "\nℹ Nursery includes demo data for trials and showcases",
+        ),
+      );
+    }
+
+    console.log(
+      chalk.gray("\nRun"),
+      chalk.cyan("crux nursery logs"),
+      chalk.gray("to view logs"),
+    );
+    console.log(
+      chalk.gray("Run"),
+      chalk.cyan("crux nursery db connect"),
+      chalk.gray("to connect to PostgreSQL"),
+    );
+    console.log(
+      chalk.gray("Run"),
+      chalk.cyan("crux nursery redis connect"),
+      chalk.gray("to connect to Redis"),
+    );
+    console.log(
+      chalk.gray("Run"),
+      chalk.cyan("crux nursery api connect"),
+      chalk.gray("to shell into the API container"),
+    );
+  } catch (error) {
+    spinner.fail("Failed to start nursery services");
+    throw error;
+  }
+}
+
+export async function stopNursery() {
+  const spinner = ora("Stopping Crux Garden Nursery environment...").start();
+  runCommand("docker-compose -f docker-compose.nursery.yml down", {
+    silent: true,
+  });
+  spinner.succeed("Crux Garden Nursery environment stopped!");
+  console.log(
+    chalk.gray("\nData preserved. Run"),
+    chalk.cyan("crux nursery start"),
+    chalk.gray("to restart with existing data."),
+  );
+}
+
+export async function logsNursery(options) {
+  if (options.follow) {
+    console.log(
+      chalk.gray("Following nursery logs (press Ctrl+C to exit)...\n"),
+    );
+    const child = spawn(
+      "docker-compose",
+      ["-f", "docker-compose.nursery.yml", "logs", "-f"],
+      {
+        cwd: dockerDir,
+        stdio: "inherit",
+      },
+    );
+
+    process.on("SIGINT", () => {
+      child.kill("SIGINT");
+      process.exit(0);
+    });
+  } else {
+    runCommand("docker-compose -f docker-compose.nursery.yml logs --tail=100");
+  }
+}
+
+export async function cleanNursery() {
+  console.log(
+    chalk.yellow(
+      "\n⚠️  This will delete all nursery containers and volumes (including data)!\n",
+    ),
+  );
+
+  const confirmed = await askConfirmation(
+    chalk.red("Are you sure you want to continue? (y/N): "),
+  );
+
+  if (!confirmed) {
+    console.log(chalk.gray("\nClean cancelled."));
+    return;
+  }
+
+  const spinner = ora(
+    "Cleaning up nursery (removing containers and volumes)...",
+  ).start();
+
+  runCommand("docker-compose -f docker-compose.nursery.yml down -v", {
+    silent: true,
+    ignoreError: true,
+  });
+
+  spinner.succeed("Nursery cleanup complete!");
+  console.log(
+    chalk.gray("Run"),
+    chalk.cyan("crux nursery start"),
+    chalk.gray("to start fresh."),
+  );
+}
+
+export async function pullNursery() {
+  const spinner = ora(
+    "Pulling latest Crux Garden API image from ghcr.io...",
+  ).start();
+
+  runCommand("docker-compose -f docker-compose.nursery.yml pull", {
+    silent: true,
+  });
+
+  spinner.succeed("Latest nursery image pulled!");
+  console.log(
+    chalk.gray("Run"),
+    chalk.cyan("crux nursery restart"),
+    chalk.gray("to use the new image."),
+  );
+}
+
+export async function resetNursery() {
+  console.log(
+    chalk.yellow(
+      "\n⚠️  This will delete all nursery data and start fresh with the latest image!\n",
+    ),
+  );
+
+  const confirmed = await askConfirmation(
+    chalk.red("Are you sure you want to continue? (y/N): "),
+  );
+
+  if (!confirmed) {
+    console.log(chalk.gray("\nReset cancelled."));
+    return;
+  }
+
+  const spinner = ora("Resetting nursery environment...").start();
+
+  try {
+    // Stop and remove volumes
+    spinner.text = "Stopping and removing containers/volumes...";
+    runCommand("docker-compose -f docker-compose.nursery.yml down -v", {
+      silent: true,
+      ignoreError: true,
+    });
+
+    // Pull latest image
+    spinner.text = "Pulling latest image...";
+    runCommand("docker-compose -f docker-compose.nursery.yml pull", {
+      silent: true,
+    });
+
+    // Start fresh
+    spinner.text = "Starting fresh nursery environment...";
+    runCommand("docker-compose -f docker-compose.nursery.yml up -d", {
+      silent: true,
+    });
+
+    spinner.succeed("Nursery environment reset complete!");
+    console.log(chalk.hex(SUCCESS_GREEN)("\n✓ API running on:"), "http://localhost:3001");
+    console.log(chalk.hex(SUCCESS_GREEN)("✓ PostgreSQL running on:"), "localhost:5433");
+    console.log(chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"), "localhost:6380");
+    console.log(
+      chalk.yellow("\nℹ Fresh nursery with latest demo data loaded"),
+    );
+  } catch (error) {
+    spinner.fail("Failed to reset nursery");
+    throw error;
+  }
+}
+
+export async function restartNursery() {
+  await stopNursery();
+  await startNursery({});
+}
+
+export async function statusNursery() {
+  console.log(chalk.bold("\nCrux Garden Nursery Environment Status:\n"));
+  runCommand("docker-compose -f docker-compose.nursery.yml ps");
+}
+
+export async function connectNurseryDb() {
+  console.log(chalk.gray("Connecting to Nursery PostgreSQL...\n"));
+  runCommand(
+    "docker exec -it cruxgarden-postgres-nursery psql -U cruxgarden -d cruxgarden",
+  );
+}
+
+export async function connectNurseryRedis() {
+  console.log(chalk.gray("Connecting to Nursery Redis...\n"));
+  runCommand("docker exec -it cruxgarden-redis-nursery redis-cli");
+}
+
+export async function connectNurseryApi() {
+  console.log(chalk.gray("Opening shell in Nursery API container...\n"));
+  runCommand("docker exec -it cruxgarden-api-nursery sh");
+}
+
+export async function stopNurseryDb() {
+  const spinner = ora("Stopping nursery database services...").start();
+  runCommand(
+    "docker-compose -f docker-compose.nursery.yml stop postgres redis",
+    { silent: true },
+  );
+  spinner.succeed("Nursery database services stopped!");
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@cruxgarden/cli",
+  "version": "0.0.1",
+  "description": "Crux Garden CLI",
+  "type": "module",
+  "bin": {
+    "crux": "./bin/crux.js"
+  },
+  "scripts": {
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "format": "prettier --write .",
+    "docker:nursery": "cd docker && docker-compose -f docker-compose.nursery.yml up -d",
+    "docker:nursery:logs": "cd docker && docker-compose -f docker-compose.nursery.yml logs -f",
+    "docker:nursery:down": "cd docker && docker-compose -f docker-compose.nursery.yml down",
+    "docker:nursery:clean": "cd docker && docker-compose -f docker-compose.nursery.yml down -v",
+    "docker:nursery:pull": "cd docker && docker-compose -f docker-compose.nursery.yml pull",
+    "docker:nursery:reset": "cd docker && docker-compose -f docker-compose.nursery.yml down -v && docker-compose -f docker-compose.nursery.yml pull && docker-compose -f docker-compose.nursery.yml up -d",
+    "docker:nursery:db": "cd docker && docker-compose -f docker-compose.nursery.yml up -d postgres redis",
+    "docker:nursery:db:stop": "cd docker && docker-compose -f docker-compose.nursery.yml stop postgres redis",
+    "docker:nursery:redis:connect": "docker exec -it cruxgarden-redis-nursery redis-cli",
+    "docker:nursery:db:connect": "docker exec -it cruxgarden-postgres-nursery psql -U cruxgarden -d cruxgarden",
+    "docker:nursery:api:connect": "docker exec -it cruxgarden-api-nursery sh"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "figlet": "^1.9.3",
+    "ora": "^7.0.1"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0",
+    "prettier": "^3.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CruxGarden/cli.git"
+  },
+  "keywords": [
+    "crux",
+    "cruxgarden",
+    "api",
+    "cli",
+    "docker",
+    "knowledge-management"
+  ],
+  "author": "The Keeper",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/CruxGarden/cli/issues"
+  },
+  "homepage": "https://github.com/CruxGarden/cli#readme"
+}