@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 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
+ [![npm version](https://img.shields.io/npm/v/code-helper.svg)](https://www.npmjs.com/package/code-helper)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
+ [![Node.js Version](https://img.shields.io/node/v/code-helper.svg)](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.
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Code Helper CLI Entry Point
5
+ * A unified tool to manage your Claude Code
6
+ */
7
+
8
+ // Load the built CLI main program
9
+ require('../dist/cli/index.js');
@@ -0,0 +1,2 @@
1
+
2
+ export { }
@@ -0,0 +1,2 @@
1
+
2
+ export { }