Skip to content
Back to search

atlas

MarketplaceWorks with Claude CodeGitHub

atlas: a local index and memory store for Claude Code agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bloodfeast/atlas with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bloodfeast/atlas'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bloodfeast--atlas/badge.svg)](/listings/bloodfeast--atlas)

HTML

<a href="/listings/bloodfeast--atlas"><img src="/api/listings/bloodfeast--atlas/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

atlas is a Claude Code plugin with prebuilt binaries for Windows x86_64, Linux x86_64 and aarch64, and macOS (Apple Silicon and Intel). In Claude Code:

/plugin marketplace add bloodfeast/atlas
/plugin install atlas@atlas

Restart Claude Code. On its first start atlas writes a starter configuration, `atlas.json`, in your configuration folder (`%APPDATA%\atlas`, `~/Library/Application Support/atlas` or `~/.config/atlas`) and downloads the embedding model (about 35 MB) in the background, checked against its pinned SHA-256. Until the model is in place, search and recall are lexical. Updates are signed and on by default (`atlas settings off update` turns them off). Building from source, uninstalling and the data folders are on [Install and setup](https://github.com/bloodfeast/atlas/wiki/Install-and-setup).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "atlas",
  3. "description": "atlas: a local index and memory store for Claude Code agents.",
  4. "owner": {
  5. "name": "Brandon White"
  6. },
  7. "plugins": [
  8. {
  9. "name": "atlas",
  10. "source": "./",
  11. "description": "A local index and memory store for agents: identifier lookup, section search, a code index, append-only memory, relevance-gated recall and a context-cap hook.",
  12. "license": "Apache-2.0",
  13. "category": "productivity"
  14. }
  15. ]
  16. }
