Skip to content
Back to search

atomicmemory

MarketplaceWorks with Claude CodeGitHub

Portable semantic memory for AI agents: core engine, TypeScript SDK, framework adapters, MCP server, CLI, and host plugins.

Safety scan

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

Checked today

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/atomicstrata/atomicmemory 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/atomicstrata/atomicmemory'

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/atomicstrata--atomicmemory/badge.svg)](/listings/atomicstrata--atomicmemory)

HTML

<a href="/listings/atomicstrata--atomicmemory"><img src="/api/listings/atomicstrata--atomicmemory/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.

These steps run a script from the network that findsafeskills does not scan.

Install the `am` CLI and initialize Hosted Cloud in one guided command:

curl --proto '=https' --tlsv1.2 -fsSL https://get.atomicstrata.ai/install.sh | sh -s -- --init

Plain `am init` defaults to managed Cloud, selects your project, and saves its project-bound credential. Managed server keys use a per-installation name such as `am-cli-a1b2c3d4e5f6`, so another machine's credential is not rotated. No Docker or OpenAI key is required. Non-interactive Cloud automation uses `am init --yes --project <cloud-id>`; Local automation must opt in with `am init --local --yes`.

The installer runs initialization through the verified binary directly. If it updates PATH, open a new terminal before the next commands or use the shell-specific activation command it prints.

Store a preference and retrieve it:

am memory ingest "I prefer aisle seats when flying."
am memory search "seat preference"

Connect the active profile to an agent host when you are ready:

am integrate --yes --host cursor # or claude-code / codex / opencode

`am integrate` writes the host's user-level MCP configuration. It does not install a marketplace plugin.

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 · 21 lines

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

  1. {
  2. "name": "atomicmemory",
  3. "metadata": {
  4. "description": "AtomicMemory coding-agent plugins for persistent semantic memory."
  5. },
  6. "owner": {
  7. "name": "AtomicMemory",
  8. "url": "https://atomicmem.ai"
  9. },
  10. "plugins": [
  11. {
  12. "name": "claude-code",
  13. "source": "./plugins/claude-code",
  14. "description": "Persistent semantic memory for Claude Code - user preferences, project context, prior decisions, and codebase facts that survive across sessions.",
  15. "version": "0.2.3",
  16. "category": "productivity",
  17. "homepage": "https://docs.atomicstrata.ai/integrations/coding-agents/claude-code",
  18. "license": "Apache-2.0"
  19. }
  20. ]
  21. }
