cie

cie — o único grafo de código que sabe quais tarefas e testes realmente implementam seu código.

Para onde isso está indo: vision.md — a margem distante. O grafo se torna o software; repositórios se tornam seu cache. Software que sempre pode se explicar. Uma bússola, não uma afirmação.

Code Insight Engine. Nenhuma outra ferramenta de grafo de código pesquisada consegue responder "quais arquivos implementam esta tarefa, e eles estão testados?" como uma única consulta. Tudo voltado para desenvolvedores vive na wiki — arquitetura escrita a partir do código-fonte, e um guia prático para cada fluxo de trabalho. Este README permanece enxuto: a demonstração, a instalação e como ajudar.

Cada segundo é uma sessão real gravada, nada encenado: este repositório clonado da tag pública v0.1.4, cie index . em 1,9s (1.902 nós · 6.581 arestas · 4.169 chamadas), o comando de uma linha do README registrando-o com o Claude Code (✔ Connected), e então UMA pergunta em palavras simples — sobre resolve_backend, a regra de seleção de armazenamento — respondida a partir das ferramentas do cie sozinho (os recursos integrados do agente foram desativados para a gravação: callers → affected_by → test_map eram seu único caminho). O agente retornou os 7 testes de fixação com números de linha, incluindo o teste adicionado para o bug explícito de auto corrigido no mesmo dia. O GIF é editado apenas por tempo — o conteúdo nunca é editado; as sessões sem cortes acompanham o repositório: resolve-backend-uncut.cast (a gravação do agente) e setup-uncut.cast (índice → registrar → conectado). Registro completo da gravação/QC: docs/demo/production-log.md.

Instalação

Um clique, sem clone, sem Neo4j, sem cadastro — instale uma vez a partir de uma tag de versão, e então um comando por projeto o indexa, registra o cie com seu cliente MCP (entrada robusta a spawn: caminho absoluto, para que clientes iniciados por GUI o encontrem) e escreve os arquivos de contexto do agente:

# once per machine (latest tag):
uv tool install "cie-mcp[mcp] @ git+https://github.com/kannamma-labs/cie.git@v0.1.5"

# per project — from inside the project:
cie index .        # ~1.9s on a 110-file repo
cie init .         # registers the client, writes AGENTS.md/CLAUDE.md

Já instalou e prefere o caminho pelo lado do cliente?

claude mcp add cie -- $(command -v cie-mcp) /path/to/your/project --backend embedded --policy readonly

Pip simples também funciona:

pip install "cie-mcp[mcp]"   # core + MCP server (cie-mcp) — what most people want
pip install "cie-mcp[http]"  # + the HTTP tool-mount (cie/routes.py)

Nota sobre o nome do pacote (atualizado em 2026-08-31, v0.1.1): a distribuição é publicada como cie-mcp — o nome cie no PyPI pertence a um projeto não relacionado (cluster311/cie10, códigos CID-10; pip install cie NÃO fornece esta ferramenta — nunca forneceu). O pacote de importação permanece cie; os scripts de console permanecem cie e cie-mcp. Instalações via GitHub são uma alternativa equivalente: pip install "cie-mcp[mcp] @ git+https://github.com/kannamma-labs/cie.git@v0.1.5".

Dependências principais: Pydantic v2, tree-sitter (+ gramáticas de Python/JS/TS/Java/Go/ Rust/C/C++/C#), watchdog, Click, Rich; o driver do Neo4j apenas quando você usa esse backend. Python ≥ 3.10. O armazenamento é selecionado automaticamente (sirva .cie/graph.db quando você indexou, caso contrário Neo4j — informado no stderr na inicialização, nunca silencioso).

Mais: servir para Cursor/Codex, múltiplos projetos, modo de equipe Neo4j, busca semântica, HTTP, políticas, solução de problemas — cada fluxo de trabalho tem um guia prático na wiki (comece com install-and-serve).

Colaboradores bem-vindos

cie é um núcleo pequeno com uma superfície desproporcional (135 ferramentas, 9 linguagens, dois backends de armazenamento, três front-ends) e uma cultura que você pode ver nos commits: DoD = verificado contra o ambiente real, nunca apenas escrito; falhas são publicadas, não escondidas. A demonstração acima foi produzida por dogfooding — e a medição do dogfood encontrou (e corrigiu) um bug real do produto no mesmo dia. Esse é o estilo de trabalho.

Formas de entrar, da mais fácil para a mais difícil:

• Use e relate — indexe seu repositório, faça perguntas de impacto, registre o que está errado ou o que está faltando. O guia de solução de problemas lista as arestas conhecidas com honestidade.
• Uma lacuna medida — a heurística de TESTES de chamadas diretas foi lançada porque uma medição de dogfood mostrou 1 aresta em uma suíte de 308 testes. Encontre um número como esse, e a correção entra.
• Um primeiro PR — comece com o rótulo good first issue (cada um nomeia um módulo de ponto de entrada seguro e critérios de aceitação) ou as issues #17–#19.
• Documentação — guias práticos da wiki contam. Se você desejou que uma página existisse, escreva-a; se a wiki e o código discordarem, o código vence e a wiki recebe um PR.

A configuração de desenvolvimento são três comandos (clone, uv venv + instalação editável, python -m pytest -q — 312 passando): os detalhes, o harness de conformidade e o padrão de honestidade estão em CONTRIBUTING.md e na página de contribuição da wiki. A seção "Becoming a second maintainer" do CONTRIBUTING.md é o caminho além de um PR pontual.

Licença

cie é lançado sob a Licença MIT.

Ao contribuir, você concorda que suas contribuições são licenciadas sob os mesmos termos.