aiblueprint-cli 1.4.19 → 1.4.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +97 -506
  2. package/dist/cli.js +303 -271
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,441 +1,155 @@
1
1
  # AIBlueprint CLI
2
2
 
3
- A comprehensive CLI tool for supercharging Claude Code with security, productivity, and workflow automation features. Transform your Claude Code experience with pre-configured commands, security hooks, intelligent status displays, and specialized AI agents.
3
+ Supercharge Claude Code with security hooks, custom commands, intelligent statusline, and workflow automation.
4
4
 
5
- > [!NOTE]
6
- > If you encounter permission errors when running the commands below, add `sudo` before the command.
5
+ 📚 **[Full Documentation](https://codelynx.dev/docs)** | 🎯 [Premium Features](https://mlv.sh/claude-cli)
7
6
 
8
7
  ## 🚀 Quick Start
9
8
 
10
- ### Option 1: Install as Claude Code Plugin (Recommended)
11
-
12
- ```bash
13
- # Add the AIBlueprint marketplace
14
- /plugin marketplace add melvynx/aiblueprint
15
-
16
- # Install the base plugin
17
- /plugin install aibp-base@AIBlueprint
18
-
19
- # Or install directly from GitHub
20
- /plugin install github:melvynx/aiblueprint
21
- ```
22
-
23
- ### Option 2: Use the CLI Tool
24
-
25
9
  ```bash
26
- # Run immediately without installation
27
- bunx aiblueprint-cli@latest claude-code setup
28
-
29
- # Or install globally and use
30
- npm install -g aiblueprint-cli
31
- aiblueprint claude-code setup
10
+ # Run setup (no installation required)
11
+ npx aiblueprint-cli@latest claude-code setup
32
12
  ```
33
13
 
34
- ## 📋 Table of Contents
35
-
36
- - [Plugin Installation](#-plugin-installation)
37
- - [CLI Installation & Usage](#-cli-installation--usage)
38
- - [Command Reference](#command-reference)
39
- - [Available Features](#available-features)
40
- - [Configuration System](#configuration-system)
41
- - [Templates Catalog](#templates-catalog)
42
- - [Installation Targets](#installation-targets)
43
- - [Security Features](#security-features)
44
- - [Development](#development)
14
+ ## Features
45
15
 
46
- ## 🔌 Plugin Installation
16
+ - **🛡️ Security** - Command validation hooks blocking dangerous operations
17
+ - **📊 Statusline** - Git status, cost tracking, and token usage display
18
+ - **🤖 Commands** - 16 pre-configured workflow automation commands
19
+ - **🎭 Agents** - 3 specialized AI agents for codebase exploration
20
+ - **⚡ Scripts** - Built-in utilities for spending reports and usage stats
47
21
 
48
- ### Install from Claude Code Plugin Marketplace
22
+ ## 📦 Installation
49
23
 
50
- The easiest way to get started is by installing AIBlueprint as a Claude Code plugin:
24
+ ### Option 1: Plugin (Recommended)
51
25
 
52
26
  ```bash
53
- # Step 1: Add the AIBlueprint marketplace
54
27
  /plugin marketplace add melvynx/aiblueprint
55
-
56
- # Step 2: Install the aibp-base plugin
57
28
  /plugin install aibp-base@AIBlueprint
58
-
59
- # Alternative: Install directly from GitHub
60
- /plugin install github:melvynx/aiblueprint
61
29
  ```
62
30
 
63
- ### What Gets Installed
64
-
65
- The `aibp-base` plugin includes:
66
-
67
- - ✅ **16 Custom Commands** - `/commit`, `/create-pull-request`, `/deep-code-analysis`, etc.
68
- - ✅ **3 Specialized Agents** - explore-codebase, Snipper, websearch
69
- - ✅ **Security Hooks** - Command validation and TypeScript processing
70
- - ✅ **Custom Statusline** - Git status, cost tracking, and token usage
71
- - ✅ **Notification Sounds** - Audio alerts for task completion
72
-
73
- ### Plugin Management
31
+ ### Option 2: CLI Tool
74
32
 
75
33
  ```bash
76
- # List installed plugins
77
- /plugin list
78
-
79
- # Update plugin to latest version
80
- /plugin update aibp-base
81
-
82
- # Remove plugin
83
- /plugin uninstall aibp-base
34
+ # Run without installation
35
+ npx aiblueprint-cli@latest claude-code setup
84
36
 
85
- # View marketplace plugins
86
- /plugin marketplace list
37
+ # Or install globally
38
+ npm install -g aiblueprint-cli
87
39
  ```
88
40
 
89
- ### Plugin vs CLI Tool
90
-
91
- **Plugin Installation (Recommended)**:
92
-
93
- - ✅ Automatic updates via marketplace
94
- - ✅ No CLI tool installation needed
95
- - ✅ Direct integration with Claude Code
96
- - ✅ Easy to manage and update
97
-
98
- **CLI Tool Installation**:
99
-
100
- - ✅ More control over installation
101
- - ✅ Custom folder locations
102
- - ✅ Interactive feature selection
103
- - ✅ Symlink management for other tools
104
-
105
- ## 💾 CLI Installation & Usage
41
+ ## 🎯 Usage
106
42
 
107
- ### Installation Methods
43
+ ### Setup
108
44
 
109
45
  ```bash
110
- # Global installation
111
- npm install -g aiblueprint-cli
112
- bun install -g aiblueprint-cli
113
-
114
- # Run without installation
46
+ # Interactive setup
115
47
  npx aiblueprint-cli@latest claude-code setup
116
- pnpm dlx aiblueprint-cli@latest claude-code setup
117
- bunx aiblueprint-cli@latest claude-code setup
118
- ```
119
48
 
120
- ### Basic Usage
49
+ # Install all features (no prompts)
50
+ npx aiblueprint-cli@latest claude-code setup --skip
121
51
 
122
- ```bash
123
- # Interactive setup with feature selection
124
- bunx aiblueprint-cli@latest claude-code setup
125
-
126
- # Non-interactive setup (install all features)
127
- bunx aiblueprint-cli@latest claude-code setup --skip
128
-
129
- # Install to custom directory
130
- bunx aiblueprint-cli@latest claude-code setup --folder ./custom-claude-config
131
-
132
- # Install to project directory
133
- cd your-project
134
- bunx aiblueprint-cli@latest claude-code setup # Creates .claude/ in project root
52
+ # Custom location
53
+ npx aiblueprint-cli@latest claude-code setup --folder ~/.my-claude
135
54
  ```
136
55
 
137
- ## 🎯 Command Reference
138
-
139
- ### Main Commands
56
+ ### Statusline Scripts
140
57
 
141
- | Command | Description | Options |
142
- | ------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
143
- | `bunx aiblueprint-cli@latest claude-code setup` | Interactive setup with feature selection | `-f, --folder <path>` (alias for --claudeCodeFolder), `--claudeCodeFolder <path>`, `--codexFolder <path>`, `--openCodeFolder <path>`, `--factoryAiFolder <path>`, `-s, --skip` |
144
- | `bunx aiblueprint-cli@latest claude-code symlink` | Create symlinks between CLI tools (Codex, OpenCode, FactoryAI) | `--claudeCodeFolder <path>`, `--codexFolder <path>`, `--openCodeFolder <path>`, `--factoryAiFolder <path>` |
145
- | `bunx aiblueprint-cli@latest claude-code statusline` | Setup custom statusline with git status, costs, and token usage | `-f, --folder <path>` |
146
- | `bunx aiblueprint-cli@latest claude-code add hook <type>` | Install specific hook | `-f, --folder <path>` |
147
- | `bunx aiblueprint-cli@latest claude-code add commands [name]` | List or install commands | `-f, --folder <path>` |
148
-
149
- ### Command Examples
58
+ Run utility scripts from anywhere:
150
59
 
151
60
  ```bash
152
- # Setup with options
153
- bunx aiblueprint-cli@latest claude-code setup --skip # Install all features
154
- bunx aiblueprint-cli@latest claude-code setup --folder ~/.my-claude # Custom location
155
- bunx aiblueprint-cli@latest claude-code setup --claudeCodeFolder ~/.claude --codexFolder ~/.codex # Separate folders
61
+ # List available scripts
62
+ npx aiblueprint-cli@latest claude-code statusline --list
156
63
 
157
- # Add specific hooks
158
- bunx aiblueprint-cli@latest claude-code add hook post-edit-typescript # TypeScript processing hook
64
+ # Today's spending report
65
+ npx aiblueprint-cli@latest claude-code statusline spend:today
159
66
 
160
- # Manage commands
161
- bunx aiblueprint-cli@latest claude-code add commands # List all available commands
162
- bunx aiblueprint-cli@latest claude-code add commands commit # Install commit command
163
- bunx aiblueprint-cli@latest claude-code add commands deep-code-analysis # Install analysis command
67
+ # Weekly usage analysis
68
+ npx aiblueprint-cli@latest claude-code statusline weekly
164
69
 
165
- # Create symlinks between CLI tools
166
- bunx aiblueprint-cli@latest claude-code symlink # Interactive symlink manager
167
- bunx aiblueprint-cli@latest claude-code symlink --factoryAiFolder ~/.factory # With custom paths
168
-
169
- # Setup statusline
170
- bunx aiblueprint-cli@latest claude-code statusline # Quick statusline setup
171
- bunx aiblueprint-cli@latest claude-code statusline --folder ~/.my-claude # Custom location
70
+ # Configure statusline
71
+ npx aiblueprint-cli@latest claude-code statusline config
172
72
  ```
173
73
 
174
- ### Hook Types Available
175
-
176
- - `post-edit-typescript` - Automatic TypeScript file processing (Prettier + ESLint + type checking)
177
-
178
- ### Installation Behavior
179
-
180
- The CLI intelligently determines where to install configurations:
181
-
182
- 1. **Project Local** (`.claude/` in project root) - When run in a Git repository
183
- 2. **Global** (`~/.claude/`) - When not in a Git repository or with custom folder
184
- 3. **Custom Path** - When using `--folder` option
185
-
186
- ## ✨ Available Features
187
-
188
- ### 🛡️ Shell Shortcuts
189
-
190
- - **`cc`** - Claude Code with permissions skipped (`claude --dangerously-skip-permissions`)
191
- - **`ccc`** - Claude Code with continue mode (`claude --dangerously-skip-permissions -c`)
192
- - Platform support: macOS (`.zshenv`), Linux (`.bashrc`/`.zshrc`)
193
-
194
- ### 🔒 Command Validation
195
-
196
- - **700+ line security system** protecting against dangerous bash commands
197
- - **Real-time validation** before command execution via PreToolUse hooks
198
- - **Smart detection** of privilege escalation, destructive operations, and command injection
199
- - **Comprehensive logging** to `~/.claude/security.log` with severity levels
200
-
201
- ### 📊 Custom Statusline
202
-
203
- - **Git integration** - Branch status, changes, and repository info
204
- - **Cost tracking** - Session costs, daily limits, and token usage via ccusage
205
- - **Real-time updates** - Command-triggered statusline refresh
206
- - **Colored output** - Visual indicators for different status types
207
- - **Quick setup** - Install with one command: `pnpm dlx aiblueprint-cli claude-code statusline`
208
-
209
- ### 🤖 AIBlueprint Commands (16 Available)
210
-
211
- **Development Workflow**
212
-
213
- - `commit` - Fast conventional commits with immediate push
214
- - `create-pull-request` - Auto-generated PR creation with templates
215
- - `fix-pr-comments` - Systematic PR review comment resolution
216
- - `run-tasks` - Execute GitHub issues with full EPCT workflow
217
-
218
- **Code Analysis & Research**
74
+ **Available scripts:**
75
+ - `spend:today` / `spend:month` / `spend:project` - Spending reports
76
+ - `stats` - Daily usage statistics
77
+ - `weekly` - Weekly usage analysis
78
+ - `config` - Interactive configuration
79
+ - `migrate` - Migrate to SQLite database
219
80
 
220
- - `deep-code-analysis` - Comprehensive codebase investigation with research
221
- - `explain-architecture` - Pattern analysis with ASCII diagrams
222
- - `cleanup-context` - Memory optimization and duplicate removal
81
+ ### Other Commands
223
82
 
224
- **Utilities & Automation**
225
-
226
- - `claude-memory` - Context management for long sessions
227
- - `watch-ci` - Automated CI/CD monitoring and failure fixing
228
- - `prompt-command` / `prompt-agent` - Template creation utilities
229
- - `epct` - Systematic Explore-Plan-Code-Test methodology
230
-
231
- ### 🎭 AIBlueprint Agents (3 Specialized)
232
-
233
- - **explore-codebase** (yellow) - Comprehensive code discovery and analysis
234
- - **Snipper** (blue) - Rapid code modification specialist with minimal output
235
- - **websearch** (yellow) - Quick web research with authoritative sources
236
-
237
- ### 🔊 Notification Sounds
238
-
239
- - **Finish sound** - Audio alert for completed operations (macOS afplay)
240
- - **Need-human sound** - Audio alert for attention requests
241
- - **Volume control** - Configurable audio levels
242
-
243
- ### 🔗 Symlink Management
244
-
245
- - **Multi-tool integration** - Create symlinks between Claude Code, Codex, OpenCode, and FactoryAI
246
- - **Interactive selection** - Choose source, content type (commands/agents), and destinations
247
- - **Smart validation** - Prevents overwriting non-symlink directories and validates paths
248
- - **Bidirectional sync** - Sync commands and agents in any direction
249
- - **Supported tools:**
250
- - **Claude Code** - Commands + Agents (`~/.claude/`)
251
- - **Codex** - Commands only (`~/.codex/prompts`)
252
- - **OpenCode** - Commands only (`~/.config/opencode/command`)
253
- - **FactoryAI** - Commands + Droids/Agents (`~/.factory/`)
254
-
255
- ## ⚙️ Configuration System
256
-
257
- ### Settings.json Structure
83
+ ```bash
84
+ # Add specific hooks
85
+ npx aiblueprint-cli@latest claude-code add hook post-edit-typescript
258
86
 
259
- The CLI automatically manages your `~/.claude/settings.json` with:
87
+ # Manage commands
88
+ npx aiblueprint-cli@latest claude-code add commands
89
+ npx aiblueprint-cli@latest claude-code add commands commit
260
90
 
261
- ```json
262
- {
263
- "statusLine": {
264
- "type": "command",
265
- "command": "bun ~/.claude/scripts/statusline/src/index.ts",
266
- "padding": 0
267
- },
268
- "hooks": {
269
- "PreToolUse": [
270
- {
271
- "matcher": "Bash",
272
- "hooks": [
273
- {
274
- "type": "command",
275
- "command": "bun ~/.claude/scripts/validate-command.js"
276
- }
277
- ]
278
- }
279
- ]
280
- }
281
- }
91
+ # Create symlinks between tools
92
+ npx aiblueprint-cli@latest claude-code symlink
282
93
  ```
283
94
 
284
- ### GitHub Integration
285
-
286
- - **Remote-first approach** - Always downloads latest configurations from GitHub
287
- - **Automatic fallback** - Uses local files when GitHub is unavailable
288
- - **Version independence** - Get updates without CLI updates
289
- - **Rate limiting aware** - Handles GitHub API limitations gracefully
290
-
291
- ## 📚 Templates Catalog
292
-
293
- ### Commands by Category
294
-
295
- <details>
296
- <summary><strong>Development Workflow (4 commands)</strong></summary>
297
-
298
- | Command | Tools | Purpose |
299
- | --------------------- | ----------------------------- | ---------------------------------------------- |
300
- | `commit` | `Bash(git :*)` | Quick conventional commits with immediate push |
301
- | `create-pull-request` | `Bash(git :*)`, `Bash(gh :*)` | PR creation with auto-generated descriptions |
302
- | `fix-pr-comments` | `Bash(gh :*)`, `Read`, `Edit` | Systematic PR review resolution |
303
- | `run-tasks` | `Bash(gh :*)`, `Bash(git :*)` | GitHub issue execution with EPCT |
304
-
305
- </details>
95
+ ## 📚 What You Get
306
96
 
307
- <details>
308
- <summary><strong>Analysis & Research (2 commands)</strong></summary>
97
+ ### Security Hooks
309
98
 
310
- | Command | Tools | Purpose |
311
- | ---------------------- | --------------------------------------- | ------------------------------------ |
312
- | `deep-code-analysis` | `Task`, `WebSearch`, `mcp__context7__*` | Comprehensive codebase investigation |
313
- | `explain-architecture` | `Read`, `Glob`, `Grep`, `Task` | Architectural pattern analysis |
99
+ - **Command validation** - Blocks `rm -rf`, privilege escalation, remote execution
100
+ - **TypeScript processing** - Auto-format and lint after file edits
101
+ - **Security logging** - Tracks all blocked commands to `~/.claude/security.log`
314
102
 
315
- </details>
103
+ ### Custom Statusline
316
104
 
317
- <details>
318
- <summary><strong>Maintenance & Optimization (2 commands)</strong></summary>
105
+ - Git branch, changes, and repository info
106
+ - Session costs and daily limits via ccusage
107
+ - Real-time token usage tracking
108
+ - Colored visual indicators
319
109
 
320
- | Command | Tools | Purpose |
321
- | ----------------- | -------------------------------- | ------------------------ |
322
- | `cleanup-context` | `TodoWrite`, `MultiEdit`, `Glob` | Memory bank optimization |
323
- | `watch-ci` | `Bash(gh :*)`, `Bash(sleep :*)` | Automated CI monitoring |
110
+ ### Commands (16 Available)
324
111
 
325
- </details>
112
+ **Development:**
113
+ - `commit` - Fast conventional commits
114
+ - `create-pull-request` - Auto-generated PRs
115
+ - `fix-pr-comments` - Resolve PR comments
116
+ - `run-tasks` - Execute GitHub issues
326
117
 
327
- <details>
328
- <summary><strong>Utilities (8 commands)</strong></summary>
118
+ **Analysis:**
119
+ - `deep-code-analysis` - Comprehensive codebase investigation
120
+ - `explain-architecture` - Pattern analysis with diagrams
121
+ - `cleanup-context` - Memory optimization
329
122
 
330
- | Command | Tools | Purpose |
331
- | ---------------- | ------------------------------- | ---------------------------------- |
332
- | `claude-memory` | `Read`, `Write`, `Edit`, `Glob` | CLAUDE.md file management |
333
- | `epct` | `Task` | Explore-Plan-Code-Test methodology |
334
- | `prompt-command` | `Read`, `Write`, `Edit` | Command template creation |
335
- | `prompt-agent` | `Read`, `Write`, `Edit` | Agent template creation |
123
+ **Utilities:**
124
+ - `claude-memory` - CLAUDE.md management
125
+ - `watch-ci` - Automated CI monitoring
126
+ - `epct` - Explore-Plan-Code-Test methodology
336
127
 
337
- </details>
128
+ ### Agents (3 Specialized)
338
129
 
339
- ### Hooks Available
130
+ - **explore-codebase** - Code discovery and analysis
131
+ - **Snipper** - Fast code modifications
132
+ - **websearch** - Quick web research
340
133
 
341
- | Hook | Language | Purpose | Triggers |
342
- | ---------------------- | -------------- | --------------------------- | ---------------------------------- |
343
- | `post-edit-typescript` | TypeScript/Bun | File processing after edits | Edit, Write, MultiEdit on .ts/.tsx |
134
+ ### Shell Shortcuts
344
135
 
345
- ### Scripts & Utilities
136
+ - `cc` - Claude Code with permissions skipped
137
+ - `ccc` - Claude Code with continue mode
346
138
 
347
- | Script | Language | Purpose |
348
- | ----------------------- | -------------- | ------------------------------------- |
349
- | `validate-command.js` | Bun/JavaScript | Security validation for bash commands |
350
- | `statusline-ccusage.sh` | Bash | Git status and usage tracking display |
139
+ ## 💎 Premium
351
140
 
352
- ## 🎯 Installation Targets
353
-
354
- ### Local Project Installation (Recommended)
355
-
356
- When run in a Git repository, creates `.claude/` in your project root:
141
+ Unlock advanced features at [mlv.sh/claude-cli](https://mlv.sh/claude-cli)
357
142
 
358
143
  ```bash
359
- cd your-project/
360
- bunx aiblueprint-cli@latest claude-code setup
361
- # Creates: your-project/.claude/
362
- ```
363
-
364
- **Benefits:**
365
-
366
- - Project-specific configurations
367
- - Team collaboration ready
368
- - Version control friendly
369
- - Isolated environments
144
+ # Activate premium
145
+ npx aiblueprint-cli@latest claude-code pro activate YOUR_TOKEN
370
146
 
371
- ### Global Installation
372
-
373
- When not in a Git repository, uses global directory:
374
-
375
- ```bash
376
- cd ~/
377
- bunx aiblueprint-cli@latest claude-code setup
378
- # Creates: ~/.claude/
147
+ # Setup premium configs
148
+ npx aiblueprint-cli@latest claude-code pro setup
379
149
  ```
380
150
 
381
- **Benefits:**
382
-
383
- - System-wide configurations
384
- - Works across all projects
385
- - Persistent settings
386
-
387
- ### Custom Path Installation
388
-
389
- Use `--folder` for specific locations:
390
-
391
- ```bash
392
- bunx aiblueprint-cli@latest claude-code setup --folder ./custom-config
393
- bunx aiblueprint-cli@latest claude-code setup --folder /opt/claude-config
394
- ```
395
-
396
- ## 🔐 Security Features
397
-
398
- ### Command Validation System
399
-
400
- The security system protects against dangerous operations:
401
-
402
- **Critical Commands Blocked:**
403
-
404
- - `rm -rf` (with path validation)
405
- - `dd`, `mkfs`, `fdisk` (disk operations)
406
- - `chmod 777`, `chown -R` (permission changes)
407
- - `curl | bash`, `wget | sh` (remote execution)
408
- - `sudo` operations (privilege escalation)
409
-
410
- **Security Logging:**
411
-
412
- ```json
413
- {
414
- "timestamp": "2024-01-15T10:30:00.000Z",
415
- "command": "rm -rf /",
416
- "severity": "CRITICAL",
417
- "action": "BLOCKED",
418
- "reason": "Destructive command with critical path"
419
- }
420
- ```
421
-
422
- **Safe Paths Allowed:**
423
-
424
- - `./`, `~/`, relative paths
425
- - `node_modules/`, `.git/`, common safe directories
426
- - Temporary directories (`/tmp/`, `/var/tmp/`)
427
-
428
- ### Hook-Based Protection
429
-
430
- - **PreToolUse validation** - Commands checked before execution
431
- - **Real-time analysis** - Pattern matching and rule evaluation
432
- - **User confirmation** - Interactive prompts for questionable commands
433
- - **Comprehensive rules** - 50+ security patterns and checks
434
-
435
151
  ## 🛠️ Development
436
152
 
437
- ### Local Development Setup
438
-
439
153
  ```bash
440
154
  # Clone and setup
441
155
  git clone <repository>
@@ -444,81 +158,21 @@ bun install
444
158
 
445
159
  # Development mode
446
160
  bun run dev claude-code setup
447
- bun run dev claude-code add commands
448
-
449
- # Testing
450
- bun run test:run # Run test suite
451
- bun run dev-test # Test with temporary config
452
- ```
453
-
454
- ### Build and Release
455
-
456
- ```bash
457
- # Build for distribution
458
- bun run build # Compiles to dist/cli.js
459
-
460
- # Local testing
461
- bun run test-local # Creates npm link
462
- aiblueprint claude-code setup # Test globally
463
-
464
- # Release (automated)
465
- bun run release # Version bump, build, tag, publish
466
- ```
467
-
468
- ### Project Structure
161
+ bun run dev claude-code statusline --list
469
162
 
470
- ```
471
- src/
472
- ├── cli.ts # Main CLI entry point
473
- ├── commands/
474
- │ ├── setup.ts # Main setup command
475
- │ ├── addHook.ts # Hook installation
476
- │ └── addCommand.ts # Command installation
477
- └── utils/
478
- ├── claude-config.ts # Configuration utilities
479
- ├── file-installer.ts # GitHub/local fallback
480
- └── github.ts # GitHub API integration
481
-
482
- claude-code-config/ # Template repository
483
- ├── commands/ # Command templates
484
- ├── hooks/ # Hook scripts
485
- ├── agents/ # Agent configurations
486
- ├── scripts/ # Utility scripts
487
- └── song/ # Notification sounds
488
- ```
489
-
490
- ### Testing Commands
163
+ # Run tests
164
+ bun run test:run
491
165
 
492
- ```bash
493
- # Test all major workflows
494
- bun run dev claude-code setup --skip
495
- bun run dev claude-code add hook post-edit-typescript
496
- bun run dev claude-code add commands
497
- bun run dev claude-code add commands commit
498
-
499
- # Test with custom paths
500
- bun run dev claude-code setup --folder ./test-config
166
+ # Build and test locally
167
+ bun run build
168
+ bun run test-local
501
169
  ```
502
170
 
503
171
  ## 📋 Requirements
504
172
 
505
- ### System Requirements
506
-
507
- - **Runtime**: Node.js 16+ or Bun
508
- - **Platform**: macOS (full support), Linux (partial), Windows (limited)
509
- - **Dependencies**: Git (for repository detection)
510
-
511
- ### Claude Code Requirements
512
-
513
- - **Claude Code**: Latest version installed
514
- - **Permissions**: Ability to modify `~/.claude/settings.json`
515
-
516
- ### Optional Dependencies
517
-
518
- - **bun**: Enhanced script execution and hooks
519
- - **ccusage**: Advanced statusline with cost tracking
520
- - **gh CLI**: GitHub integration for PR/issue commands
521
- - **prettier**, **eslint**: TypeScript hook functionality
173
+ - Node.js 16+ or Bun
174
+ - Claude Code installed
175
+ - Optional: `bun`, `ccusage`, `gh CLI`
522
176
 
523
177
  ## 🤝 Contributing
524
178
 
@@ -528,75 +182,12 @@ bun run dev claude-code setup --folder ./test-config
528
182
  4. Run tests: `bun run test:run`
529
183
  5. Submit a pull request
530
184
 
531
- ### Adding New Templates
532
-
533
- 1. Add template files to `claude-code-config/`
534
- 2. Update metadata with YAML frontmatter
535
- 3. Test installation: `bun run dev claude-code add commands <name>`
536
- 4. Document in README
537
-
538
- ## 💎 AIBlueprint CLI Premium
539
-
540
- Unlock advanced features with **AIBlueprint CLI Premium**:
541
-
542
- ### Premium Features
543
-
544
- - ✨ **Advanced Statusline** - Enhanced git info, real-time costs, and token usage tracking
545
- - 🚀 **Premium Commands** - Exclusive workflow automation templates
546
- - 🤖 **Premium Agents** - Specialized AI agents for complex tasks
547
- - 📦 **Priority Updates** - Get new features first
548
- - 💬 **Priority Support** - Direct help when you need it
549
-
550
- ### How to Upgrade
551
-
552
- ```bash
553
- # 1. Get your premium token at https://mlv.sh/claude-cli
554
-
555
- # 2. Activate premium
556
- aiblueprint claude-code pro activate YOUR_TOKEN
557
-
558
- # 3. Setup premium configs
559
- aiblueprint claude-code pro setup
560
- ```
561
-
562
- ### Premium Commands
563
-
564
- ```bash
565
- # Check premium status
566
- aiblueprint claude-code pro status
567
-
568
- # Update premium configs (overwrites all)
569
- aiblueprint claude-code pro update
570
-
571
- # Sync premium configs (selective update)
572
- aiblueprint claude-code pro sync
573
- ```
574
-
575
- ### Sync Command
576
-
577
- The `sync` command provides intelligent selective updates:
578
-
579
- ```bash
580
- aiblueprint claude-code pro sync
581
- ```
582
-
583
- **Features:**
584
-
585
- - 🔍 **Diff Analysis** - Compares your local config with the latest premium version
586
- - 📝 **Categorized Changes** - Shows NEW and MODIFIED items separately
587
- - ✅ **Selective Update** - Choose exactly which files/folders to update
588
- - 📁 **Smart Grouping** - Commands and agents shown individually, skills and scripts grouped as folders
589
-
590
- **Learn more:** https://mlv.sh/claude-cli
591
-
592
- ---
593
-
594
185
  ## 📄 License
595
186
 
596
187
  MIT License - see [LICENSE](LICENSE) file for details.
597
188
 
598
189
  ---
599
190
 
600
- **Created by AIBlueprint** - Enhancing Claude Code for modern development workflows!
191
+ **Created by AIBlueprint** - [mlv.sh/claude-cli](https://mlv.sh/claude-cli)
601
192
 
602
- Need help? [Open an issue](https://github.com/melvynx/aiblueprint/issues) or check our [documentation](https://docs.aiblueprint.dev).
193
+ Need help? [Open an issue](https://github.com/melvynx/aiblueprint/issues) | [Documentation](https://codelynx.dev/docs)