chrisfentiman/claude-context-cli

O que claude-context-cli faz?

CLI de indexação automática para claude-context-mcp (npm: claude-context-cli)

Visão Geral

O claude-context-cli é uma ferramenta de linha de comando que indexa automaticamente o conteúdo do seu projeto, gerando um arquivo de contexto que pode ser consumido pelo servidor MCP claude-context-mcp. Isso permite que agentes de IA, como Claude Code, tenham acesso a uma representação estruturada e atualizada do seu código, facilitando operações como análise, refatoração e geração de código.

Instalação

npm install -g claude-context-cli

Uso

Execute o CLI no diretório raiz do seu projeto:

claude-context-cli index

Este comando irá:

• Varrer recursivamente os arquivos do projeto (excluindo node_modules, .git e outros padrões ignorados)
• Extrair informações chave como caminhos, funções, classes e dependências
• Gerar um arquivo claude-context.json no diretório raiz

Opções

Flag	Descrição
-w, --watch	Monitora alterações em tempo real e reindexa automaticamente
-o, --output <path>	Define o caminho de saída personalizado para o arquivo de contexto
-i, --ignore <pattern>	Ignora padrões adicionais de arquivos (pode ser usado múltiplas vezes)
-h, --help	Exibe ajuda e informações de uso

Configuração

Você pode criar um arquivo claude-context.config.js ou claude-context.config.json na raiz do seu projeto com opções adicionais:

{
  "output": "./context/claude-context.json",
  "ignores": ["dist", "*.min.js"],
  "watch": true
}

Integração com MCP

Para integrar com o servidor claude-context-mcp, certifique-se de que ele esteja configurado para ler o arquivo gerado. Exemplo de configuração no mcp.json:

{
  "servers": [
    {
      "name": "claude-context-mcp",
      "command": "claude-context-mcp",
      "args": ["--context-file", "claude-context.json"],
      "env": {}
    }
  ]
}

Comandos

Comando	Descrição
index	Indexa o projeto e gera o arquivo de contexto
clean	Remove o arquivo de contexto gerado
status	Exibe o status atual da indexação
validate	Valida a integridade do arquivo de contexto

Exemplo

cd meu-projeto
claude-context-cli index --watch --output ./contexto.json

Isso iniciará a indexação do projeto e monitorará alterações, atualizando o arquivo de contexto automaticamente.

Suporte

Para relatar problemas ou sugerir melhorias, visite o repositório no GitHub.