README.md · README · 379 lines · 1 finding marked

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

  1. # AtomicMemory
  2. [![CI](https://github.com/atomicstrata/atomicmemory/actions/workflows/ci.yml/badge.svg)](https://github.com/atomicstrata/atomicmemory/actions/workflows/ci.yml)
  3. [![Core npm](https://img.shields.io/npm/v/%40atomicmemory%2Fcore?label=core)](https://www.npmjs.com/package/@atomicmemory/core)
  4. [![SDK npm](https://img.shields.io/npm/v/%40atomicmemory%2Fsdk?label=sdk)](https://www.npmjs.com/package/@atomicmemory/sdk)
  5. [![Docker](https://img.shields.io/badge/docker-GHCR-2496ED?logo=docker&logoColor=white)](packages/core/Dockerfile)
  6. [![Docs](https://img.shields.io/badge/docs-docs.atomicstrata.ai-blue)](https://docs.atomicstrata.ai)
  7. [![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
  8. **Inspectable, correction-aware memory for agents and AI applications.**
  9. AtomicMemory gives agents durable context across sessions without coupling your
  10. application to one model, framework, or deployment. Start with managed Hosted
  11. Cloud, run the open-source Core locally, or integrate through the TypeScript SDK
  12. and MCP server.
  13. [Documentation](https://docs.atomicstrata.ai) ·
  14. [Hosted Cloud](https://memory.atomicstrata.ai) ·
  15. [Open-source quickstart](https://docs.atomicstrata.ai/open-source/quickstart) ·
  16. [Why inspectable memory matters](https://www.atomicstrata.ai/blog/the-ai-memory-industry-has-a-black-box-problem)
  17. ## Headline Results
  18. AtomicMemory v66 is leading performance/cost on BEAM-100K, BEAM-1M, and LoCoMo10 under
  19. matched methodology against published competitors. On BEAM-10M it matches the
  20. strongest published Mem0-new result while leaving Hindsight-scale temporal
  21. retrieval as the known open frontier.
  22. | Benchmark | AtomicMemory v66 | Position | Cost/Q | Sample |
  23. |---|---:|---|---:|---:|
  24. | **BEAM-100K lenient** | **0.7375** | Parity with Hindsight at 0.75 | $1.26 | n=80 |
  25. | **BEAM-1M lenient** | **0.6625** | Leading Performance/Cost; +0.022 vs Mem0 paper | $0.083 | n=80 |
  26. | **BEAM-10M lenient** | **0.4875** | Parity with Mem0-new at 0.486 | $0.081 | n=80 |
  27. | **LoCoMo10 GPT-4o-mini binary** | **0.8396** | Leading Performance/Cost; +0.171 vs Mem0 paper | $0.066 | n=1540 |
  28. These results put AtomicMemory at or near the published ceiling in each
  29. reported category while preserving the lower-cost operating profile that
  30. matters for real applications. Reproducibility artifacts and harness details
  31. will be published with the benchmark materials.
  32. ## Quickstart
  33. Install the `am` CLI and initialize Hosted Cloud in one guided command:
  34. ```bash
  35. curl --proto '=https' --tlsv1.2 -fsSL https://get.atomicstrata.ai/install.sh | sh -s -- --init
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 46 on GitHub
  36. ```
  37. Plain `am init` defaults to managed Cloud, selects your project, and saves its
  38. project-bound credential. Managed server keys use a per-installation name such
  39. as `am-cli-a1b2c3d4e5f6`, so another machine's credential is not rotated. No
  40. Docker or OpenAI key is required.
  41. Non-interactive Cloud automation uses `am init --yes --project <cloud-id>`;
  42. Local automation must opt in with `am init --local --yes`.
  43. The installer runs initialization through the verified binary directly. If it
  44. updates PATH, open a new terminal before the next commands or use the
  45. shell-specific activation command it prints.
  46. Store a preference and retrieve it:
  47. ```bash
  48. am memory ingest "I prefer aisle seats when flying."
  49. am memory search "seat preference"
  50. ```
  51. Connect the active profile to an agent host when you are ready:
  52. ```bash
  53. am integrate --yes --host cursor # or claude-code / codex / opencode
  54. ```
  55. `am integrate` writes the host's user-level MCP configuration. It does not
  56. install a marketplace plugin.
  57. ## Choose your path
  58. | Path | Best for | Start here |
  59. | --- | --- | --- |
  60. | **Hosted Cloud** | Managed memory with the fastest setup | Guided installer above, or `am init` |
  61. | **Connected Local** | Running open-source Core on your machine | `am init --local` |
  62. | **TypeScript SDK** | Server-side application integration against Core | `npm install @atomicmemory/sdk` |
  63. Agent integration through MCP works with either an active Cloud or Local
  64. profile. See the [documentation](https://docs.atomicstrata.ai) for framework and
  65. host-specific guides.
  66. ## Why AtomicMemory
  67. - **Correction-aware** — supersede, clarify, delete, or retain memories as facts
  68. change instead of treating memory as append-only recall.
  69. - **Portable** — use one memory protocol through the CLI, MCP server, SDK,
  70. framework adapters, and host plugins.
  71. - **Inspectable** — run the open-source Core and audit the mutation and retrieval
  72. path rather than depending only on a hosted black box.
  73. - **Model-flexible** — keep extraction, embeddings, mutation, reranking, and
  74. retrieval packaging behind explicit provider boundaries.
  75. - **Cloud or Local** — begin with managed Cloud or operate Core yourself without
  76. rewriting the integration surface.
  77. ## Use AtomicMemory
  78. ### Hosted Cloud
  79. Interactive `am init` offers **Hosted Cloud** as option 1/default and
  80. **Connected Local** as option 2. Hosted Cloud needs no Docker or OpenAI key:
  81. - With one project, the CLI selects it automatically. With multiple projects,
  82. it prompts for a selection.
  83. - With no project, it opens onboarding and waits for project creation in an
  84. interactive terminal. Non-interactive runs print the URL and recovery command
  85. instead of waiting.
  86. - Credentials are bound to the Cloud origin and project, stored with owner-only
  87. permissions, and never printed.
  88. - A working stored project credential is reused. Otherwise the CLI rotates only
  89. this installation's exact `am-cli-<12-hex>` key and creates it when absent.
  90. Legacy unsuffixed keys and other installations' keys are left untouched.
  91. `--project` accepts a unique ID or case-insensitive slug and infers Cloud versus
  92. Local from the resolved project type. Explicit selectors assert the type:
  93. ```bash
  94. am init --project <id-or-slug> # infer Cloud or Local
  95. am init --cloud --project <cloud-id> # require a Cloud project
  96. am init --local --project <local-id> # require a Local project
  97. ```
  98. Ambiguous slugs fail with a request for the unique project ID. At the API-key
  99. limit, initialization preserves the previous default profile and prints the
  100. dashboard URL plus exact commands to list or revoke a key and retry. It never
  101. rotates or revokes unrelated keys as quota recovery.
  102. ### Connected Local
  103. Connected Local runs Core on your machine and can link it to Cloud for trace
  104. visibility. It requires:
  105. - Docker Desktop or Docker Engine running
  106. - An [OpenAI API key](https://platform.openai.com/api-keys); interactive setup
  107. reads it with hidden input and stores it with owner-only permissions
  108. - macOS or glibc Linux on x86_64 or arm64
  109. Initialize and verify Local:
  110. ```bash
  111. am init --local
  112. am doctor --smoke
  113. ```
  114. The Local defaults remain profile `local` and Core URL
  115. `http://127.0.0.1:17350`. For headless automation, seed dashboard auth and the
  116. OpenAI key before selecting Local explicitly:
  117. ```bash
  118. am auth login --token "$AM_DASHBOARD_JWT"
  119. export OPENAI_API_KEY=sk-... # inject through your secret manager
  120. am init --local --yes
  121. ```
  122. For Core-only Docker without a Cloud account, use the
  123. [Core package guide](packages/core/README.md#docker-image-recommended). The
  124. [open-source quickstart](https://docs.atomicstrata.ai/open-source/quickstart)
  125. covers lifecycle, custom URLs, and troubleshooting; the
  126. [CLI README](crates/cli/README.md) documents every initialization flag.
  127. ### Agent hosts and MCP
  128. Both initialization paths leave an active profile that the published MCP server
  129. can use. Configure a supported host with:
  130. ```bash
  131. am integrate --yes --host cursor # or claude-code / codex / opencode
  132. ```
  133. Codex and Cursor marketplace plugin packages remain **coming soon** in the
  134. matrix below; direct MCP configuration through `am integrate` is a separate
  135. supported path. Use `am integrate doctor` to diagnose host configuration.
  136. ### TypeScript SDK
  137. The SDK is server-side only in v1. Start Core first, then reveal the Local client
  138. environment only in a trusted terminal:
  139. ```bash
  140. am connect env --for clients --show-secrets
  141. npm install @atomicmemory/sdk
  142. ```
  143. Copy `ATOMICMEMORY_CORE_URL` and `CORE_API_KEY` into the trusted server process;
  144. never expose `CORE_API_KEY` in a browser bundle. Then use the memory client:
  145. ```ts
  146. import { MemoryClient } from '@atomicmemory/sdk';
  147. const memory = new MemoryClient({
  148. providers: {
  149. atomicmemory: {
  150. apiUrl: process.env.ATOMICMEMORY_CORE_URL!,
  151. apiKey: process.env.CORE_API_KEY!,
  152. },
  153. },
  154. });
  155. await memory.initialize();
  156. await memory.ingest({
  157. mode: 'messages',
  158. messages: [{ role: 'user', content: 'I prefer aisle seats.' }],
  159. scope: { user: 'demo-user' },
  160. });
  161. const results = await memory.search({
  162. query: 'seat preference',
  163. scope: { user: 'demo-user' },
  164. });
  165. ```
  166. Use `AtomicMemoryClient` when the application also needs the storage namespace.
  167. See the [SDK quickstart](https://docs.atomicstrata.ai/sdk/quickstart) and
  168. [`packages/sdk/README.md`](packages/sdk/README.md) for the full API.
  169. ### Installer verification
  170. Every CLI download is checked against `SHA256SUMS`. If an authenticated GitHub
  171. CLI is available, the installer also verifies build provenance. Without GitHub
  172. authentication it warns, skips optional attestation, and continues only after
  173. checksum verification. To require attestation:
  174. ```bash
  175. curl --proto '=https' --tlsv1.2 -fsSL https://get.atomicstrata.ai/install.sh | AM_VERIFY_ATTESTATION=1 sh -s -- --init
  176. ```
  177. Required verification fails before installation unless `gh auth login` or
  178. `GH_TOKEN` supplies working GitHub authentication.
  179. ## Package matrix
  180. Status labels are part of the public docs contract:
  181. - **published** — available on the npm registry and supported.
  182. - **implemented, publish pending** — code lives in this repo and works locally,
  183. but the monorepo-era package has not been released.
  184. - **coming soon** — source is present, but the public host install path is not
  185. supported yet.
  186. - **deprecated** — still published and supported for the workflows named in
  187. its row, but superseded.
  188. ### Packages
  189. | Package | Path | Status |
  190. | --- | --- | --- |
  191. | `@atomicmemory/core` | `packages/core` | published |
  192. | `@atomicmemory/sdk` | `packages/sdk` | published |
  193. | `@atomicmemory/cli` | `packages/cli` | deprecated (published; use `am`, still required for llmwiki import) |
  194. | `@atomicmemory/mcp-server` | `packages/mcp-server` | published |
  195. | `@atomicmemory/llmwiki` | `packages/llmwiki` | implemented, publish pending |
  196. ### Framework adapters
  197. | Package | Path | Status |
  198. | --- | --- | --- |
  199. | `@atomicmemory/vercel-ai` | `adapters/vercel-ai` | published |
  200. | `@atomicmemory/openai-agents` | `adapters/openai-agents` | published |
  201. | `@atomicmemory/langchain` | `adapters/langchain` | published |
  202. | `@atomicmemory/langgraph` | `adapters/langgraph` | published |
  203. | `@atomicmemory/mastra` | `adapters/mastra` | published |
  204. ### Host plugins
  205. | Package | Path | Status |
  206. | --- | --- | --- |
  207. | `@atomicmemory/claude-code-plugin` | `plugins/claude-code` | published |
  208. | `@atomicmemory/openclaw-plugin` | `plugins/openclaw` | published |
  209. | `@atomicmemory/hermes-plugin` | `plugins/hermes` | published |
  210. | `@atomicmemory/codex-plugin` | `plugins/codex` | coming soon |
  211. | `@atomicmemory/cursor-plugin` | `plugins/cursor` | coming soon |
  212. Codex and Cursor plugin source is present, but the public host install path is
  213. coming soon until each host marketplace manifest format is validated end to end.
  214. ### Other surfaces
  215. | Surface | Location | Status |
  216. | --- | --- | --- |
  217. | CLI (`am`) | `crates/cli` | published; canonical artifacts on GitHub Releases (`get.atomicstrata.ai` mirrors them) |
  218. | Python SDK (`atomicmemory` on PyPI) | separate repository | published; not part of this monorepo |
  219. ## Repository and trust boundaries
  220. This repository is the public source of truth for AtomicMemory's JavaScript and
  221. TypeScript packages, Rust CLI, framework adapters, host plugins, and public smoke
  222. contracts. It contains:
  223. - **Core** — Docker-deployable memory backend with mutation, retrieval, and
  224. Postgres/pgvector storage.
  225. - **SDK** — typed provider boundary, memory and storage clients, embeddings, and
  226. search primitives.
  227. - **CLI and MCP server** — setup, diagnostics, capture, retrieval, and agent
  228. integration surfaces.
  229. - **Adapters and plugins** — thin integrations for supported frameworks and
  230. agent hosts.
  231. Hosted service infrastructure, release orchestration, marketplace operations,
  232. the Python SDK, and unpublished benchmark harnesses live outside this monorepo.
  233. Package-specific setup remains in each package README.
  234. ### Performance posture
  235. The Headline Results above are benchmark scores under matched methodology.
  236. Latency, recall@k, and scale-envelope claims should only be quoted with the
  237. benchmark, hardware, dataset, and measurement date. Until linked latency
  238. benchmarks are available, single-digit-millisecond local retrieval remains a
  239. design target rather than a guarantee.
  240. ### Public validation
  241. Pull requests verify repository hygiene, package metadata, affected build and
  242. type checks, lint, self-contained tests, package tarball shape, documentation
  243. contracts, public integration smoke, and security compliance. Package and
  244. release contexts additionally cover Core OpenAPI drift, schema tests, Docker
  245. image smoke, and DB-backed Core tests when their required services are present.
  246. ## Local development
  247. The monorepo uses pnpm workspaces and Turborepo. Check `package.json` for the
  248. complete command surface.
  249. ```bash
  250. pnpm install
  251. pnpm run build
  252. pnpm run typecheck
  253. pnpm run test
  254. pnpm run lint
  255. ```
  256. Core DB-backed tests require Postgres/pgvector provisioning. Rust CLI changes
  257. use the pinned toolchain and the repository's CI-equivalent command:
  258. ```bash
  259. pnpm run ci:rust
  260. ```
  261. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the full workflow, required checks,
  262. and package-level commands. The canonical CLI source and contributor setup are
  263. documented in [`crates/cli/README.md`](crates/cli/README.md).
  264. ## Companion: llmwiki
  265. [llmwiki](https://github.com/atomicstrata/llmwiki) compiles raw sources into an
  266. interlinked Markdown knowledge base. The `@atomicmemory/llmwiki` bridge imports
  267. its JSON export into AtomicMemory while preserving advisory metadata under
  268. `memory.metadata.llmwiki.*`.
  269. See [`packages/llmwiki/README.md`](packages/llmwiki/README.md) and
  270. [`packages/llmwiki/docs/cookbook.md`](packages/llmwiki/docs/cookbook.md) for the
  271. full workflow.
  272. ## Project information
  273. - **Release notes:** package changelogs and [`CHANGELOG.md`](CHANGELOG.md)
  274. - **Roadmap:** [`ROADMAP.md`](ROADMAP.md)
  275. - **Contributing:** [`CONTRIBUTING.md`](CONTRIBUTING.md)
  276. - **Security:** confidential reporting and supported versions in
  277. [`SECURITY.md`](SECURITY.md)
  278. - **License:** Apache License 2.0 — see [`LICENSE`](LICENSE)
  279. ## Repository layout
  280. ```text
  281. packages/ core, sdk, cli, mcp-server
  282. crates/ CLI (am) and Cloud/Core wire types
  283. adapters/ framework integrations (Vercel AI, OpenAI Agents, LangChain,
  284. LangGraph, Mastra)
  285. plugins/ host integrations (Claude Code, OpenClaw, Hermes, Codex, Cursor)
  286. examples/ reserved for phase 2+; only added with owners and CI coverage
  287. tests/smoke/ public, contributor-safe smoke tests
  288. ```
  289. Release orchestration, marketplace operations, sensitive service configuration,
  290. and local machine paths are deliberately not part of this repository.

Ratings and comments

Sign in to rate this skill.

Sign in

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