@guanmu/ccprofile 0.1.10 → 0.1.11
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 +146 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
# ccx
|
|
2
|
+
|
|
3
|
+
Agent Profile Manager for Claude Code.
|
|
4
|
+
|
|
5
|
+
`ccx` lets you save named Claude Code plugin profiles and install a whole profile into the current project with one command. It is designed as a command-first CLI, with a lightweight interactive wizard for manual use.
|
|
6
|
+
|
|
7
|
+
## Installation
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install -g @guanmu/ccprofile
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Or with Bun:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
bun add -g @guanmu/ccprofile@latest
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Verify the installed version:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
ccx --version
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Quick Start
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
ccx create dev
|
|
29
|
+
ccx add dev cc-design
|
|
30
|
+
ccx add dev browser
|
|
31
|
+
ccx list dev
|
|
32
|
+
ccx install dev
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
`ccx install dev` runs `claude plugin install <plugin> --scope project` for every plugin in the `dev` profile.
|
|
36
|
+
|
|
37
|
+
## Commands
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
ccx # Interactive wizard, TTY only
|
|
41
|
+
ccx ui # Interactive wizard, TTY only
|
|
42
|
+
|
|
43
|
+
ccx install <profile> # Install all plugins from a profile
|
|
44
|
+
ccx create <name> # Create a profile
|
|
45
|
+
ccx delete <name> # Delete a profile
|
|
46
|
+
ccx profiles # List all profiles
|
|
47
|
+
|
|
48
|
+
ccx add <profile> <plugin> # Add a plugin to a profile
|
|
49
|
+
ccx remove <profile> <plugin> # Remove a plugin from a profile
|
|
50
|
+
ccx list <profile> # List plugins in a profile
|
|
51
|
+
ccx search <keyword> # Search plugins in installed marketplaces
|
|
52
|
+
|
|
53
|
+
ccx --version # Show version
|
|
54
|
+
ccx --help # Show help
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Legacy aliases are still supported:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
ccx <profile> # Same as ccx install <profile>
|
|
61
|
+
ccx <profile> add [plugin]
|
|
62
|
+
ccx <profile> remove [plugin]
|
|
63
|
+
ccx <profile> list
|
|
64
|
+
ccx add <name> # Same as ccx create <name>
|
|
65
|
+
ccx remove <name> # Same as ccx delete <name>
|
|
66
|
+
ccx list # Same as ccx profiles
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Interactive Wizard
|
|
70
|
+
|
|
71
|
+
Run:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
ccx
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
The wizard is grouped into lightweight pages:
|
|
78
|
+
|
|
79
|
+
- `Install` - install plugins from a profile
|
|
80
|
+
- `Profiles` - create, list, and delete profiles
|
|
81
|
+
- `Plugins` - add, remove, and list profile plugins
|
|
82
|
+
- `Marketplace` - search installed plugin marketplaces
|
|
83
|
+
- `Help` - print command usage
|
|
84
|
+
|
|
85
|
+
The wizard only runs in a real TTY. In scripts, CI, or agent execution environments, use the command form instead.
|
|
86
|
+
|
|
87
|
+
## Profiles
|
|
88
|
+
|
|
89
|
+
Profiles are stored as JSON files under:
|
|
90
|
+
|
|
91
|
+
```text
|
|
92
|
+
~/.ccx/profiles/
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Example profile:
|
|
96
|
+
|
|
97
|
+
```json
|
|
98
|
+
{
|
|
99
|
+
"name": "dev",
|
|
100
|
+
"plugins": [
|
|
101
|
+
"cc-design",
|
|
102
|
+
"browser"
|
|
103
|
+
]
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Profile names may contain letters, numbers, dots, underscores, and hyphens.
|
|
108
|
+
|
|
109
|
+
## Marketplace Search
|
|
110
|
+
|
|
111
|
+
`ccx search <keyword>` reads Claude plugin marketplaces from:
|
|
112
|
+
|
|
113
|
+
```text
|
|
114
|
+
~/.claude/plugins/marketplaces/
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
Search matches plugin name, description, or category. Invalid marketplace files are skipped with a warning.
|
|
118
|
+
|
|
119
|
+
## Requirements
|
|
120
|
+
|
|
121
|
+
- Node.js 20.12 or newer
|
|
122
|
+
- Claude Code CLI available as `claude`
|
|
123
|
+
- Claude plugin marketplaces installed if you want marketplace search
|
|
124
|
+
|
|
125
|
+
## Development
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
pnpm install
|
|
129
|
+
pnpm run build
|
|
130
|
+
pnpm test
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Run from source:
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
pnpm run dev
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## Release
|
|
140
|
+
|
|
141
|
+
This package is published to npm from GitHub Releases.
|
|
142
|
+
|
|
143
|
+
1. Bump `package.json`.
|
|
144
|
+
2. Commit and push to `master`.
|
|
145
|
+
3. Create a GitHub release tag like `v0.1.10`.
|
|
146
|
+
4. The `Publish to npm` workflow builds and publishes the package.
|