Communitygithub.com

cp-yu/cc-switch-web

Plataforma de gestão tudo-em-um para CLIs de IA (Claude Code, Codex e Gemini) com alternância de provedores, servidores MCP, skills e prompts. Agora com interface web para ambientes headless/SSH.

O que é cc-switch-web?

cp-yu/cc-switch-web é uma plataforma de gestão unificada para agentes de IA de linha de comando, oferecendo alternância entre provedores (Claude Code, Codex e Gemini), gerenciamento de servidores MCP, importação e organização de skills, e administração de prompts. Sua principal utilidade está em centralizar o controle de múltiplos provedores e recursos em um único ponto, facilitando a vida de desenvolvedores que precisam alternar entre diferentes IAs ou ambientes headless/SSH. O projeto suporta Claude Code, Codex e Gemini, permitindo que o usuário troque de provedor sem sair do terminal, gerencie habilidades (skills) de forma centralizada, e configure servidores MCP dinamicamente. A interface web, acessível via navegador, é especialmente útil em ambientes sem display gráfico, possibilitando o gerenciamento remoto das configurações. Ao utilizar scripts shell e Node.js, o sistema integra-se diretamente com as CLIs dos provedores, oferecendo comandos como `cc-switch` para alternar provedores, `mcp` para gerenciar servidores MCP, e `skill` para gerenciar skills, tudo documentado no SKILL.md.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add cp-yu/cc-switch-web

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que cc-switch-web faz?

Plataforma de Gestão Tudo-em-Um para CLIs de IA (Claude Code, Codex e Gemini) - Alternância de provedores, servidores MCP, Skills e gerenciamento de prompts. Agora com interface web para ambientes headless/SSH.

Visão Geral

O cc-switch-web unifica o gerenciamento de múltiplos provedores de IA em um único ponto de controle, permitindo que você alterne entre Claude Code, Codex e Gemini, gerencie servidores MCP, importe e organize skills, e administre prompts de forma centralizada.

Funcionalidades

  • Alternância de Provedores: Troque entre Claude Code, Codex e Gemini com um único comando.
  • Gerenciamento de Servidores MCP: Adicione, remova e configure servidores MCP dinamicamente.
  • Gerenciamento de Skills: Importe, organize e ative/desative skills de IA.
  • Gerenciamento de Prompts: Crie, edite e organize prompts reutilizáveis.
  • Interface Web: Acesse e gerencie tudo via navegador, ideal para ambientes headless/SSH.

Instalação

# Clone o repositório
git clone https://github.com/cp-yu/cc-switch-web.git
cd cc-switch-web

# Instale as dependências
npm install

# Execute a aplicação
npm start

Comandos

  • cc-switch [provedor] - Alterna para o provedor especificado (claude, codex, gemini).
  • mcp - Gerencia servidores MCP.
  • skill - Gerencia skills.
  • prompt - Gerencia prompts.

Uso

Alternar provedor

cc-switch claude

Gerenciar servidores MCP

mcp add <url>
mcp remove <id>
mcp list

Gerenciar skills

skill import <caminho>
skill list
skill enable <id>
skill disable <id>

Interface web

A interface web está disponível em http://localhost:3000 por padrão. Configure a porta com a variável de ambiente PORT.

Configuração

Variáveis de ambiente:

VariávelDescriçãoPadrão
PORTPorta do servidor web3000
DATA_DIRDiretório para armazenar dados./data
CLAUDE_CONFIGCaminho do arquivo de configuração do Claude Code~/.claude/config.json
CODEX_CONFIGCaminho do arquivo de configuração do Codex~/.codex/config.json
GEMINI_CONFIGCaminho do arquivo de configuração do Gemini~/.gemini/config.json

Estrutura do Projeto

cc-switch-web/
├── src/
│   ├── index.js          # Ponto de entrada
│   ├── cli.js            # Interface de linha de comando
│   ├── web.js            # Servidor web
│   ├── providers/        # Módulos de provedores
│   ├── mcp/              # Gerenciamento de servidores MCP
│   ├── skills/           # Gerenciamento de skills
│   └── prompts/          # Gerenciamento de prompts
├── data/                 # Dados persistidos
├── package.json
└── README.md

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.

Licença

MIT

Habilidades Relacionadas