Skip to content

shirenchuang/code-helper

Repository files navigation

Code Helper

πŸš€ A unified CLI tool to manage your Claude Code - from installation to configuration, marketplace to MCP servers.

npm version License: MIT Node.js Version

πŸ“¦ Installation

npm install -g @shi_zhen/code-helper

✨ Features

  • πŸ” Authorization Management - Support for Claude API, GLM AI, Kimi AI and custom API keys
  • πŸ“¦ Plugin Marketplace - Browse, install, and update plugins from configured marketplaces
  • πŸ”Œ MCP Server Management - Manage and configure MCP (Model Context Protocol) servers
  • βš™οΈ Configuration Management - Centralized management of .claude.json and related settings
  • πŸ—‘οΈ Uninstall Utility - Complete removal of Claude CLI and all configurations
  • 🌐 Web UI Integration - Launch Claude Code UI with a single command
  • πŸ“ Profile Management - Save and switch between multiple API configurations

πŸš€ Usage

# Launch the interactive menu
code-helper

# Or use the short alias
ch

πŸ“š Main Menu Options

  1. Authorization Configuration - Set up your API keys and authentication
  2. Plugin Marketplace - Browse and install plugins
  3. MCP Server Management - Configure MCP servers
  4. Configuration Management - View and edit settings
  5. Uninstall - Remove Claude CLI and configurations

πŸ” Authorization

Supported authentication methods:

  • Claude API (Recommended) - Official Anthropic API
  • GLM AI - Zhipu AI platform
  • Kimi AI - Moonshot AI platform
  • Custom API - Manual API key input with custom base URL

Getting Started with Claude API

  1. Visit Anthropic Console
  2. Create or copy your API key
  3. Run code-helper and select "Authorization Configuration"
  4. Choose "Claude API" and paste your key

πŸ“¦ Plugin Marketplace

  • Browse plugins from configured marketplace sources
  • Install and update plugins with a single command
  • View installed plugins and their versions
  • Configuration: Edit config/markets.json to add your own marketplaces

Example markets.json:

{
  "version": "1.0.0",
  "markets": [
    {
      "name": "my-marketplace",
      "source": "https://github.com/org/marketplace.git",
      "description": "My custom plugin marketplace",
      "category": "custom",
      "recommended": true
    }
  ]
}

πŸ”Œ MCP Server Management

  • Browse recommended MCP servers
  • One-click installation for common MCP servers
  • Manage installed MCP server configurations
  • Configuration: Edit config/mcpServers.json to add custom servers

Example mcpServers.json:

{
  "version": "1.0.0",
  "mcpServers": [
    {
      "id": "my-server",
      "name": "My MCP Server",
      "description": "Custom MCP server",
      "transport": "http",
      "url": "https://my-server.com/mcp",
      "category": "custom"
    }
  ]
}

βš™οΈ Configuration Management

  • View current Claude configuration
  • Edit .claude.json settings
  • Manage multiple API profiles
  • Switch between different configurations

🌐 Web UI

Launch the Claude Code UI interface:

npx @siteboon/claude-code-ui

Or select "Launch Web UI" from the main menu.

πŸ—‘οΈ Uninstall

Complete removal of Claude CLI and all associated files:

  • Claude CLI binary
  • Configuration files (~/.claude.json)
  • Cache and data directories
  • Plugin marketplaces and installations

πŸ“ Project Structure

code-helper/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ cli/              # CLI implementation
β”‚   β”‚   β”œβ”€β”€ config/       # Configuration and constants
β”‚   β”‚   β”œβ”€β”€ menus/        # Interactive menus
β”‚   β”‚   β”œβ”€β”€ services/     # Business logic services
β”‚   β”‚   β”œβ”€β”€ types/        # TypeScript type definitions
β”‚   β”‚   β”œβ”€β”€ ui/           # UI components and themes
β”‚   β”‚   └── utils/        # Utility functions
β”‚   └── index.ts          # Entry point
β”œβ”€β”€ config/
β”‚   β”œβ”€β”€ markets.json      # Marketplace configuration
β”‚   └── mcpServers.json   # MCP servers configuration
└── bin/
    └── code-helper.js    # Executable script

πŸ› οΈ Development

# Install dependencies
npm install

# Development mode with hot reload
npm run dev

# Build for production
npm run build

# Run linter
npm run lint

# Run tests
npm test

πŸ”§ Building from Source

# Clone the repository
git clone https://github.com/shirenchuang/code-helper.git
cd code-helper

# Install dependencies
npm install

# Build the project
npm run build

# Link for local testing
npm link

πŸ“ Configuration Files

Markets Configuration (config/markets.json)

Define your plugin marketplaces. Each marketplace should be a Git repository containing a .claude-plugin/marketplace.json file.

MCP Servers Configuration (config/mcpServers.json)

Define available MCP servers. Supports both HTTP and STDIO transport types.

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

MIT Β© shirenchuang

πŸ™ Acknowledgments

  • Built with Claude by Anthropic
  • Inspired by the Claude Code community
  • Thanks to all contributors

Note: This tool is not officially affiliated with Anthropic. It's a community project to help manage Claude Code installations and configurations.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors