clawdock 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# ClawDock CLI
+
+The command-line tool for [ClawDock](https://clawhub-one.vercel.app) — the agent registry. Push, pull, share, and deploy OpenClaw agent bundles.
+
+## Install
+
+```bash
+npm install -g clawdock
+```
+
+## Quick Start
+
+```bash
+# Log in with your access token (from dashboard)
+clawdock login
+
+# Initialize a bundle in your agent workspace
+clawdock init
+
+# Push your agent
+clawdock push
+
+# Pull an agent
+clawdock pull username/agent-name
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `clawdock login` | Authenticate with your access token |
+| `clawdock whoami` | Show current user |
+| `clawdock init` | Create a `manifest.json` in the current directory |
+| `clawdock push [path]` | Bundle and publish an agent |
+| `clawdock pull <owner/slug[@version]>` | Download and extract a bundle |
+| `clawdock search <query>` | Search the registry |
+| `clawdock list` | List your published bundles |
+
+## Configuration
+
+Config is stored in `~/.clawdock/config.json`.
+
+Environment variables:
+- `CLAWDOCK_API_KEY` — override stored API key
+- `CLAWDOCK_REGISTRY` — override registry URL
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import * as tar from "tar";
+var CONFIG_DIR = path.join(os.homedir(), ".clawdock");
+var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+var DEFAULT_REGISTRY = "https://clawhub-one.vercel.app";
+function loadConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveConfig(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+function getRegistry() {
+  return process.env.CLAWDOCK_REGISTRY || loadConfig().registry || DEFAULT_REGISTRY;
+}
+function getApiKey() {
+  return process.env.CLAWDOCK_API_KEY || loadConfig().apiKey;
+}
+async function apiRequest(method, endpoint, body, isForm) {
+  const registry = getRegistry();
+  const apiKey = getApiKey();
+  const headers = {};
+  if (apiKey) headers["x-api-key"] = apiKey;
+  if (!isForm && body) headers["content-type"] = "application/json";
+  const res = await fetch(`${registry}/api${endpoint}`, {
+    method,
+    headers,
+    body: isForm ? body : body ? JSON.stringify(body) : void 0
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ error: res.statusText }));
+    throw new Error(err.error || `HTTP ${res.status}`);
+  }
+  return res.json();
+}
+var program = new Command();
+program.name("clawdock").description("ClawDock \u2014 the agent registry").version("0.1.0");
+program.command("login").description("Authenticate with ClawDock").option("--api-key <key>", "API key").option("--registry <url>", "Registry URL").action(async (opts) => {
+  const config = loadConfig();
+  if (opts.apiKey) {
+    config.apiKey = opts.apiKey;
+  } else {
+    process.stdout.write("API Key: ");
+    const key = await new Promise((resolve2) => {
+      let data = "";
+      process.stdin.setEncoding("utf-8");
+      process.stdin.on("data", (chunk) => {
+        data += chunk;
+        if (data.includes("\n")) {
+          process.stdin.pause();
+          resolve2(data.trim());
+        }
+      });
+      process.stdin.resume();
+    });
+    config.apiKey = key;
+  }
+  if (opts.registry) config.registry = opts.registry;
+  saveConfig(config);
+  console.log(`\u2705 Logged in to ${getRegistry()}`);
+  console.log(`   Config saved to ${CONFIG_FILE}`);
+});
+program.command("whoami").description("Show current user").action(async () => {
+  try {
+    const data = await apiRequest("GET", "/v1/auth/me");
+    console.log(`Logged in as: ${data.email || data.name || "unknown"}`);
+  } catch (err) {
+    console.error(`Not logged in or invalid key: ${err.message}`);
+    process.exit(1);
+  }
+});
+program.command("push [path]").description("Publish an agent bundle").option("--public", "Make bundle public (default)", true).option("--private", "Make bundle private").option("--changelog <text>", "Version changelog").action(async (bundlePath, opts) => {
+  const dir = path.resolve(bundlePath || ".");
+  const manifestPath = path.join(dir, "manifest.json");
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`\u274C No manifest.json found in ${dir}`);
+    console.error("   Create one with: clawdock init");
+    process.exit(1);
+  }
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+  console.log(`\u{1F4E6} Pushing ${manifest.name}@${manifest.version}...`);
+  const tmpFile = path.join(os.tmpdir(), `clawdock-${Date.now()}.tar.gz`);
+  const excludePatterns = manifest.exclude || [
+    "node_modules",
+    "*.log",
+    ".git",
+    ".env",
+    ".env.*",
+    "__pycache__",
+    ".DS_Store"
+  ];
+  await tar.create(
+    {
+      gzip: true,
+      file: tmpFile,
+      cwd: path.dirname(dir),
+      filter: (p) => {
+        return !excludePatterns.some((pattern) => {
+          if (pattern.startsWith("*.")) {
+            return p.endsWith(pattern.slice(1));
+          }
+          return p.includes(pattern);
+        });
+      }
+    },
+    [path.basename(dir)]
+  );
+  const tarball = fs.readFileSync(tmpFile);
+  const sizeMb = (tarball.length / 1024 / 1024).toFixed(1);
+  console.log(`   Bundle size: ${sizeMb} MB`);
+  const formData = new FormData();
+  formData.append("tarball", new Blob([tarball]), `${manifest.name}.tar.gz`);
+  formData.append("is_public", opts.private ? "false" : "true");
+  if (opts.changelog) formData.append("changelog", opts.changelog);
+  try {
+    const result = await apiRequest("POST", "/v1/bundles/publish", formData, true);
+    console.log(`\u2705 Published ${result.owner}/${result.slug}@${result.version}`);
+    console.log(`   Checksum: ${result.checksum?.slice(0, 12)}...`);
+    console.log(`   Install:  clawdock pull ${result.owner}/${result.slug}`);
+  } catch (err) {
+    console.error(`\u274C Push failed: ${err.message}`);
+    process.exit(1);
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+});
+program.command("pull <bundle>").description("Download an agent bundle (owner/slug[@version])").option("--dir <path>", "Extract to directory", ".").action(async (bundle, opts) => {
+  const match = bundle.match(/^([^/]+)\/([^@]+)(?:@(.+))?$/);
+  if (!match) {
+    console.error("\u274C Invalid bundle format. Use: owner/slug[@version]");
+    process.exit(1);
+  }
+  const [, owner, slug, version] = match;
+  const ver = version || "latest";
+  console.log(`\u{1F4E5} Pulling ${owner}/${slug}@${ver}...`);
+  try {
+    const { url, version: resolvedVersion } = await apiRequest(
+      "GET",
+      `/v1/bundles/${owner}/${slug}/${ver}/download`
+    );
+    console.log(`   Version: ${resolvedVersion}`);
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`Download failed: ${res.statusText}`);
+    const tarball = Buffer.from(await res.arrayBuffer());
+    const targetDir = path.resolve(opts.dir, slug);
+    fs.mkdirSync(targetDir, { recursive: true });
+    const tmpFile = path.join(os.tmpdir(), `clawdock-pull-${Date.now()}.tar.gz`);
+    fs.writeFileSync(tmpFile, tarball);
+    await tar.extract({
+      file: tmpFile,
+      cwd: targetDir,
+      strip: 1
+      // Remove top-level directory
+    });
+    fs.unlinkSync(tmpFile);
+    console.log(`\u2705 Extracted to ${targetDir}`);
+  } catch (err) {
+    console.error(`\u274C Pull failed: ${err.message}`);
+    process.exit(1);
+  }
+});
+program.command("search <query>").description("Search for agent bundles").option("--limit <n>", "Max results", "10").action(async (query, opts) => {
+  try {
+    const { bundles, total } = await apiRequest(
+      "GET",
+      `/v1/bundles?q=${encodeURIComponent(query)}&limit=${opts.limit}`
+    );
+    if (!bundles.length) {
+      console.log("No bundles found.");
+      return;
+    }
+    console.log(`Found ${total} bundle(s):
+`);
+    for (const b of bundles) {
+      const stars = b.star_count ? `\u2B50${b.star_count}` : "";
+      const downloads = b.download_count ? `\u{1F4E5}${b.download_count}` : "";
+      const tags = b.tags?.length ? b.tags.map((t) => `#${t}`).join(" ") : "";
+      console.log(`  ${b.owner}/${b.slug} ${stars} ${downloads}`);
+      if (b.description) console.log(`    ${b.description}`);
+      if (tags) console.log(`    ${tags}`);
+      console.log();
+    }
+  } catch (err) {
+    console.error(`\u274C Search failed: ${err.message}`);
+    process.exit(1);
+  }
+});
+program.command("list").description("List your published bundles").action(async () => {
+  try {
+    const me = await apiRequest("GET", "/v1/auth/me").catch(() => null);
+    if (!me) {
+      console.error("Not logged in. Run: clawdock login");
+      process.exit(1);
+    }
+    const { bundles } = await apiRequest("GET", `/v1/bundles/${me.slug || me.name}`);
+    if (!bundles?.length) {
+      console.log("No bundles published yet. Push your first agent with: clawdock push");
+      return;
+    }
+    console.log("Your bundles:\n");
+    for (const b of bundles) {
+      const visibility = b.is_public ? "\u{1F30D}" : "\u{1F512}";
+      console.log(`  ${visibility} ${b.owner}/${b.slug} \u2B50${b.star_count} \u{1F4E5}${b.download_count}`);
+    }
+  } catch (err) {
+    console.error(`\u274C ${err.message}`);
+    process.exit(1);
+  }
+});
+program.command("init").description("Create a manifest.json for your agent").action(async () => {
+  const manifestPath = path.join(process.cwd(), "manifest.json");
+  if (fs.existsSync(manifestPath)) {
+    console.log("manifest.json already exists.");
+    return;
+  }
+  const dirName = path.basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  const manifest = {
+    name: dirName,
+    version: "0.1.0",
+    description: "",
+    author: "",
+    tags: []
+  };
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+  console.log(`\u2705 Created manifest.json`);
+  console.log(`   Edit it, then run: clawdock push`);
+});
+program.parse();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "clawdock",
+  "version": "0.1.0",
+  "description": "CLI for ClawDock — the agent registry",
+  "bin": {
+    "clawdock": "./dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "tar": "^7.0.0",
+    "glob": "^11.0.0",
+    "ora": "^8.0.0",
+    "chalk": "^5.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/tar": "^6.1.0"
+  },
+  "files": ["dist"],
+  "keywords": ["openclaw", "agent", "registry", "clawdock"],
+  "license": "MIT"
+}