refactor: rename ai-tools → agents

Rename the CLI tool from ai-tools to @arustydev/agents.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: aRustyDev

.scripts/bin/ai-tools.ts .scripts/bin/agents.ts.scripts/bin/ai-tools.ts renamed to .scripts/bin/agents.ts

@@ -2,7 +2,7 @@
 import { defineCommand, runMain } from 'citty'
 
 const main = defineCommand({
-  meta: { name: 'ai-tools', version: '0.1.0', description: 'AI context library tooling' },
+  meta: { name: 'agents', version: '0.1.0', description: 'AI context library tooling' },
   subCommands: {
     plugin: () => import('../commands/plugin').then((m) => m.default),
     skill: () => import('../commands/skill').then((m) => m.default),

.scripts/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "ai-tools",
+  "name": "@arustydev/agents",
   "version": "0.1.0",
   "private": true,
   "type": "module",
   "scripts": {
-    "ai-tools": "bun run bin/ai-tools.ts",
+    "agents": "bun run bin/agents.ts",
     "graph-viewer": "bun run bin/graph-viewer.ts",
     "graph-viewer:dev": "concurrently \"bun --watch run bin/graph-viewer.ts\" \"npx vite --config vite.graph-viewer.config.ts\"",
     "graph-viewer:build": "npx vite build --config vite.graph-viewer.config.ts",

CLAUDE.md

@@ -39,10 +39,10 @@ TypeScript tooling is managed via Bun:
 cd .scripts && bun install
 
 # Run the CLI tool
-bun run .scripts/bin/ai-tools.ts <noun> <verb> [args]
+bun run .scripts/bin/agents.ts <noun> <verb> [args]
 
 # Or via justfile
-just ai-tools <noun> <verb> [args]
+just agents <noun> <verb> [args]
 
 # Run tests
 cd .scripts && bun test
@@ -102,7 +102,7 @@ See `docs/src/adr/` for architecture decisions.
 │   ├── plugins/                # Plugin bundles
 │   └── output-styles/          # Output formatting styles
 ├── .scripts/
-│   ├── bin/ai-tools.ts         # Unified CLI (Bun + Citty)
+│   ├── bin/agents.ts         # Unified CLI (Bun + Citty)
 │   ├── lib/                    # TypeScript modules (hash, output, schemas, etc.)
 │   ├── commands/               # CLI subcommands (plugin, skill, kg, registry)
 │   ├── test/                   # bun:test suites
@@ -122,9 +122,9 @@ See `docs/src/adr/` for architecture decisions.
 |------|---------|
 | Initialize project | `just init` |
 | Install to ~/.claude | `just install` |
-| **CLI tool** | `just ai-tools <noun> <verb> [args]` |
-| Plugin check | `just ai-tools plugin check <name>` |
-| Skill validate | `just ai-tools skill validate <name>` |
+| **CLI tool** | `just agents <noun> <verb> [args]` |
+| Plugin check | `just agents plugin check <name>` |
+| Skill validate | `just agents skill validate <name>` |
 | External skill check | `just skill external:check` |
 | Semantic search | `just kg-search "query"` |
 
@@ -178,9 +178,9 @@ See `.claude/skills/beads/` for full documentation.
 ## Conventions
 
 - **Brewfile**: Tool-level dependencies only (ollama, uv, bun, yq, etc.)
-- **package.json** (`.scripts/`): TypeScript packages for `ai-tools` CLI (Bun)
+- **package.json** (`.scripts/`): TypeScript packages for `agents` CLI (Bun)
 - **pyproject.toml**: Python packages for KG only (sqlite-vec, ollama, watchdog)
 - **`just init`**: Must be idempotent — safe to run multiple times
 - **SQL dumps**: `.data/**/*.sql` files are version controlled; `.db` files are gitignored
 - **Plans**: Written as markdown in `.claude/plans/`, converted to beads issues
-- **`ai-tools`**: Unified CLI tool — `just ai-tools <noun> <verb>` for plugin/skill/registry operations
+- **`agents`**: Unified CLI tool — `just agents <noun> <verb>` for plugin/skill/registry operations

context/skills/.catalog/justfile

@@ -6,7 +6,7 @@ set unstable := true
 
 # ROOT is not inherited from parent module scope
 ROOT := source_directory() / "../../.."
-TOOLS := ROOT / ".scripts/bin/ai-tools.ts"
+TOOLS := ROOT / ".scripts/bin/agents.ts"
 run := "bun run " + TOOLS + " skill catalog"
 
 # Full pipeline: taxonomy -> availability -> analyze -> grade

context/skills/.external/justfile

@@ -2,7 +2,7 @@
 # External Skill Tracking Recipes
 # =============================================================================
 # Manages external skill dependencies: passthrough symlinks and derived tracking.
-# All recipes delegate to: bun run .scripts/bin/ai-tools.ts skill deps <verb>
+# All recipes delegate to: bun run .scripts/bin/agents.ts skill deps <verb>
 #
 # Invoked as: just skill external:check, just skill external:update, etc.
 # =============================================================================
@@ -11,7 +11,7 @@ set unstable := true
 
 # ROOT is not inherited from parent module scope, so recompute
 ROOT := source_directory() / "../../.."
-TOOLS := ROOT / ".scripts/bin/ai-tools.ts"
+TOOLS := ROOT / ".scripts/bin/agents.ts"
 run := "bun run " + TOOLS + " skill deps"
 
 # Full workflow: sync -> issues -> links -> status

justfile

@@ -13,8 +13,8 @@ mod rule "context/rules/justfile"
 
 # TypeScript CLI tooling
 [group('tools')]
-ai-tools *args:
-    @bun run .scripts/bin/ai-tools.ts {{ args }}
+agents *args:
+    @bun run .scripts/bin/agents.ts {{ args }}
 
 # Claude Code configuration directory