ai-builder 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,216 @@
+<div align="center">
+<img src="https://aibuilder.sh/icon.svg" width="100"/>
+  <h1>ai-builder</h1>
+
+  <p>Composable building blocks for Claude Code</p>
+  <h3>CLI for installing skills, agents, and commands from the aibuilder.sh registry</h3>
+
+[![npm version](https://img.shields.io/npm/v/ai-builder.svg?color=blue&logo=npm)](https://www.npmjs.com/package/ai-builder)
+[![Downloads](https://img.shields.io/npm/dm/ai-builder.svg?color=green)](https://www.npmjs.com/package/ai-builder)
+
+</div>
+
+---
+
+## Overview
+
+**ai-builder** is a package manager for Claude Code artifacts. Install community-built skills, agents, and commands directly into your `.claude/` directory with a single command.
+
+## Features
+
+- **Install artifacts** - Add skills, agents, and commands from the registry
+- **Install stacks** - Bundle multiple artifacts together for specific workflows
+- **Search the registry** - Find artifacts by name, description, or task category
+- **Manage installed artifacts** - List and remove artifacts from your project
+
+---
+
+## Installation
+
+```bash
+npm install -g ai-builder
+```
+
+Or use directly with npx:
+
+```bash
+npx ai-builder add agent git-town/code_reviewer
+```
+
+---
+
+## QuickStart
+
+```bash
+# Install an agent
+npx ai-builder add agent git-town/code_reviewer
+
+# Install a command
+npx ai-builder add command truffle-ai/quality-checks
+
+# Install a skill
+npx ai-builder add skill anthropic/pdf
+
+# Search for artifacts
+npx ai-builder search "test"
+
+# List installed artifacts
+npx ai-builder list
+```
+
+---
+
+## Usage
+
+### Add
+
+Install an artifact from the registry:
+
+```bash
+npx ai-builder add <type> <author/slug>
+```
+
+**Types:** `skill`, `agent`, `command`, `stack`
+
+**Examples:**
+
+```bash
+# Install an agent
+npx ai-builder add agent git-town/code_reviewer
+
+# Install a command
+npx ai-builder add command truffle-ai/quality-checks
+
+# Install a skill
+npx ai-builder add skill anthropic/mcp-builder
+
+# Force reinstall (overwrite existing)
+npx ai-builder add agent git-town/code_reviewer --force
+```
+
+**Stacks** bundle multiple artifacts together:
+
+```bash
+# Install a stack (prompts for confirmation)
+npx ai-builder add stack my-stack
+
+# Skip confirmation
+npx ai-builder add stack my-stack --yes
+```
+
+### Remove
+
+Remove an installed artifact:
+
+```bash
+npx ai-builder remove <type> <author/slug>
+npx ai-builder rm <type> <author/slug>  # alias
+```
+
+**Examples:**
+
+```bash
+# Remove an agent
+npx ai-builder remove agent git-town/code_reviewer
+
+# Skip confirmation
+npx ai-builder rm agent git-town/code_reviewer --yes
+```
+
+### List
+
+List all installed artifacts:
+
+```bash
+npx ai-builder list
+npx ai-builder ls  # alias
+```
+
+**Options:**
+
+```bash
+# Filter by type
+npx ai-builder list --type agent
+npx ai-builder list --type skill
+npx ai-builder list --type command
+```
+
+### Search
+
+Search the registry for artifacts:
+
+```bash
+npx ai-builder search <query>
+```
+
+**Options:**
+
+```bash
+# Filter by type
+npx ai-builder search "review" --type agent
+
+# Filter by task category
+npx ai-builder search "nextjs" --task frontend
+
+# Limit results
+npx ai-builder search "database" --limit 5
+```
+
+---
+
+## Artifact Types
+
+| Type | Description | Install Location |
+|------|-------------|------------------|
+| **skill** | Background capabilities that enhance Claude's abilities | `.claude/skills/{name}/` |
+| **agent** | Specialized agents invoked with `@agent-name` | `.claude/agents/{name}.md` |
+| **command** | Slash commands invoked with `/command-name` | `.claude/commands/{name}.md` |
+| **stack** | Bundles of artifacts for specific workflows | Various locations |
+
+---
+
+## Using Installed Artifacts
+
+### Agents
+
+Invoke agents by mentioning them with `@`:
+
+```
+@reviewer review my latest changes
+```
+
+### Commands
+
+Run commands with `/`:
+
+```
+/deps
+```
+
+### Skills
+
+Skills are automatically available to Claude Code - no invocation needed.
+
+---
+
+## Browse
+
+Find artifacts at [aibuilder.sh](https://aibuilder.sh)
+
+- Browse by task category (testing, code review, documentation, etc.)
+- View artifact details and source code
+- See install counts and community activity
+
+---
+
+## Links
+
+- [Registry](https://aibuilder.sh)
+- [npm package](https://www.npmjs.com/package/ai-builder)
+- [GitHub](https://github.com/BrainGridAI/ai-builder)
+
+---
+
+## License
+
+MIT

package/dist/index.js

@@ -10,28 +10,40 @@ import chalk from "chalk";
 import ora from "ora";
 
 // src/services/api.ts
+import { createCliLogger } from "@aibuilder/logger/adapters/cli";
 var API_BASE = process.env.AI_BUILDER_API_URL || "https://aibuilder.sh/api";
+var logger = createCliLogger({ base: { module: "cli:api" } });
 async function resolveArtifact(type, slug) {
   const url = `${API_BASE}/resolve?type=${encodeURIComponent(type)}&slug=${encodeURIComponent(slug)}`;
+  logger.debug({ type, slug, url }, "Resolving artifact");
   const response = await fetch(url);
   if (!response.ok) {
     const errorBody = await response.json().catch(() => ({ error: "Unknown error" }));
+    logger.error({ type, slug, status: response.status }, "Failed to resolve artifact");
     throw new Error(errorBody.error || `Failed to resolve artifact: ${response.status}`);
   }
+  logger.debug({ type, slug }, "Artifact resolved successfully");
   return response.json();
 }
 async function searchArtifacts(options) {
   const params = new URLSearchParams();
-  if (options.query) params.set("q", options.query);
+  if (options.query) {
+    params.set("q", options.query);
+    params.set("sort", "relevance");
+  }
   if (options.type) params.set("type", options.type);
   if (options.task) params.set("task", options.task);
   if (options.limit) params.set("limit", options.limit.toString());
   const url = `${API_BASE}/artifacts?${params.toString()}`;
+  logger.debug({ options, url }, "Searching artifacts");
   const response = await fetch(url);
   if (!response.ok) {
+    logger.error({ status: response.status, options }, "Search failed");
     throw new Error(`Failed to search artifacts: ${response.status}`);
   }
-  return response.json();
+  const result = await response.json();
+  logger.debug({ resultCount: result.artifacts.length, total: result.total }, "Search completed");
+  return result;
 }
 async function trackInstall(type, slug, cliVersion) {
   try {
@@ -40,17 +52,23 @@ async function trackInstall(type, slug, cliVersion) {
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ type, slug, cliVersion })
     });
-  } catch {
+    logger.debug({ type, slug, cliVersion }, "Install tracked");
+  } catch (error) {
+    logger.debug({ err: error, type, slug }, "Install tracking failed (non-critical)");
   }
 }
 async function resolveStack(slug) {
   const url = `${API_BASE}/stacks/${encodeURIComponent(slug)}`;
+  logger.debug({ slug, url }, "Resolving stack");
   const response = await fetch(url);
   if (!response.ok) {
     const errorBody = await response.json().catch(() => ({ error: "Unknown error" }));
+    logger.error({ slug, status: response.status }, "Failed to resolve stack");
     throw new Error(errorBody.error || `Failed to resolve stack: ${response.status}`);
   }
-  return response.json();
+  const result = await response.json();
+  logger.debug({ slug, artifactCount: result.artifactCount }, "Stack resolved successfully");
+  return result;
 }
 
 // src/services/installer.ts

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "ai-builder",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI for installing Claude Code artifacts from aibuilder.sh",
   "type": "module",
   "bin": {
     "ai-builder": "./dist/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsx src/index.ts",
     "type-check": "tsc --noEmit",
-    "prepublishOnly": "pnpm run build",
     "preversion": "pnpm run type-check",
     "release:patch": "npm version patch -m 'chore(cli): release v%s'",
     "release:minor": "npm version minor -m 'chore(cli): release v%s'",
@@ -21,6 +22,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@aibuilder/logger": "workspace:*",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "ora": "^8.1.0"
@@ -34,7 +36,16 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["claude", "claude-code", "ai", "cli", "artifacts", "skills", "agents", "commands"],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "cli",
+    "artifacts",
+    "skills",
+    "agents",
+    "commands"
+  ],
   "author": "",
   "license": "MIT",
   "homepage": "https://aibuilder.sh",