ai-builder 0.1.0 → 0.1.1

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
+ai-builder add agent git-town/code_reviewer
+
+# Install a command
+ai-builder add command truffle-ai/quality-checks
+
+# Install a skill
+ai-builder add skill anthropic/pdf
+
+# Search for artifacts
+ai-builder search "test"
+
+# List installed artifacts
+ai-builder list
+```
+
+---
+
+## Usage
+
+### Add
+
+Install an artifact from the registry:
+
+```bash
+ai-builder add <type> <author/slug>
+```
+
+**Types:** `skill`, `agent`, `command`, `stack`
+
+**Examples:**
+
+```bash
+# Install an agent
+ai-builder add agent git-town/code_reviewer
+
+# Install a command
+ai-builder add command truffle-ai/quality-checks
+
+# Install a skill
+ai-builder add skill anthropic/mcp-builder
+
+# Force reinstall (overwrite existing)
+ai-builder add agent git-town/code_reviewer --force
+```
+
+**Stacks** bundle multiple artifacts together:
+
+```bash
+# Install a stack (prompts for confirmation)
+ai-builder add stack my-stack
+
+# Skip confirmation
+ai-builder add stack my-stack --yes
+```
+
+### Remove
+
+Remove an installed artifact:
+
+```bash
+ai-builder remove <type> <author/slug>
+ai-builder rm <type> <author/slug>  # alias
+```
+
+**Examples:**
+
+```bash
+# Remove an agent
+ai-builder remove agent git-town/code_reviewer
+
+# Skip confirmation
+ai-builder rm agent git-town/code_reviewer --yes
+```
+
+### List
+
+List all installed artifacts:
+
+```bash
+ai-builder list
+ai-builder ls  # alias
+```
+
+**Options:**
+
+```bash
+# Filter by type
+ai-builder list --type agent
+ai-builder list --type skill
+ai-builder list --type command
+```
+
+### Search
+
+Search the registry for artifacts:
+
+```bash
+ai-builder search <query>
+```
+
+**Options:**
+
+```bash
+# Filter by type
+ai-builder search "review" --type agent
+
+# Filter by task category
+ai-builder search "nextjs" --task frontend
+
+# Limit results
+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

@@ -22,7 +22,10 @@ async function resolveArtifact(type, slug) {
 }
 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());

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "ai-builder",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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'",
@@ -34,7 +35,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",