atlas

module

v0.1.31 Latest Latest Go to latest Published: Jul 8, 2026 License: Apache-2.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/dominic097/atlas

Links

Open Source Insights

README ¶

Atlas

Deterministic local code intelligence for code review agents and developer tooling.

Atlas builds a local code graph and answers search, impact, route, symbol, coverage, and MCP context questions without sending source code to a hosted service. The default storage engine is embedded SQLite at sqlite://./.atlas/atlas.db.

Binary: atlas
Default mode: local static binary
Storage: embedded SQLite by default, Postgres optional for hosted deployments
Surfaces: CLI, HTTP API, MCP, SDK

Install

# from the checked-out source
make build
./bin/atlas version

# after a release is published
brew install --cask dominic097/atlas/atlas
npm install -g @aziron/atlas

Homebrew installs from the public dominic097/homebrew-atlas tap. The npm wrapper is published as @aziron/atlas and exposes the binary command as atlas. The exact unscoped npm package name atlas is already owned by another maintainer, so publishing that name still requires owner access or transfer.

Quickstart

atlas index .                       # parse and persist the graph
atlas search "checkout cart"         # code-aware lexical search
atlas impact --paths svc/cart.go     # single-repo blast radius
atlas status                         # tier, storage driver, freshness

HTTP API

atlas serve                                  # listens on :3099, opens the dashboard
curl localhost:3099/api/v1/status
curl "localhost:3099/api/v1/search?q=Checkout"

MCP

atlas mcp --transport stdio
atlas install skill --agent claude

Editors and local agents can spawn atlas mcp and retrieve bounded context for code review without first loading the whole repository into the model.

SDK

The SDK exposes the same engine used by the CLI and API. It is intended for in-process integrations that need deterministic code graph context without an extra service hop.

Build And Test

make build
make test
go test ./...

Release Outputs

Tagged releases produce:

macOS and Linux atlas archives for amd64 and arm64
Linux .deb, .rpm, and .apk packages
checksums, SBOMs, and keyless cosign signatures
a Homebrew cask in dominic097/homebrew-atlas
an npm wrapper package named @aziron/atlas that exposes atlas

License

