crafters 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2025-01-10
+
+### Added
+
+- **Claude Code Integration**
+  - `crafters claude install` - Install commands and agents from claude-dx repo
+  - `crafters claude update` - Update all commands and agents (overwrites existing)
+
+- **Features**
+  - Clones/updates `crafter-station/claude-dx` to local machine
+  - Copies commands to `~/.claude/commands/`
+  - Copies agents to `~/.claude/agents/`
+  - Intelligent merge of `settings.json` (preserves existing config, adds new permissions)
+  - Skip existing commands by default, use `--force` or `update` to overwrite
+
 ## [0.1.0] - 2024-12-20
 
 ### Added

package/CLAUDE.md

@@ -0,0 +1,42 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Run the CLI in development
+bun run src/index.ts
+
+# Build standalone executable
+bun build src/index.ts --compile --outfile crafters
+
+# Run with specific command
+bun run src/index.ts claude install
+bun run src/index.ts claude update
+bun run src/index.ts domain add myapp -p my-vercel-project
+bun run src/index.ts login --spaceshipKey="..." --spaceshipSecret="..." --vercelToken="..."
+```
+
+## Architecture
+
+This is a CLI tool (`crafters`) for managing domains on Vercel projects with Spaceship DNS. Built with Bun and the `citty` CLI framework.
+
+### Structure
+
+- `src/index.ts` - Entry point, defines main command and subcommands using citty's `defineCommand`
+- `src/commands/` - Command implementations
+  - `claude.ts` - `claude install/update` for syncing Claude Code config from claude-dx
+  - `domain.ts` - `domain add/remove/list` commands (core functionality)
+  - `login.ts` - `login/logout/whoami` credential management
+- `src/lib/` - API clients and utilities
+  - `spaceship.ts` - Spaceship DNS API client (CNAME management)
+  - `vercel.ts` - Vercel SDK wrapper for project domain operations
+  - `config.ts` - Config file management (`~/.crafters/config.json`)
+
+### Key Patterns
+
+- Commands use citty's `defineCommand` with `meta`, `args`, and `run` properties
+- API clients are factory functions (`createSpaceshipClient`, `createVercelClient`) returning method objects
+- Configuration supports both file-based (`~/.crafters/config.json`) and environment variable fallbacks
+- Domain operations coordinate both Vercel (add domain to project) and Spaceship (create CNAME record)

package/README.md

@@ -1,6 +1,6 @@
 # crafters
 
-CLI for managing domains on Vercel projects with Spaceship DNS.
+Crafter Station CLI for domain management and Claude Code configuration.
 
 ## Install
 
@@ -8,19 +8,41 @@ CLI for managing domains on Vercel projects with Spaceship DNS.
 bun install -g crafters
 ```
 
-## Setup
+## Commands
+
+### Claude Code
+
+Sync Claude Code commands and agents from `crafter-station/claude-dx`.
+
+```bash
+# First-time install (skips existing commands)
+crafters claude install
+
+# Update all commands (overwrites existing)
+crafters claude update
+
+# Force overwrite on install
+crafters claude install --force
+```
+
+**What it does:**
+- Clones/pulls `claude-dx` to `~/Programming/crafter-station/`
+- Copies commands to `~/.claude/commands/`
+- Copies agents to `~/.claude/agents/`
+- Merges `settings.json` without overwriting existing config
+
+### Domain Management
+
+Manage Vercel project domains with Spaceship DNS.
 
 ```bash
+# Setup credentials
 crafters login \
   --spaceshipKey="YOUR_KEY" \
   --spaceshipSecret="YOUR_SECRET" \
   --vercelToken="YOUR_TOKEN" \
   --vercelTeamId="YOUR_TEAM_ID"
-```
-
-## Usage
 
-```bash
 # Add subdomain to project
 crafters domain add myapp -p my-vercel-project
 
@@ -32,8 +54,17 @@ crafters domain list
 
 # Check current config
 crafters whoami
+
+# Clear credentials
+crafters logout
 ```
 
