convez · CLI

Instale plugins do Claude Code em 1 comando. O convez é um wrapper dos comandos nativos claude plugin, conectado ao diretório convez.ai.

Uso

# Instalar plugin de qualquer repositório GitHub
npx convez-ai obra/superpowers --plugin superpowers

# Instalar direto do marketplace Convez
npx convez-ai install exemplo

# Buscar no diretório convez.ai
npx convez-ai search deploy

# Gerenciar
npx convez-ai list
npx convez-ai update exemplo
npx convez-ai remove exemplo

Flags

| Flag | Descrição | |------|-----------| | --plugin, -p <nome> | Nome do plugin quando o repo contém vários | | --scope, -s <escopo> | user (padrão), project ou local |

Como funciona

1. Repo com marketplace.json → roda claude plugin marketplace add owner/repo + claude plugin install nome@marketplace.
2. Repo de plugin avulso (só plugin.json) → gera um marketplace wrapper local em ~/.convez/wrappers/ e instala a partir dele.
3. search → consulta GET https://convez.ai/api/search?q= e exibe os resultados com o comando de instalação pronto.

Pré-requisito

O Claude Code instalado:

npm install -g @anthropic-ai/claude-code

Se o binário claude não estiver no PATH, o CLI mostra um erro amigável com o link de instalação. Funciona em Windows (PowerShell), macOS e Linux. Requer Node 18+.

Desenvolvimento

npm install
npm run build   # compila TypeScript para dist/
npm test        # node --test (parsing de args + detecção marketplace vs plugin)

Para apontar o search para uma API local: CONVEZ_API_URL=http://localhost:3000/api/search npx convez-ai search foo

Mantido por Convez · Licença MIT