Repolode
Enviar
cocoindex-io

cocoindex-io/cocoindex-code

CLI de busca semântica de código baseada em AST e servidor MCP que indexa sua base de código para que agentes de programação encontrem código pelo significado.

Ver no GitHubSite
Estrelas
2,965
Forks
248
Issues abertas
54
Último commit
anteontem

O que é?

cocoindex-code é uma ferramenta leve de busca semântica em bases de código locais. Ela analisa arquivos de origem com tree-sitter e os divide em trechos baseados em AST, gera embeddings e armazena o índice localmente para que você possa buscar por descrições em linguagem natural, em vez de texto exato. A ferramenta é baseada no mecanismo de transformação de dados em Rust do CocoIndex e reindexa apenas os arquivos que foram alterados.

Ela pode ser usada pela linha de comando com comandos como ccc index e ccc search, ou conectada a agentes de programação, como Claude Code e Codex, por meio de um servidor MCP (ccc mcp) ou de uma skill instalável para agentes. Um comando separado, ccc grep, faz buscas estruturais por exemplo de código sem exigir um índice.

Os embeddings podem vir de um modelo local do SentenceTransformers, que não precisa de chave de API quando instalado com o extra completo, ou de provedores na nuvem por meio do LiteLLM. A configuração fica em arquivos YAML globais e específicos de cada projeto, e há uma imagem Docker disponível para ambientes em contêineres.

Recursos principais

  • 01Busca código pelo significado usando consultas em linguagem natural, em vez de correspondência exata de texto.
  • 02Analisa várias linguagens com tree-sitter, incluindo Python, TypeScript, Rust, Go, Java e C/C++.
  • 03Reindexa apenas os arquivos alterados para manter as atualizações rápidas.
  • 04Disponibiliza a busca como ferramenta MCP para agentes de programação, como Claude Code e Codex.
  • 05Oferece suporte a modelos locais de embeddings ou provedores de embeddings na nuvem via LiteLLM.
  • 06Oferece o comando ccc grep para buscas estruturais por exemplo de código, sem precisar de um índice.

Casos de uso

  • Ajudar um agente de programação a localizar código relevante em um repositório grande e desconhecido.
  • Encontrar implementações descrevendo o comportamento quando não se sabe o nome exato da função ou variável.
  • Reduzir o uso de tokens por agentes de programação, recuperando apenas os trechos de código relevantes.
  • Fazer buscas privadas de código localmente com um modelo local de embeddings e sem chave de API.

Início rápido

  1. 1

    Instale a CLI com pipx (inclui tudo o que é necessário)

    pipx install 'cocoindex-code[full]'
  2. 2

    Instale a skill ccc no seu agente de programação

    npx skills add cocoindex-io/cocoindex-code
  3. 3

    Ou crie o índice manualmente no seu projeto

    ccc index
  4. 4

    Pesquise na base de código por significado

    ccc search "authentication logic"

Antes de usar

  • A instalação completa baixa cerca de 1 GB de torch e transformers para gerar embeddings localmente.
  • A variante slim requer um provedor de embeddings na nuvem e uma chave de API.

Em coleções

Servidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IAServidores MCPFerramentas de CLI e terminal

Tópicos

#code-search#semantic-search#ast#mcp#coding-agent#tree-sitter#embeddings#cli#agents#claude-code

Perguntas frequentes

O que é cocoindex-code?
CLI de busca semântica de código baseada em AST e servidor MCP que indexa sua base de código para que agentes de programação encontrem código pelo significado. cocoindex-code é uma ferramenta leve de busca semântica em bases de código locais. Ela analisa arquivos de origem com tree-sitter e os divide em trechos baseados em AST, gera embeddings e armazena o índice localmente para que você possa buscar por descrições em linguagem natural, em vez de texto exato. A ferramenta é baseada no mecanismo de transformação de dados em Rust do CocoIndex e reindexa apenas os arquivos que foram alterados.
cocoindex-code é gratuito? Qual é a licença?
cocoindex-code é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
cocoindex-code ainda é mantido?
Manutenção ativa. O último commit de cocoindex-code foi em 4 de nov. de 2026.
Para que posso usar cocoindex-code?
Ajudar um agente de programação a localizar código relevante em um repositório grande e desconhecido. Encontrar implementações descrevendo o comportamento quando não se sabe o nome exato da função ou variável. Reduzir o uso de tokens por agentes de programação, recuperando apenas os trechos de código relevantes. Fazer buscas privadas de código localmente com um modelo local de embeddings e sem chave de API.
Como instalar cocoindex-code?
Instale a CLI com pipx (inclui tudo o que é necessário): pipx install 'cocoindex-code[full]' Instale a skill ccc no seu agente de programação: npx skills add cocoindex-io/cocoindex-code Ou crie o índice manualmente no seu projeto: ccc index Pesquise na base de código por significado: ccc search "authentication logic"
Onde consigo cocoindex-code?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cocoindex-io/cocoindex-code

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados