Atlas

STATE • KNOWLEDGE • GRAPH

Local-first memory and evidence infrastructure for AI agents.
Persist knowledge, project state, relationships and evidence across agents, processes and sessions — entirely on your machine. Atlas remembers.

---

Install

One line. No Git, no Rust, no admin rights. The installer pins the release public key and the SHA-256 of the bootstrap; the bootstrap verifies the signed catalog and every archive (hash + Ed25519) before anything runs.

Windows x86_64 — PowerShell:

irm https://github.com/titans-tools/titans-platform/releases/latest/download/Install-Atlas.ps1 | iex

Linux x86_64:

curl -fsSL https://github.com/titans-tools/titans-platform/releases/latest/download/install-atlas.sh | sh

Already have any Titan? Then it is just:

titans install atlas

Don't want to pipe a script into your shell? Verify everything yourself:

1. Download the archive for your platform from Releases.
2. Download signed-distribution-catalog.json and titans-release-public-key.hex from the platform distribution release.
3. Check the archive's SHA-256 against the catalog entry, and the catalog's Ed25519 signature against the public key.
4. Extract and run bin/atlas — the SBOM ships inside the archive.

macOS and ARM64 are not part of this release.

Why it exists

The moment	With Atlas
An agent finished; a new session starts	The state is still there
"Why did we decide to use X?"	The answer comes back with its evidence
Several agents work the same project	One shared source of truth, scoped by tenant/project
A process restarts	Nothing learned disappears

A search answers with sources, not just a rank:

Query: why postgres?
────────────────────────────────────────
Postgres was chosen for the ledger because
of range partitioning.
Evidence: Kickoff — architecture decision
Signals:  lexical 0.82 · vector 0.91 · graph 0.74
────────────────────────────────────────

What Atlas is

Atlas keeps knowledge packages, a typed graph, work sessions, per-project SQL databases, analytics and blobs in a single transactional store on your machine. Search is hybrid — full text, vectors, graph and evidence — and every write lands in a hash-chained audit log, so "what do we know, and how do we know it" always has a verifiable answer.

Atlas is the authoritative persistence backbone of Titans: a recoverable, versioned source of truth that lets Titans and agents share state through canonical references instead of isolated databases or duplicated context. Nothing is sent anywhere — Atlas binds to loopback, has no telemetry, and works offline (the semantic model downloads on first use; lexical search works before it arrives).

Core capabilities: knowledge storage · full-text search · vector retrieval · knowledge graphs · evidence and context management · sessions and checkpoints · event sourcing · caching · versioning · recovery

The first 60 seconds

atlas status

atlas call atlas atlas_add '{"package":{"schema_version":"atlas/1.0","package_id":"note-1","tenant":"acme","project":"alpha","title":"Kickoff","markdown":"We chose Postgres for the ledger because of range partitioning."}}'

atlas call atlas atlas_search '{"tenant":"acme","project":"alpha","query":"why postgres"}'

The result carries the matching package, the score breakdown per signal and the evidence behind it — not only a rank. Prefer a window? Run atlas with no arguments (or atlas config-ui) to open the local configurator in your browser.

Agents do not need a port

Atlas speaks MCP over stdio. The installer configures one shared MCP server named titans in the AI clients present on the machine (Claude Code, Claude Desktop, VS Code, Codex, Antigravity); every installed Titan appears there without adding another server entry.

titans mcp configure --client vscode --yes

REST (127.0.0.1:7741, OpenAPI at /openapi.json, offline API browser at /docs) and gRPC (127.0.0.1:7742) exist for programs that want them.

What Atlas stores

Everything is scoped by (tenant, project), so many people, projects and agents share one store without stepping on each other.

Domain	What it is	Start with
Knowledge packages	Documents with tags, sources and evidence	atlas_add, atlas_search, atlas_context
Typed graph	Entities and relations in layers	atlas_graph_neighbors, atlas_graph_subgraph, atlas_graph_export_rdf
Work state	Durable contexts, sessions, events, checkpoints and handoffs	atlas_work_contexts, atlas_work_sessions, atlas_work_events
SQL	A real SQLite database per project, quota-bounded	atlas_sql_create, atlas_sql_execute, atlas_sql_query
Analytics	DuckDB aggregation over projections, with sandboxed exports	atlas_analytics_query, atlas_analytics_export
Blobs	Content-addressed storage, chunked uploads, ranged reads	atlas_blob_upload, atlas_blob_download
Audit	A hash chain over every mutation	atlas_audit_verify

Ask atlas_projects_list first (REST: GET /atlas/projects). 109 operations are exposed identically over MCP, REST, gRPC and the Titans Fast Contract.

Updates

Two independently signed channels — a public discovery catalog and a distribution catalog — drive updates. Nothing changes without explicit confirmation, and a version can be pinned.

titans versions check

Free and paid

This release is free. Capabilities and versions that become paid are published in the signed public catalog; rights you acquire for a version stay with that version (see the EULA, §1.3).

Documentation

Quickstart · Security model · Using from AI agents (MCP) · Changelog · Support

Security

Report vulnerabilities privately — see SECURITY.md.

License

Proprietary. Use is governed by the Titans End User License Agreement. Third-party components are listed in the SBOM inside every release archive. This repository hosts the official signed releases; the source code is not published.