Cntx UI

cntx-ui

Análise semântica de código e gerenciamento de contexto para agentes de IA. Transforma um codebase em contexto estruturado e pesquisável que os agentes podem navegar com eficiência.

O que faz

• Análise semântica — analisa seu código no nível de funções usando tree-sitter, extrai propósito, complexidade e relacionamentos
• Busca vetorial local — gera embeddings de chunks de código localmente (all-MiniLM-L6-v2 via Transformers.js) para busca por similaridade semântica sem chamadas externas de API
• Sistema de bundles — agrupa arquivos em bundles lógicos (por feature, camada ou padrão) para entrega estruturada de contexto
• Servidor MCP — expõe mais de 28 ferramentas para Claude Code, Claude Desktop ou qualquer cliente compatível com MCP
• Dashboard web — interface visual em localhost:3333 para gerenciar bundles, navegar pela análise semântica e editar regras do agente
• Sincronização em tempo real — monitora alterações de arquivos e mantém análise, bundles e embeddings atualizados

Instalação

npm install -g cntx-ui

Uso

cntx-ui init          # scaffold .cntx directory, generate .mcp.json
cntx-ui watch         # start web server on port 3333
cntx-ui mcp           # start MCP server on stdio
cntx-ui bundle <name> # regenerate a specific bundle
cntx-ui status        # show project health and bundle state
cntx-ui setup-mcp     # configure Claude Desktop integration

Após cntx-ui init, os agentes descobrem ferramentas automaticamente via .mcp.json. O arquivo .cntx/AGENT.md fornece um handshake de integração com referência de ferramentas e visão geral do projeto.

Interface do agente

Os agentes interagem por meio das ferramentas MCP ou da API HTTP:

Ferramenta MCP	O que faz
agent/discover	Visão geral arquitetural do codebase
agent/query	Busca semântica — "onde a autenticação é tratada?"
agent/investigate	Encontra pontos de integração para uma nova feature
agent/organize	Audita e otimiza a estrutura de bundles
artifacts/list	Lista artefatos normalizados do projeto (OpenAPI + Navigation)
artifacts/get_openapi	Retorna resumo e payload do artefato OpenAPI
artifacts/get_navigation	Retorna resumo e payload do artefato Navigation
artifacts/summarize	Resumo compacto entre artefatos para agentes
list_bundles	Lista todos os bundles com metadados
get_bundle	Obtém conteúdo completo do bundle como XML
get_semantic_chunks	Obtém todos os chunks de código analisados
read_file / write_file	Operações de arquivo com contexto de bundle

A referência completa de ferramentas com parâmetros é gerada em .cntx/AGENT.md e .cntx/TOOLS.md.

Endpoints HTTP de artefatos:

• GET /api/artifacts
• GET /api/artifacts/openapi
• GET /api/artifacts/navigation

Como funciona

1. tree-sitter analisa arquivos de origem em AST, extrai funções/tipos/interfaces
2. Mecanismo de heurísticas classifica cada chunk por propósito, domínio de negócio e padrões técnicos com base em caminhos de arquivo, imports e convenções de nomenclatura
3. Embeddings são gerados localmente e armazenados em SQLite para busca vetorial persistente
4. Bundles agrupam arquivos por padrões glob — sugeridos automaticamente na inicialização com base na estrutura do projeto
5. Servidor MCP e API HTTP expõem tudo aos agentes com formatos de resposta consistentes

Stack tecnológica

• Node.js, better-sqlite3, ws (WebSocket)
• tree-sitter (análise AST), Transformers.js (embeddings locais)
• React 19, TypeScript, Vite, Tailwind CSS (dashboard web)
• Model Context Protocol (MCP) via JSON-RPC 2.0

Licença

MIT