README.md · README · 99 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # atlas
  2. atlas makes long Claude Code sessions cheaper without changing how you work. It is a local MCP server and a set
  3. of Claude Code hooks: large tool output stays on disk behind a short handle and the model gets a digest, code
  4. reads get exact item ranges instead of guessed windows, and project memory (rules, decisions, journals,
  5. handoffs) is recalled by relevance instead of loaded whole.
  6. It is for anyone who runs long Claude Code sessions, or many agents, on one codebase. It runs on your machine
  7. and makes no network calls at query time.
  8. **You do not need Obsidian.** A vault is any folder of Markdown files; Obsidian is an optional reader for it.
  9. Memory, search and the hooks work whatever language a project is written in. The code index covers Rust, Go,
  10. TypeScript, JavaScript, Python, C#, Java, Kotlin, WGSL and Protocol Buffers, and any language with a SCIP
  11. indexer ([Code index](https://github.com/bloodfeast/atlas/wiki/Code-index)).
  12. ## Install
  13. Prebuilt for Windows x86_64, Linux x86_64 and aarch64, and macOS (Apple Silicon and Intel). In Claude Code:
  14. ```
  15. /plugin marketplace add bloodfeast/atlas
  16. /plugin install atlas@atlas
  17. ```
  18. Restart Claude Code and open a session in your project. Claude asks whether to create a vault for it; say yes.
  19. It also asks whether to run in orchestrated mode, and no is fine. Then work as usual.
  20. - The first start writes `atlas.json` in your configuration folder and fetches the embedding model (about
  21. 35 MB, checked against a pinned SHA-256). Search and recall are lexical until it lands.
  22. - Updates are signed and on by default. `atlas settings off update` turns them off.
  23. - `atlas settings undo` reverts any change atlas made to your setup. It never deletes a note.
  24. Setup questions, several repositories in one project, building from source and uninstalling are on
  25. [Install and setup](https://github.com/bloodfeast/atlas/wiki/Install-and-setup) and
  26. [Projects and multi-repo](https://github.com/bloodfeast/atlas/wiki/Projects-and-multi-repo).
  27. ## What it saves
  28. Every turn re-reads the whole context, so output that enters early is paid for on every later turn. Before
  29. atlas, shell reads were 36% of what a builder session processed and startup context another 35%; those are
  30. what atlas cuts. Measured:
  31. | What | Measured | Turned on by | Method |
  32. |---|---|---|---|
  33. | Lookups | 6.1x fewer tokens than grep and file reads (ratio of sums over 8,639 answers on one store; 10.3x median), at v0.10.0 | on by default | [Headline figures](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method#headline-figures) |
  34. | Memory questions | 100 of 100 answered, median 506 tokens each, on the 100-question memory eval, at v0.10.0 | on by default | [Headline figures](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method#headline-figures) |
  35. | The tool list, in every session | 14 tools in 6,042 bytes (about 1,510 tokens), down from 47 tools and 5,930 tokens; a test holds the budget | always | [Headline figures](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method#headline-figures) |
  36. | Recall on each prompt | 1 of 30 off-topic prompts gets a record; about 50 tokens injected per prompt over a 303-prompt replay, at v0.10.0 | `recall.budget_tokens` 600, `recall.cos_floor` 0.53 and `recall.inject_floor` 0.60, the defaults | [Headline figures](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method#headline-figures) |
  37. | Weak injections | 2,739 low-cosine pointers dropped, about 27k tokens a week over 14 days of one store, memory eval unchanged, at v0.9.0 | `recall.inject_floor` 0.60, the default | [Headline figures](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method#headline-figures) |
  38. | Subagent start | about 210 tokens against 649 for the default, informing 18 needs against 1 on 30 real launches, at v0.9.0 | `"recall": {"subagent_context": "binding"}`, off by default | [Headline figures](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method#headline-figures) |
  39. `atlas --token-report` measures your own store the same way, against your Claude Code transcripts from before
  40. atlas: a summary in about 15 lines, and the full report with `--verbose`.
  41. ## Safe by construction
  42. - **Local only.** One process over stdio, with no HTTP client in the code or its dependencies. The model
  43. download and the update check go through the system `curl` to pinned `https` URLs and are verified.
  44. - **Confined.** Every path stays inside a configured folder. `.env*`, keys and credential files are never read,
  45. whatever the configuration says.
  46. - **Nothing lost.** There is no delete or rename tool; writes are additive, atomic and audited, and the memory
  47. store is append-only.
  48. The threat model is on [Security model](https://github.com/bloodfeast/atlas/wiki/Security-model). Report
  49. vulnerabilities privately, as [SECURITY.md](SECURITY.md) describes.
  50. ## Documentation
  51. The wiki is the full manual.
  52. - **Getting started:** [Overview](https://github.com/bloodfeast/atlas/wiki/Overview) ·
  53. [Install and setup](https://github.com/bloodfeast/atlas/wiki/Install-and-setup) ·
  54. [Configuration reference](https://github.com/bloodfeast/atlas/wiki/Configuration-reference) ·
  55. [Reference configuration](https://github.com/bloodfeast/atlas/wiki/Reference-configuration) ·
  56. [Projects and multi-repo](https://github.com/bloodfeast/atlas/wiki/Projects-and-multi-repo)
  57. - **What it saves:** [Token savings and method](https://github.com/bloodfeast/atlas/wiki/Token-savings-and-method) ·
  58. [Handles and digests](https://github.com/bloodfeast/atlas/wiki/Handles-and-digests)
  59. - **Reference:** [Tools reference](https://github.com/bloodfeast/atlas/wiki/Tools-reference) ·
  60. [Code index](https://github.com/bloodfeast/atlas/wiki/Code-index) ·
  61. [Semantic search](https://github.com/bloodfeast/atlas/wiki/Semantic-search) ·
  62. [Identifiers and freshness](https://github.com/bloodfeast/atlas/wiki/Identifiers-and-freshness) ·
  63. [Memory store and hooks](https://github.com/bloodfeast/atlas/wiki/Memory-store-and-hooks) ·
  64. [Memory tree](https://github.com/bloodfeast/atlas/wiki/Memory-tree) ·
  65. [Memory and rule files](https://github.com/bloodfeast/atlas/wiki/Memory-and-rule-files) ·
  66. [Orchestration](https://github.com/bloodfeast/atlas/wiki/Orchestration) ·
  67. [Discussions](https://github.com/bloodfeast/atlas/wiki/Discussions) ·
  68. [Project tracking](https://github.com/bloodfeast/atlas/wiki/Project-tracking) ·
  69. [Generated indices](https://github.com/bloodfeast/atlas/wiki/Generated-indices) ·
  70. [Cross-vault links](https://github.com/bloodfeast/atlas/wiki/Cross-vault-links)
  71. - **Internals:** [Security model](https://github.com/bloodfeast/atlas/wiki/Security-model) ·
  72. [SQLite store](https://github.com/bloodfeast/atlas/wiki/SQLite-store) ·
  73. [Testing and coverage](https://github.com/bloodfeast/atlas/wiki/Testing-and-coverage) ·
  74. [Releasing](https://github.com/bloodfeast/atlas/wiki/Releasing) ·
  75. [Changelog](https://github.com/bloodfeast/atlas/wiki/Changelog)
  76. ## License
  77. Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.