+## Requirements
+
+- [Bun](https://bun.sh)
+- [GitHub CLI](https://cli.github.com) (for claude commands)
+- Access to `crafter-station/claude-dx` repo
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "crafters",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "description": "Crafter Station CLI - Domain management and Claude Code configuration",
   "type": "module",
   "author": "raillyhugo",
   "license": "MIT",

package/src/commands/claude.ts

@@ -0,0 +1,184 @@
+import { defineCommand } from "citty";
+import { execSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import {
+  readdir,
+  copyFile,
+  mkdir,
+  readFile,
+  writeFile,
+  stat,
+  cp,
+} from "node:fs/promises";
+
+const CLAUDE_DX_REPO = "crafter-station/claude-dx";
+const CLAUDE_DX_PATH = join(homedir(), "Programming/crafter-station/claude-dx");
+const CLAUDE_CONFIG_PATH = join(homedir(), ".claude");
+
+async function exists(path: string): Promise<boolean> {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function cloneOrPullRepo(): Promise<void> {
+  if (await exists(CLAUDE_DX_PATH)) {
+    console.log("Updating claude-dx...");
+    execSync("git pull", { cwd: CLAUDE_DX_PATH, stdio: "inherit" });
+  } else {
+    console.log("Cloning claude-dx...");
+    execSync(`gh repo clone ${CLAUDE_DX_REPO} ${CLAUDE_DX_PATH}`, {
+      stdio: "inherit",
+    });
+  }
+}
+
+async function copyCommands(
+  force: boolean,
+): Promise<{ copied: number; skipped: number }> {
+  const srcDir = join(CLAUDE_DX_PATH, ".claude/commands");
+  const destDir = join(CLAUDE_CONFIG_PATH, "commands");
+
+  await mkdir(destDir, { recursive: true });
+
+  const entries = await readdir(srcDir, { withFileTypes: true });
+  let copied = 0;
+  let skipped = 0;
+
+  for (const entry of entries) {
+    const srcPath = join(srcDir, entry.name);
+    const destPath = join(destDir, entry.name);
+
+    if ((await exists(destPath)) && !force) {
+      console.log(`   Skip: ${entry.name} (exists)`);
+      skipped++;
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      await cp(srcPath, destPath, { recursive: true });
+    } else {
+      await copyFile(srcPath, destPath);
+    }
+    console.log(`   Copy: ${entry.name}`);
+    copied++;
+  }
+
+  return { copied, skipped };
+}
+
+async function copyAgents(): Promise<number> {
+  const srcDir = join(CLAUDE_DX_PATH, ".claude/agents");
+  const destDir = join(CLAUDE_CONFIG_PATH, "agents");
+
+  if (!(await exists(srcDir))) return 0;
+
+  await mkdir(destDir, { recursive: true });
+
+  const files = await readdir(srcDir);
+  for (const file of files) {
+    await copyFile(join(srcDir, file), join(destDir, file));
+    console.log(`   Copy: ${file}`);
+  }
+  return files.length;
+}
+
+async function mergeSettings(): Promise<void> {
+  const srcPath = join(CLAUDE_DX_PATH, ".claude/settings.json");
+  const destPath = join(CLAUDE_CONFIG_PATH, "settings.json");
+
+  if (!(await exists(srcPath))) return;
+
+  const srcSettings = JSON.parse(await readFile(srcPath, "utf-8"));
+  let destSettings: Record<string, unknown> = {};
+
+  if (await exists(destPath)) {
+    destSettings = JSON.parse(await readFile(destPath, "utf-8"));
+  }
+
+  const merged: Record<string, unknown> = { ...destSettings };
+
+  for (const [key, value] of Object.entries(srcSettings)) {
+    if (key === "permissions" && typeof value === "object" && value !== null) {
+      merged.permissions = merged.permissions || {};
+      const srcPerms = value as Record<string, string[]>;
+      const destPerms = (merged.permissions || {}) as Record<string, string[]>;
+
+      for (const [permKey, permValue] of Object.entries(srcPerms)) {
+        const existing = destPerms[permKey] || [];
+        (merged.permissions as Record<string, string[]>)[permKey] = [
+          ...new Set([...existing, ...permValue]),
+        ];
+      }
+    } else if (!(key in merged)) {
+      merged[key] = value;
+    }
+  }
+
+  await writeFile(destPath, JSON.stringify(merged, null, 2));
+  console.log("   Merged settings.json");
+}
+
+async function runInstall(force: boolean): Promise<void> {
+  console.log("\n1. Syncing claude-dx repo...");
+  await cloneOrPullRepo();
+
+  console.log("\n2. Installing commands...");
+  const { copied, skipped } = await copyCommands(force);
+
+  console.log("\n3. Installing agents...");
+  const agentCount = await copyAgents();
+
+  console.log("\n4. Merging settings...");
+  await mergeSettings();
+
+  console.log(
+    `\nDone! ${copied} commands installed, ${skipped} skipped, ${agentCount} agents installed.`,
+  );
+  if (skipped > 0 && !force) {
+    console.log("Use 'crafters claude update' to overwrite existing commands.\n");
+  }
+}
+
+export const claudeInstall = defineCommand({
+  meta: {
+    name: "install",
+    description: "Install Claude Code commands and agents from claude-dx",
+  },
+  args: {
+    force: {
+      type: "boolean",
+      alias: "f",
+      description: "Overwrite existing commands",
+      default: false,
+    },
+  },
+  async run({ args }) {
+    await runInstall(args.force);
+  },
+});
+
+export const claudeUpdate = defineCommand({
+  meta: {
+    name: "update",
+    description: "Update Claude Code commands and agents from claude-dx",
+  },
+  async run() {
+    await runInstall(true);
+  },
+});
+
+export const claude = defineCommand({
+  meta: {
+    name: "claude",
+    description: "Manage Claude Code configuration",
+  },
+  subCommands: {
+    install: claudeInstall,
+    update: claudeUpdate,
+  },
+});

package/src/index.ts

@@ -1,15 +1,17 @@
 #!/usr/bin/env bun
 import { defineCommand, runMain } from "citty";
+import { claude } from "./commands/claude";
 import { domain } from "./commands/domain";
 import { login, logout, whoami } from "./commands/login";
 
 const main = defineCommand({
   meta: {
     name: "crafters",
-    version: "0.0.1",
-    description: "Crafter Station CLI - Domain management for Vercel projects",
+    version: "0.2.0",
+    description: "Crafter Station CLI - Domain management and Claude Code configuration",
   },
   subCommands: {
+    claude,
     domain,
     login,
     logout,