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.
- package/README.md +97 -506
- package/dist/cli.js +303 -271
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,441 +1,155 @@
|
|
|
1
1
|
# AIBlueprint CLI
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Supercharge Claude Code with security hooks, custom commands, intelligent statusline, and workflow automation.
|
|
4
4
|
|
|
5
|
-
|
|
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
|
|
27
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
|
|
22
|
+
## 📦 Installation
|
|
49
23
|
|
|
50
|
-
|
|
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
|
-
###
|
|
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
|
-
#
|
|
77
|
-
|
|
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
|
-
#
|
|
86
|
-
|
|
37
|
+
# Or install globally
|
|
38
|
+
npm install -g aiblueprint-cli
|
|
87
39
|
```
|
|
88
40
|
|
|
89
|
-
|
|
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
|
-
###
|
|
43
|
+
### Setup
|
|
108
44
|
|
|
109
45
|
```bash
|
|
110
|
-
#
|
|
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
|
-
|
|
49
|
+
# Install all features (no prompts)
|
|
50
|
+
npx aiblueprint-cli@latest claude-code setup --skip
|
|
121
51
|
|
|
122
|
-
|
|
123
|
-
|
|
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
|
-
|
|
138
|
-
|
|
139
|
-
### Main Commands
|
|
56
|
+
### Statusline Scripts
|
|
140
57
|
|
|
141
|
-
|
|
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
|
-
#
|
|
153
|
-
|
|
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
|
-
#
|
|
158
|
-
|
|
64
|
+
# Today's spending report
|
|
65
|
+
npx aiblueprint-cli@latest claude-code statusline spend:today
|
|
159
66
|
|
|
160
|
-
#
|
|
161
|
-
|
|
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
|
-
#
|
|
166
|
-
|
|
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
|
-
|
|
175
|
-
|
|
176
|
-
- `
|
|
177
|
-
|
|
178
|
-
|
|
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
|
-
|
|
221
|
-
- `explain-architecture` - Pattern analysis with ASCII diagrams
|
|
222
|
-
- `cleanup-context` - Memory optimization and duplicate removal
|
|
81
|
+
### Other Commands
|
|
223
82
|
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
308
|
-
<summary><strong>Analysis & Research (2 commands)</strong></summary>
|
|
97
|
+
### Security Hooks
|
|
309
98
|
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
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
|
-
|
|
103
|
+
### Custom Statusline
|
|
316
104
|
|
|
317
|
-
|
|
318
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
328
|
-
|
|
118
|
+
**Analysis:**
|
|
119
|
+
- `deep-code-analysis` - Comprehensive codebase investigation
|
|
120
|
+
- `explain-architecture` - Pattern analysis with diagrams
|
|
121
|
+
- `cleanup-context` - Memory optimization
|
|
329
122
|
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
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
|
-
|
|
128
|
+
### Agents (3 Specialized)
|
|
338
129
|
|
|
339
|
-
|
|
130
|
+
- **explore-codebase** - Code discovery and analysis
|
|
131
|
+
- **Snipper** - Fast code modifications
|
|
132
|
+
- **websearch** - Quick web research
|
|
340
133
|
|
|
341
|
-
|
|
342
|
-
| ---------------------- | -------------- | --------------------------- | ---------------------------------- |
|
|
343
|
-
| `post-edit-typescript` | TypeScript/Bun | File processing after edits | Edit, Write, MultiEdit on .ts/.tsx |
|
|
134
|
+
### Shell Shortcuts
|
|
344
135
|
|
|
345
|
-
|
|
136
|
+
- `cc` - Claude Code with permissions skipped
|
|
137
|
+
- `ccc` - Claude Code with continue mode
|
|
346
138
|
|
|
347
|
-
|
|
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
|
-
|
|
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
|
-
|
|
360
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
493
|
-
|
|
494
|
-
bun run
|
|
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
|
-
|
|
506
|
-
|
|
507
|
-
-
|
|
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** -
|
|
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)
|
|
193
|
+
Need help? [Open an issue](https://github.com/melvynx/aiblueprint/issues) | [Documentation](https://codelynx.dev/docs)
|