Sem uma API para começar
Tree-sitter, FastEmbed e LanceDB preparam e consultam o índice sem enviar o código a um serviço externo. O chat do seu editor mantém sua própria fronteira de dados.
Servidor MCP de busca e contexto do repositório
Inteligência
precisa de contexto
O agente precisa encontrar o código certo, entender suas relações e saber o que consultar a seguir. O Atlas coloca o repositório no contexto da decisão.
- Local por padrão
- Aberto no GitHub
- Conectado via MCP
atlas_search“onde o índice é atualizado quando um arquivo muda?”- 01código
src/index/incremental.py:48
def reindex_changed(workspace)
- 02código
src/server/tools.py:112
atlas_index(mode="incremental")
- 03doc
docs/decisions/dec-003-indexacao.md
## Reprocessar só o que mudou
índice local · fonte para conferir
O mecanismo
O que precisa existir antes de mudar uma linha de código
Encontrar, entender e só então agir. Cada etapa entrega ao agente uma parte verificável do projeto.
01
Uma pergunta precisa de um ponto de partida
“Onde a autenticação acontece?” é uma pergunta sobre o projeto. O Atlas busca código e documentos para localizar os símbolos e arquivos que ajudam a respondê-la. O agente recebe caminhos, linhas e referências para conferir a fonte.
02
O contexto respeita a estrutura do código
Classes, funções e métodos têm limites. O Atlas usa a árvore sintática para indexar esses escopos e preservar suas assinaturas. A unidade de contexto acompanha o que o código faz, em vez de seguir cortes arbitrários de linhas.
03
O nome exato e a intenção se encontram
A busca lexical encontra os termos. A vetorial aproxima significados. O Atlas combina os dois caminhos e reordena os candidatos. Assim, a consulta pode começar com um identificador ou com uma pergunta em linguagem natural.
04
Um arquivo não explica o sistema sozinho
O grafo conecta símbolos, imports e documentos. Ajuda a investigar dependências, caminhos e o alcance de uma mudança. A cobertura e a origem das relações ficam declaradas; chamadas de função dependem do índice SCIP opcional.
05
O próximo passo determina o pacote
Entender, editar, depurar ou revisar pedem contextos diferentes. O atlas_context reúne informações para essa intenção, com teto de resposta. No perfil compacto, o agente expande só as referências de que precisa.
06
O índice acompanha o repositório
A indexação incremental compara o conteúdo dos arquivos. Reprocessa o que mudou, remove o que deixou de existir e reaproveita o restante. O status permite conferir o estado do índice; o acompanhamento automático é opcional.
07
Os limites também fazem parte da resposta
Uma linguagem sem resolução de imports, um braço de busca indisponível ou uma resposta cortada precisam ser visíveis. O Atlas declara essas condições para que o agente possa decidir o próximo passo com evidência.
Do pedido à fonte
Menos arquivos abertos. Mais contexto útil.
O Atlas é um servidor MCP. Seu editor faz a chamada; o Atlas consulta o índice local e devolve os trechos relevantes. O agente continua responsável por ler a evidência e conduzir a tarefa.
Código e documentação na mesma busca
Encontre a implementação e os documentos que ajudam a explicar suas decisões.
Aprofundamento sob demanda
Localize primeiro. Abra a fonte ou expanda uma referência quando faltar evidência.
Pergunta do agente
“Onde o índice é atualizado quando um arquivo muda?”
- 01
atlas_searchLocaliza os candidatos e suas linhas.
- 02
atlas_contextReúne o contexto para entender a mudança.
- 03
atlas_expandAbre o trecho que ainda precisa de leitura.
Da pergunta ao símbolo. Com a fonte para conferir.
Ferramentas
Uma ferramenta para cada próxima pergunta.
A interface acompanha o trabalho do agente: orientar, localizar, aprofundar e conferir.
01
atlas_briefQue projeto é este?
Um briefing com identidade, camadas, pontos de entrada e hubs do repositório.
02
atlas_searchOnde isso está implementado?
Busca híbrida em código e documentos, com filtros e localização na fonte.
03
atlas_contextO que preciso saber para esta tarefa?
Um pacote de contexto para entender, editar, depurar ou revisar um alvo.
04
atlas_expandPosso ler este trecho?
Expansão por referência. Classes grandes podem abrir com um outline de métodos.
05
atlas_graphO que se conecta e o que pode ser afetado?
Relações, hubs, caminhos e alcance de mudanças no grafo do projeto.
06
atlas_indexComo preparo ou atualizo a busca?
Indexação do workspace inteiro ou de pastas específicas, com prévia e modo incremental.
07
atlas_statusEm que estado está o índice?
Diagnóstico de frescor, cobertura de resolução e camadas opcionais.
No seu fluxo
Na IDE que o time já usa.
Conecte o Atlas a um cliente MCP compatível e consulte o projeto de onde você trabalha.
Cursor
Claude Code
GitHub Copilot
Antigravity
Kiro- OpenCode
Codex
Local-first
O código fica na sua máquina. Por padrão.
Embeddings locais, índice embutido e busca no próprio host. Depois do download inicial das dependências e do modelo, o caminho padrão funciona offline.
Conhecer a fronteira de dadosVocê escolhe o que habilitar
A camada semântica e a relevância com Jev ficam desligadas por padrão. O Jev avalia os candidatos via OpenRouter e, no perfil compacto, corta resultados de baixa relevância. A origem e o egresso ficam inspecionáveis no status.
O estrutural permanece disponível
Falhas nas camadas opcionais geram avisos e preservam a recuperação estrutural. O contexto continua ancorado no repositório.
Ecossistema CodeSteer
A squad dirige. O Atlas encontra.
O CodeSteer organiza a entrega com propósito, limites e prova. O Atlas fornece a busca e o contexto do repositório que ajudam o agente a trabalhar com evidência.
Conhecer o CodeSteerO próximo passo
O contexto começa no seu repositório.
Prepare a busca, conecte seu editor e faça a primeira pergunta sobre o projeto.
macOS, Linux e Windows · Python + uv · Índice local