create-better-openclaw 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2024-2026 Bachir Soussi Chiadmi <bachir@bidew.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+The full text of the GNU Affero General Public License version 3 is
+available at: https://www.gnu.org/licenses/agpl-3.0.txt

package/README.md

@@ -0,0 +1,79 @@
+# @better-openclaw/cli
+
+The official Command Line Interface (CLI) for rapidly scaffolding production-ready OpenClaw stacks directly to your filesystem. Connects to `@better-openclaw/core` to build and output tailored Docker Compose & native hybrid topologies.
+
+## Installation & Usage
+
+You can use the CLI seamlessly using `pnpx`, `npx`, or standard global installation mechanisms. Node.js >= 20 is required.
+
+```bash
+# Interactive interactive builder (Visual Wizard)
+pnpx create-better-openclaw@latest [my-directory]
+
+# Headless / Pipeline generation (Fast track with presets)
+pnpx create-better-openclaw@latest --preset researcher --yes
+
+# Custom Advanced Scaffold
+pnpx create-better-openclaw@latest --services ollama,qdrant,n8n --skills ollama-local-llm,qdrant-memory
+```
+
+## Features
+
+- **Interactive Wizard (Terminal UI):** Guides you smoothly through Platform architecture, Custom vs Preset service selection, AI Skill Packs, and precise deployment/proxy variables. Driven by highly optimized `@clack/prompts`.
+- **Intelligent Dependency Graphs:** Ensures prerequisite tools are correctly enabled.
+- **Multiple Platform Topologies:** Support targeting `linux/amd64`, `linux/arm64`, `macos`, and `windows`.
+- **Multiple Output Formats:** Directly outputs to a `directory`, a `tar.gz` archive, or a `zip` bundle via flags (`--output-format zip`).
+
+## Non-Interactive CLI Options
+
+This tool is highly suited for CI/CD environments or scripting automation.
+
+| Argument | Definition |
+|----------|------------|
+| `-y, --yes` | Silently build using default configuration mappings |
+| `--preset <id>` | Scaffold immediately using predefined blueprints (`minimal`, `creator`, `researcher`, `devops`, `full`) |
+| `--services <ids>` | Explicit comma-separated list of service IDs to install |
+| `--skills <ids>` | Explicit comma-separated list of companion Skill Pack IDs to mount into agents |
+| `--proxy <type>` | Assign Reverse proxy networking mode: `none`, `caddy`, `traefik` |
+| `--domain <domain>` | Fully qualified domain mapped to wildcard auto-SSL proxies |
+| `--monitoring` | Embed Prometheus, Grafana, and Cadvisor telemetry |
+| `--gpu` | Passthrough host GPU telemetry to NVIDIA/AMD hardware integrations for deployed LLMs |
+| `--deployment-type <type>` | Defines compute execution layer boundaries. Options: `docker` (Full containerization) vs. `bare-metal` (Native node execution + Docker fallback layer where required). |
+| `--output-format <type>` | File emission mechanism: `directory`, `zip`, `tar` |
+| `--dry-run` | Build generation outputs in memory for trace logging without writing to disk |
+| `--open` | Escape terminal workflow and launch the Visual Web UI `better-openclaw.dev` platform |
+
+## Deploy to PaaS
+
+Deploy a generated stack directly to a self-hosted Dokploy or Coolify instance:
+
+```bash
+# Interactive deploy wizard
+better-openclaw deploy
+
+# Non-interactive deploy
+better-openclaw deploy \
+  --provider dokploy \
+  --url https://dokploy.example.com \
+  --api-key YOUR_API_KEY \
+  --dir ./my-stack
+```
+
+| Flag               | Description                                              |
+|--------------------|----------------------------------------------------------|
+| `--provider <id>`  | PaaS provider: `dokploy` or `coolify`                    |
+| `--url <url>`      | Instance URL of the PaaS platform                        |
+| `--api-key <key>`  | API key or bearer token                                  |
+| `--dir <path>`     | Directory containing `docker-compose.yml` (default: `.`) |
+
+If any required flag is missing, the CLI falls back to the interactive wizard which guides you through provider selection, URL, and API key entry.
+
+## Package Development
+
+The CLI compiles against standard TypeScript configurations into dual CJS/MJS mappings for backwards execution compatibility.
+
+```bash
+pnpm build # Compile via tsdown
+pnpm dev   # Hot-reload transpilation watch mode
+pnpm test  # CLI unit execution
+```

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "create-better-openclaw",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Scaffold production-ready OpenClaw Docker Compose stacks in one command. 95+ services, presets, auto-wiring, and skill packs.",
+  "author": "bidew.io <bachir@bidew.io>",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bidewio/better-openclaw.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://better-openclaw.dev",
+  "bugs": {
+    "url": "https://github.com/bidewio/better-openclaw/issues"
+  },
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.mjs",
+      "default": "./dist/*.mjs"
+    }
+  },
+  "bin": {
+    "create-better-openclaw": "./dist/index.mjs",
+    "better-openclaw": "./dist/index.mjs",
+    "better-openclaw-cli": "./dist/index.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@better-openclaw/core": "^1.0.19",
+    "@clack/prompts": "^1.0.0",
+    "commander": "^14.0.3",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.2",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "openclaw",
+    "better-openclaw",
+    "create-better-openclaw",
+    "docker",
+    "docker-compose",
+    "scaffolding",
+    "cli",
+    "ai-agent",
+    "devops",
+    "self-hosted",
+    "infrastructure"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "build:tsc": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.mjs",
+    "postinstall": "node -e \"try{console.log('\\n\\x1b[36m%s\\x1b[0m','  create-better-openclaw installed!');console.log('  Run: npx create-better-openclaw generate --preset researcher');console.log('  Docs: https://better-openclaw.dev\\n')}catch{}\"",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}