@shi_zhen/code-helper 0.1.0
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/LICENSE +21 -0
- package/README.md +222 -0
- package/bin/code-helper.js +9 -0
- package/dist/cli/index.d.mts +2 -0
- package/dist/cli/index.d.ts +2 -0
- package/dist/cli/index.js +3687 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/index.mjs +3680 -0
- package/dist/cli/index.mjs.map +1 -0
- package/dist/index.d.mts +3 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +35 -0
- package/dist/index.js.map +1 -0
- package/dist/index.mjs +8 -0
- package/dist/index.mjs.map +1 -0
- package/package.json +60 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 shirenchuang
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
# Code Helper
|
|
2
|
+
|
|
3
|
+
> 🚀 A unified CLI tool to manage your Claude Code - from installation to configuration, marketplace to MCP servers.
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/code-helper)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
[](https://nodejs.org)
|
|
8
|
+
|
|
9
|
+
## 📦 Installation
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g code-helper
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## ✨ Features
|
|
16
|
+
|
|
17
|
+
- 🔐 **Authorization Management** - Support for Claude API, GLM AI, Kimi AI and custom API keys
|
|
18
|
+
- 📦 **Plugin Marketplace** - Browse, install, and update plugins from configured marketplaces
|
|
19
|
+
- 🔌 **MCP Server Management** - Manage and configure MCP (Model Context Protocol) servers
|
|
20
|
+
- ⚙️ **Configuration Management** - Centralized management of .claude.json and related settings
|
|
21
|
+
- 🗑️ **Uninstall Utility** - Complete removal of Claude CLI and all configurations
|
|
22
|
+
- 🌐 **Web UI Integration** - Launch Claude Code UI with a single command
|
|
23
|
+
- 📝 **Profile Management** - Save and switch between multiple API configurations
|
|
24
|
+
|
|
25
|
+
## 🚀 Usage
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# Launch the interactive menu
|
|
29
|
+
code-helper
|
|
30
|
+
|
|
31
|
+
# Or use the alias
|
|
32
|
+
ch
|
|
33
|
+
|
|
34
|
+
# Or use the legacy alias
|
|
35
|
+
maco
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## 📚 Main Menu Options
|
|
39
|
+
|
|
40
|
+
1. **Authorization Configuration** - Set up your API keys and authentication
|
|
41
|
+
2. **Plugin Marketplace** - Browse and install plugins
|
|
42
|
+
3. **MCP Server Management** - Configure MCP servers
|
|
43
|
+
4. **Configuration Management** - View and edit settings
|
|
44
|
+
5. **Uninstall** - Remove Claude CLI and configurations
|
|
45
|
+
|
|
46
|
+
## 🔐 Authorization
|
|
47
|
+
|
|
48
|
+
Supported authentication methods:
|
|
49
|
+
|
|
50
|
+
- **Claude API** (Recommended) - Official Anthropic API
|
|
51
|
+
- **GLM AI** - Zhipu AI platform
|
|
52
|
+
- **Kimi AI** - Moonshot AI platform
|
|
53
|
+
- **Custom API** - Manual API key input with custom base URL
|
|
54
|
+
|
|
55
|
+
### Getting Started with Claude API
|
|
56
|
+
|
|
57
|
+
1. Visit [Anthropic Console](https://console.anthropic.com/settings/keys)
|
|
58
|
+
2. Create or copy your API key
|
|
59
|
+
3. Run `code-helper` and select "Authorization Configuration"
|
|
60
|
+
4. Choose "Claude API" and paste your key
|
|
61
|
+
|
|
62
|
+
## 📦 Plugin Marketplace
|
|
63
|
+
|
|
64
|
+
- Browse plugins from configured marketplace sources
|
|
65
|
+
- Install and update plugins with a single command
|
|
66
|
+
- View installed plugins and their versions
|
|
67
|
+
- **Configuration**: Edit `config/markets.json` to add your own marketplaces
|
|
68
|
+
|
|
69
|
+
Example `markets.json`:
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"version": "1.0.0",
|
|
73
|
+
"markets": [
|
|
74
|
+
{
|
|
75
|
+
"name": "my-marketplace",
|
|
76
|
+
"source": "https://github.com/org/marketplace.git",
|
|
77
|
+
"description": "My custom plugin marketplace",
|
|
78
|
+
"category": "custom",
|
|
79
|
+
"recommended": true
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## 🔌 MCP Server Management
|
|
86
|
+
|
|
87
|
+
- Browse recommended MCP servers
|
|
88
|
+
- One-click installation for common MCP servers
|
|
89
|
+
- Manage installed MCP server configurations
|
|
90
|
+
- **Configuration**: Edit `config/mcpServers.json` to add custom servers
|
|
91
|
+
|
|
92
|
+
Example `mcpServers.json`:
|
|
93
|
+
```json
|
|
94
|
+
{
|
|
95
|
+
"version": "1.0.0",
|
|
96
|
+
"mcpServers": [
|
|
97
|
+
{
|
|
98
|
+
"id": "my-server",
|
|
99
|
+
"name": "My MCP Server",
|
|
100
|
+
"description": "Custom MCP server",
|
|
101
|
+
"transport": "http",
|
|
102
|
+
"url": "https://my-server.com/mcp",
|
|
103
|
+
"category": "custom"
|
|
104
|
+
}
|
|
105
|
+
]
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## ⚙️ Configuration Management
|
|
110
|
+
|
|
111
|
+
- View current Claude configuration
|
|
112
|
+
- Edit `.claude.json` settings
|
|
113
|
+
- Manage multiple API profiles
|
|
114
|
+
- Switch between different configurations
|
|
115
|
+
|
|
116
|
+
## 🌐 Web UI
|
|
117
|
+
|
|
118
|
+
Launch the Claude Code UI interface:
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
npx @siteboon/claude-code-ui
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Or select "Launch Web UI" from the main menu.
|
|
125
|
+
|
|
126
|
+
## 🗑️ Uninstall
|
|
127
|
+
|
|
128
|
+
Complete removal of Claude CLI and all associated files:
|
|
129
|
+
- Claude CLI binary
|
|
130
|
+
- Configuration files (`~/.claude.json`)
|
|
131
|
+
- Cache and data directories
|
|
132
|
+
- Plugin marketplaces and installations
|
|
133
|
+
|
|
134
|
+
## 📁 Project Structure
|
|
135
|
+
|
|
136
|
+
```
|
|
137
|
+
code-helper/
|
|
138
|
+
├── src/
|
|
139
|
+
│ ├── cli/ # CLI implementation
|
|
140
|
+
│ │ ├── config/ # Configuration and constants
|
|
141
|
+
│ │ ├── menus/ # Interactive menus
|
|
142
|
+
│ │ ├── services/ # Business logic services
|
|
143
|
+
│ │ ├── types/ # TypeScript type definitions
|
|
144
|
+
│ │ ├── ui/ # UI components and themes
|
|
145
|
+
│ │ └── utils/ # Utility functions
|
|
146
|
+
│ └── index.ts # Entry point
|
|
147
|
+
├── config/
|
|
148
|
+
│ ├── markets.json # Marketplace configuration
|
|
149
|
+
│ └── mcpServers.json # MCP servers configuration
|
|
150
|
+
└── bin/
|
|
151
|
+
└── code-helper.js # Executable script
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## 🛠️ Development
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
# Install dependencies
|
|
158
|
+
npm install
|
|
159
|
+
|
|
160
|
+
# Development mode with hot reload
|
|
161
|
+
npm run dev
|
|
162
|
+
|
|
163
|
+
# Build for production
|
|
164
|
+
npm run build
|
|
165
|
+
|
|
166
|
+
# Run linter
|
|
167
|
+
npm run lint
|
|
168
|
+
|
|
169
|
+
# Run tests
|
|
170
|
+
npm test
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## 🔧 Building from Source
|
|
174
|
+
|
|
175
|
+
```bash
|
|
176
|
+
# Clone the repository
|
|
177
|
+
git clone https://github.com/shirenchuang/code-helper.git
|
|
178
|
+
cd code-helper
|
|
179
|
+
|
|
180
|
+
# Install dependencies
|
|
181
|
+
npm install
|
|
182
|
+
|
|
183
|
+
# Build the project
|
|
184
|
+
npm run build
|
|
185
|
+
|
|
186
|
+
# Link for local testing
|
|
187
|
+
npm link
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
## 📝 Configuration Files
|
|
191
|
+
|
|
192
|
+
### Markets Configuration (`config/markets.json`)
|
|
193
|
+
|
|
194
|
+
Define your plugin marketplaces. Each marketplace should be a Git repository containing a `.claude-plugin/marketplace.json` file.
|
|
195
|
+
|
|
196
|
+
### MCP Servers Configuration (`config/mcpServers.json`)
|
|
197
|
+
|
|
198
|
+
Define available MCP servers. Supports both HTTP and STDIO transport types.
|
|
199
|
+
|
|
200
|
+
## 🤝 Contributing
|
|
201
|
+
|
|
202
|
+
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
203
|
+
|
|
204
|
+
1. Fork the repository
|
|
205
|
+
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
|
|
206
|
+
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
|
|
207
|
+
4. Push to the branch (`git push origin feature/amazing-feature`)
|
|
208
|
+
5. Open a Pull Request
|
|
209
|
+
|
|
210
|
+
## 📄 License
|
|
211
|
+
|
|
212
|
+
MIT © [shirenchuang](https://github.com/shirenchuang)
|
|
213
|
+
|
|
214
|
+
## 🙏 Acknowledgments
|
|
215
|
+
|
|
216
|
+
- Built with [Claude](https://www.anthropic.com/claude) by Anthropic
|
|
217
|
+
- Inspired by the Claude Code community
|
|
218
|
+
- Thanks to all contributors
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
**Note**: This tool is not officially affiliated with Anthropic. It's a community project to help manage Claude Code installations and configurations.
|