Atlas
GitHubDownload

Docs

Getting started

Atlas runs locally and gives your AI tools real context about your codebase. Everything on this page happens on your machine.

DownloadInstallLoad sample repositoryConnect Claude / Cursor / Codex· No login required

Install

Download Atlas for Windows and run the installer. It's self-contained — no Python required, no admin rights, no account. On first launch Atlas starts a local server and opens in your browser. Windows SmartScreen may warn on first run because the installer is not yet code-signed; this is expected for new software.

Quickstart

  1. Open Atlas and click Load sample repository (or scan your own project folder).
  2. Explore the dependency graph, or run Impact on a file to see what a change would affect — every result cites the exact files and dependencies.
  3. Connect Claude, Cursor, or Codex from the home screen so your agent can use the same index.

Demo mode

The HN demo in the app's navigation is a guided tour: load the bundled sample repository, then step through Impact, Debug, and Plan Change on the same sample. Each step is one click and you can skip out at any point. Nothing in demo mode touches your own code.

MCP setup

Atlas ships a local MCP server (18 tools) that Claude Desktop, Cursor, and Codex can call. Each integration on the home screen has its own status, Connect, Test, and an Advanced manual setup fallback that shows the exact file path and snippet.

Claude

Connect to Claude writes the Atlas entry into %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop, then confirm Atlas appears under MCP settings. Use Test in Atlas to verify the server responds before restarting.

Cursor

Connect to Cursor writes ~/.cursor/mcp.json. Restart Cursor, then open Settings → MCP and confirm Atlas is listed and enabled.

Codex

Connect to Codex writes an [mcp_servers.atlas] block into ~/.codex/config.toml (or $CODEX_HOME/config.toml when set). Restart Codex to load Atlas.

Troubleshooting

  • Connect failed / “Manual setup required”: the config file may be missing or unwritable. The manual setup modal shows the exact path and a snippet to paste yourself.
  • Agent doesn't show Atlas after connecting: fully restart the agent (Claude Desktop, Cursor, or Codex) — MCP configs load at startup.
  • Test fails: make sure Atlas is running; the MCP server is launched from the installed Atlas.exe --mcp.
  • Answers look stale after editing files: Atlas blocks stale exports by design — rescan the repository to refresh the index.
  • Anything else: use Support & diagnostics in the app, or email yoavkozlovski@gmail.com.

Privacy & local-first

Repository scanning, the index, and answers are computed on your machine. Atlas does not upload repository contents during indexing and never trains models on your code. The only code-related data that leaves your machine is the context you explicitly copy or send to an agent. Details: Privacy Policy and Security.

Billing

The core local app is free and does not require an account. Pro is $19/month with a 7-day trial, processed by Paddle as Merchant of Record when checkout is enabled — Atlas never stores card details. Cancel anytime from the billing portal. See Pricing and Refund Policy.

FAQ

Short, honest answers to the common objections — uploads, offline use, data location, deletion, repo size, supported languages — live on the FAQ page.

Need help? yoavkozlovski@gmail.com