Apache-2.0. See LICENSE.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
atlas command Command atlas is the CLI entrypoint for a local code knowledge graph.	Command atlas is the CLI entrypoint for a local code knowledge graph.
internal
analytics Package analytics implements DETERMINISTIC, LLM-FREE graph analytics over the snapshot's symbol call graph.	Package analytics implements DETERMINISTIC, LLM-FREE graph analytics over the snapshot's symbol call graph.
api Package api implements consumption surface S2: the REST HTTP API exposed by `atlas serve`.	Package api implements consumption surface S2: the REST HTTP API exposed by `atlas serve`.
api/ui
cli Package cli implements consumption surface S1: the `atlas` command tree for humans, scripts, and CI.	Package cli implements consumption surface S1: the `atlas` command tree for humans, scripts, and CI.
coverage Package coverage parses runtime test-coverage profiles into per-file sets of covered line numbers.	Package coverage parses runtime test-coverage profiles into per-file sets of covered line numbers.
crossrepo Package crossrepo is the cross-repo impact engine — the Atlas USP.	Package crossrepo is the cross-repo impact engine — the Atlas USP.
embed Package embed is Atlas's OPTIONAL, gated embedding layer for semantic_search.	Package embed is Atlas's OPTIONAL, gated embedding layer for semantic_search.
engine Package engine is the composition root.	Package engine is the composition root.
episodes Package episodes turns agent transcripts (Claude Code project JSONL, Codex rollout JSONL) into normalized, redacted task episodes — the C1 capture channel of docs/ATLAS_FLEET_PLAN.md §3.0.	Package episodes turns agent transcripts (Claude Code project JSONL, Codex rollout JSONL) into normalized, redacted task episodes — the C1 capture channel of docs/ATLAS_FLEET_PLAN.md §3.0.
export Package export serializes a slice of the code knowledge graph into portable formats: a graphify-compatible JSON graph, a Mermaid flowchart, and Graphviz DOT.	Package export serializes a slice of the code knowledge graph into portable formats: a graphify-compatible JSON graph, a Mermaid flowchart, and Graphviz DOT.
gotypes Package gotypes is the precise, type-checked Go analyzer that closes two quality residuals the lexical/AST parser cannot reach without full type information:	Package gotypes is the precise, type-checked Go analyzer that closes two quality residuals the lexical/AST parser cannot reach without full type information:
graph Package graph holds the pure, persistence-agnostic data model for the Atlas code knowledge graph.	Package graph holds the pure, persistence-agnostic data model for the Atlas code knowledge graph.
identity Package identity derives a stable per-machine device identity for the Atlas fleet uplink (docs/ATLAS_FLEET_PLAN.md §2.1).	Package identity derives a stable per-machine device identity for the Atlas fleet uplink (docs/ATLAS_FLEET_PLAN.md §2.1).
index concurrent.go overlaps the two INDEPENDENT terminal writes of an index run — persisting the snapshot to the StorageDriver and (re)building the lexical (BM25) index — so they execute at the same time instead of strictly back-to-back.	concurrent.go overlaps the two INDEPENDENT terminal writes of an index run — persisting the snapshot to the StorageDriver and (re)building the lexical (BM25) index — so they execute at the same time instead of strictly back-to-back.
install Package install implements the config-writing logic behind `atlas install`: registering Atlas as an MCP server in assistant configs (claude/cursor/gemini/ codex/copilot) and writing git hooks that keep the local graph fresh.	Package install implements the config-writing logic behind `atlas install`: registering Atlas as an MCP server in assistant configs (claude/cursor/gemini/ codex/copilot) and writing git hooks that keep the local graph fresh.
lexical Package lexical implements an on-disk bleve (BM25) symbol index with a code-aware analyzer.	Package lexical implements an on-disk bleve (BM25) symbol index with a code-aware analyzer.
mcp Package mcp implements consumption surface S3: an MCP server exposing Atlas graph/search/impact as tools to LLM agents (Claude Code, Cursor, Codex, Gemini, Copilot) over stdio (and, in the full build, HTTP + legacy SSE).	Package mcp implements consumption surface S3: an MCP server exposing Atlas graph/search/impact as tools to LLM agents (Claude Code, Cursor, Codex, Gemini, Copilot) over stdio (and, in the full build, HTTP + legacy SSE).
parser Package parser is Atlas's multi-language code parser.	Package parser is Atlas's multi-language code parser.
parser/tree_sitter_objc
parser/tree_sitter_p4
parser/tree_sitter_pascal
parser/tree_sitter_powershell
parser/tree_sitter_sfapex
parser/tree_sitter_swift
query Package query implements pure, in-memory graph queries over a loaded snapshot — the slices of symbols and edges the engine passes in.	Package query implements pure, in-memory graph queries over a loaded snapshot — the slices of symbols and edges the engine passes in.
recall Package recall is the deterministic, LLM-free core of Atlas Recall — the self-building org automation layer that attacks repeated-prompt token waste (docs/ATLAS_RECALL_PLAN.md).	Package recall is the deterministic, LLM-free core of Atlas Recall — the self-building org automation layer that attacks repeated-prompt token waste (docs/ATLAS_RECALL_PLAN.md).
routes Package routes is Atlas's content/regex-based HTTP route-contract extractor — the cross-repo moat's data producer.	Package routes is Atlas's content/regex-based HTTP route-contract extractor — the cross-repo moat's data producer.
runtimecfg Package runtimecfg centralizes process-wide Go runtime tuning (the soft memory limit and GC aggressiveness) so every Atlas entrypoint applies it the same way.	Package runtimecfg centralizes process-wide Go runtime tuning (the soft memory limit and GC aggressiveness) so every Atlas entrypoint applies it the same way.
skillpack Package skillpack implements the on-disk, user-authorable skill pack format (docs/ATLAS_FLEET_PLAN.md §3.2): ~/.atlas/skills/<slug>/ holding skill.yaml + SKILL.md + scripts/.	Package skillpack implements the on-disk, user-authorable skill pack format (docs/ATLAS_FLEET_PLAN.md §3.2): ~/.atlas/skills/<slug>/ holding skill.yaml + SKILL.md + scripts/.
store Package store defines the StorageDriver interface — the keystone of the two-tier spin-out.	Package store defines the StorageDriver interface — the keystone of the two-tier spin-out.
sync Package sync implements the spoke side of the Atlas fleet plane (docs/ATLAS_FLEET_PLAN.md §2): the durable client config written by `atlas connect`, and the cursor-walking telemetry/episode uplink loop.	Package sync implements the spoke side of the Atlas fleet plane (docs/ATLAS_FLEET_PLAN.md §2): the durable client config written by `atlas connect`, and the cursor-walking telemetry/episode uplink loop.
telemetry Package telemetry is Atlas's OBSERVABILITY layer: a non-blocking async recorder for agent-facing tool calls, a periodic sampler of the Atlas process's own resource footprint, and a tiny pub/sub bus so an HTTP SSE handler can push live updates instead of the dashboard polling for them.	Package telemetry is Atlas's OBSERVABILITY layer: a non-blocking async recorder for agent-facing tool calls, a periodic sampler of the Atlas process's own resource footprint, and a tiny pub/sub bus so an HTTP SSE handler can push live updates instead of the dashboard polling for them.
watch Package watch keeps an Atlas graph fresh automatically.	Package watch keeps an Atlas graph fresh automatically.
pkg
atlas Package atlas is the public, import-stable SDK facade for the embeddable Atlas engine (consumption surface S4a).	Package atlas is the public, import-stable SDK facade for the embeddable Atlas engine (consumption surface S4a).
atlasclient Package atlasclient is a hand-written HTTP client for the Atlas REST API (consumption surface S2, served by `atlas serve`).	Package atlasclient is a hand-written HTTP client for the Atlas REST API (consumption surface S2, served by `atlas serve`).