-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcli.html
More file actions
181 lines (181 loc) · 109 KB
/
Copy pathcli.html
File metadata and controls
181 lines (181 loc) · 109 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
<!doctype html><html lang=en dir=ltr class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-cli" data-has-hydrated=false><head><meta charset=UTF-8><meta name=generator content="Docusaurus v3.10.2"><title data-rh=true>AtomicMemory CLI | Atomic Strata</title><meta data-rh=true name=viewport content="width=device-width, initial-scale=1.0"/><meta data-rh=true name=twitter:card content=summary_large_image /><meta data-rh=true property=og:image content=https://docs.atomicstrata.ai/img/logo-full.svg /><meta data-rh=true name=twitter:image content=https://docs.atomicstrata.ai/img/logo-full.svg /><meta data-rh=true property=og:url content=https://docs.atomicstrata.ai/cli /><meta data-rh=true property=og:locale content=en /><meta data-rh=true name=docusaurus_locale content=en /><meta data-rh=true name=docsearch:language content=en /><meta data-rh=true name=docusaurus_version content=current /><meta data-rh=true name=docusaurus_tag content=docs-default-current /><meta data-rh=true name=docsearch:version content=current /><meta data-rh=true name=docsearch:docusaurus_tag content=docs-default-current /><meta data-rh=true property=og:title content="AtomicMemory CLI | Atomic Strata"/><meta data-rh=true name=description content="@atomicmemory/cli is the Node.js command line for direct self-hosted core"/><meta data-rh=true property=og:description content="@atomicmemory/cli is the Node.js command line for direct self-hosted core"/><link data-rh=true rel=icon href=/img/favicon.svg /><link data-rh=true rel=canonical href=https://docs.atomicstrata.ai/cli /><link data-rh=true rel=alternate href=https://docs.atomicstrata.ai/cli hreflang=en /><link data-rh=true rel=alternate href=https://docs.atomicstrata.ai/cli hreflang=x-default /><script data-rh=true type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://docs.atomicstrata.ai/cli","name":"AtomicMemory CLI","position":1}]}</script><link rel=preconnect href=https://fonts.googleapis.com><link rel=preconnect href=https://fonts.gstatic.com crossorigin=anonymous><link rel=stylesheet href="https://fonts.googleapis.com/css2?family=DM+Mono:wght@400;500&family=DM+Sans:opsz,wght@9..40,400;9..40,500;9..40,600;9..40,700&display=swap"><link rel=stylesheet href=/assets/css/styles.8660d1fc.css /><script src=/assets/js/runtime~main.49ddd35c.js defer></script><script src=/assets/js/main.aaf5a7d8.js defer></script></head><body><svg style="display: none;"><defs>
<symbol id=theme-svg-external-link viewBox="0 0 24 24"><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
</defs></svg>
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme-130")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{for(var[t,e]of new URLSearchParams(window.location.search).entries())if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id=__docusaurus><link rel=preload as=image href=/img/logo-mark.svg /><div role=region aria-label="Skip to main content"><a class=skipToContent_fXgn href=#__docusaurus_skipToContent_fallback>Skip to main content</a></div><nav aria-label=Main class="theme-layout-navbar navbar navbar--fixed-top"><div class=navbar__inner><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded=false class="navbar__toggle clean-btn" type=button><svg width=30 height=30 viewBox="0 0 30 30" aria-hidden=true><path stroke=currentColor stroke-linecap=round stroke-miterlimit=10 stroke-width=2 d="M4 7h22M4 15h22M4 23h22"/></svg></button><a class=navbar__brand href=/><div class=navbar__logo><img src=/img/logo-mark.svg alt="Atomic Strata" class="themedComponent_mlkZ themedComponent--light_NVdE"/><img src=/img/logo-mark.svg alt="Atomic Strata" class="themedComponent_mlkZ themedComponent--dark_xIcU"/></div><b class="navbar__title text--truncate">Atomic Strata</b></a><a class="navbar__item navbar__link" href=/cloud/overview>AtomicMemory</a><a aria-current=page class="navbar__item navbar__link navbar__link--active" href=/introduction>Open Source</a><a class="navbar__item navbar__link" href=/sdk/overview>SDK</a><a class="navbar__item navbar__link" href=/integrations/overview>Integrations</a><a class="navbar__item navbar__link" href=/api-reference/http/conventions>API Reference</a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href=https://github.com/atomicstrata/atomicmemory target=_blank rel="noopener noreferrer" class="navbar__item navbar__link">GitHub<svg width=13 height=13 viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg aria-label="(opens in new tab)" style=margin-inline-start:0.3rem;vertical-align:text-bottom><path d="M3 2C2.44772 2 2 2.44772 2 3V12C2 12.5523 2.44772 13 3 13H12C12.5523 13 13 12.5523 13 12V8.5C13 8.22386 12.7761 8 12.5 8C12.2239 8 12 8.22386 12 8.5V12H3V3L6.5 3C6.77614 3 7 2.77614 7 2.5C7 2.22386 6.77614 2 6.5 2H3ZM12.8536 2.14645C12.9015 2.19439 12.9377 2.24964 12.9621 2.30861C12.9861 2.36669 12.9996 2.4303 13 2.497L13 2.5V2.50049V5.5C13 5.77614 12.7761 6 12.5 6C12.2239 6 12 5.77614 12 5.5V3.70711L6.85355 8.85355C6.65829 9.04882 6.34171 9.04882 6.14645 8.85355C5.95118 8.65829 5.95118 8.34171 6.14645 8.14645L11.2929 3H9.5C9.22386 3 9 2.77614 9 2.5C9 2.22386 9.22386 2 9.5 2H12.4999H12.5C12.5678 2 12.6324 2.01349 12.6914 2.03794C12.7504 2.06234 12.8056 2.09851 12.8536 2.14645Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type=button disabled title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg width=15 height=15 viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg aria-hidden=true class="toggleIcon_g3eP lightToggleIcon_pyhR"><path d="M7.5 0C7.77614 0 8 0.223858 8 0.5V2.5C8 2.77614 7.77614 3 7.5 3C7.22386 3 7 2.77614 7 2.5V0.5C7 0.223858 7.22386 0 7.5 0ZM2.1967 2.1967C2.39196 2.00144 2.70854 2.00144 2.90381 2.1967L4.31802 3.61091C4.51328 3.80617 4.51328 4.12276 4.31802 4.31802C4.12276 4.51328 3.80617 4.51328 3.61091 4.31802L2.1967 2.90381C2.00144 2.70854 2.00144 2.39196 2.1967 2.1967ZM0.5 7C0.223858 7 0 7.22386 0 7.5C0 7.77614 0.223858 8 0.5 8H2.5C2.77614 8 3 7.77614 3 7.5C3 7.22386 2.77614 7 2.5 7H0.5ZM2.1967 12.8033C2.00144 12.608 2.00144 12.2915 2.1967 12.0962L3.61091 10.682C3.80617 10.4867 4.12276 10.4867 4.31802 10.682C4.51328 10.8772 4.51328 11.1938 4.31802 11.3891L2.90381 12.8033C2.70854 12.9986 2.39196 12.9986 2.1967 12.8033ZM12.5 7C12.2239 7 12 7.22386 12 7.5C12 7.77614 12.2239 8 12.5 8H14.5C14.7761 8 15 7.77614 15 7.5C15 7.22386 14.7761 7 14.5 7H12.5ZM10.682 4.31802C10.4867 4.12276 10.4867 3.80617 10.682 3.61091L12.0962 2.1967C12.2915 2.00144 12.608 2.00144 12.8033 2.1967C12.9986 2.39196 12.9986 2.70854 12.8033 2.90381L11.3891 4.31802C11.1938 4.51328 10.8772 4.51328 10.682 4.31802ZM8 12.5C8 12.2239 7.77614 12 7.5 12C7.22386 12 7 12.2239 7 12.5V14.5C7 14.7761 7.22386 15 7.5 15C7.77614 15 8 14.7761 8 14.5V12.5ZM10.682 10.682C10.8772 10.4867 11.1938 10.4867 11.3891 10.682L12.8033 12.0962C12.9986 12.2915 12.9986 12.608 12.8033 12.8033C12.608 12.9986 12.2915 12.9986 12.0962 12.8033L10.682 11.3891C10.4867 11.1938 10.4867 10.8772 10.682 10.682ZM5.5 7.5C5.5 6.39543 6.39543 5.5 7.5 5.5C8.60457 5.5 9.5 6.39543 9.5 7.5C9.5 8.60457 8.60457 9.5 7.5 9.5C6.39543 9.5 5.5 8.60457 5.5 7.5ZM7.5 4.5C5.84315 4.5 4.5 5.84315 4.5 7.5C4.5 9.15685 5.84315 10.5 7.5 10.5C9.15685 10.5 10.5 9.15685 10.5 7.5C10.5 5.84315 9.15685 4.5 7.5 4.5Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg><svg width=15 height=15 viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg aria-hidden=true class="toggleIcon_g3eP darkToggleIcon_wfgR"><path d="M2.89998 0.499976C2.89998 0.279062 2.72089 0.0999756 2.49998 0.0999756C2.27906 0.0999756 2.09998 0.279062 2.09998 0.499976V1.09998H1.49998C1.27906 1.09998 1.09998 1.27906 1.09998 1.49998C1.09998 1.72089 1.27906 1.89998 1.49998 1.89998H2.09998V2.49998C2.09998 2.72089 2.27906 2.89998 2.49998 2.89998C2.72089 2.89998 2.89998 2.72089 2.89998 2.49998V1.89998H3.49998C3.72089 1.89998 3.89998 1.72089 3.89998 1.49998C3.89998 1.27906 3.72089 1.09998 3.49998 1.09998H2.89998V0.499976ZM5.89998 3.49998C5.89998 3.27906 5.72089 3.09998 5.49998 3.09998C5.27906 3.09998 5.09998 3.27906 5.09998 3.49998V4.09998H4.49998C4.27906 4.09998 4.09998 4.27906 4.09998 4.49998C4.09998 4.72089 4.27906 4.89998 4.49998 4.89998H5.09998V5.49998C5.09998 5.72089 5.27906 5.89998 5.49998 5.89998C5.72089 5.89998 5.89998 5.72089 5.89998 5.49998V4.89998H6.49998C6.72089 4.89998 6.89998 4.72089 6.89998 4.49998C6.89998 4.27906 6.72089 4.09998 6.49998 4.09998H5.89998V3.49998ZM1.89998 6.49998C1.89998 6.27906 1.72089 6.09998 1.49998 6.09998C1.27906 6.09998 1.09998 6.27906 1.09998 6.49998V7.09998H0.499976C0.279062 7.09998 0.0999756 7.27906 0.0999756 7.49998C0.0999756 7.72089 0.279062 7.89998 0.499976 7.89998H1.09998V8.49998C1.09998 8.72089 1.27906 8.89997 1.49998 8.89997C1.72089 8.89997 1.89998 8.72089 1.89998 8.49998V7.89998H2.49998C2.72089 7.89998 2.89998 7.72089 2.89998 7.49998C2.89998 7.27906 2.72089 7.09998 2.49998 7.09998H1.89998V6.49998ZM8.54406 0.98184L8.24618 0.941586C8.03275 0.917676 7.90692 1.1655 8.02936 1.34194C8.17013 1.54479 8.29981 1.75592 8.41754 1.97445C8.91878 2.90485 9.20322 3.96932 9.20322 5.10022C9.20322 8.37201 6.82247 11.0878 3.69887 11.6097C3.45736 11.65 3.20988 11.6772 2.96008 11.6906C2.74563 11.702 2.62729 11.9535 2.77721 12.1072C2.84551 12.1773 2.91535 12.2458 2.98667 12.3128L3.05883 12.3795L3.31883 12.6045L3.50684 12.7532L3.62796 12.8433L3.81491 12.9742L3.99079 13.089C4.11175 13.1651 4.23536 13.2375 4.36157 13.3059L4.62496 13.4412L4.88553 13.5607L5.18837 13.6828L5.43169 13.7686C5.56564 13.8128 5.70149 13.8529 5.83857 13.8885C5.94262 13.9155 6.04767 13.9401 6.15405 13.9622C6.27993 13.9883 6.40713 14.0109 6.53544 14.0298L6.85241 14.0685L7.11934 14.0892C7.24637 14.0965 7.37436 14.1002 7.50322 14.1002C11.1483 14.1002 14.1032 11.1453 14.1032 7.50023C14.1032 7.25044 14.0893 7.00389 14.0623 6.76131L14.0255 6.48407C13.991 6.26083 13.9453 6.04129 13.8891 5.82642C13.8213 5.56709 13.7382 5.31398 13.6409 5.06881L13.5279 4.80132L13.4507 4.63542L13.3766 4.48666C13.2178 4.17773 13.0353 3.88295 12.8312 3.60423L12.6782 3.40352L12.4793 3.16432L12.3157 2.98361L12.1961 2.85951L12.0355 2.70246L11.8134 2.50184L11.4925 2.24191L11.2483 2.06498L10.9562 1.87446L10.6346 1.68894L10.3073 1.52378L10.1938 1.47176L9.95488 1.3706L9.67791 1.2669L9.42566 1.1846L9.10075 1.09489L8.83599 1.03486L8.54406 0.98184ZM10.4032 5.30023C10.4032 4.27588 10.2002 3.29829 9.83244 2.40604C11.7623 3.28995 13.1032 5.23862 13.1032 7.50023C13.1032 10.593 10.596 13.1002 7.50322 13.1002C6.63646 13.1002 5.81597 12.9036 5.08355 12.5522C6.5419 12.0941 7.81081 11.2082 8.74322 10.0416C8.87963 10.2284 9.10028 10.3497 9.34928 10.3497C9.76349 10.3497 10.0993 10.0139 10.0993 9.59971C10.0993 9.24256 9.84965 8.94373 9.51535 8.86816C9.57741 8.75165 9.63653 8.63334 9.6926 8.51332C9.88358 8.63163 10.1088 8.69993 10.35 8.69993C11.0403 8.69993 11.6 8.14028 11.6 7.44993C11.6 6.75976 11.0406 6.20024 10.3505 6.19993C10.3853 5.90487 10.4032 5.60464 10.4032 5.30023Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg><svg width=15 height=15 viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg aria-hidden=true class="toggleIcon_g3eP systemToggleIcon_QzmC"><path d="M1 3.25C1 3.11193 1.11193 3 1.25 3H13.75C13.8881 3 14 3.11193 14 3.25V10.75C14 10.8881 13.8881 11 13.75 11H1.25C1.11193 11 1 10.8881 1 10.75V3.25ZM1.25 2C0.559643 2 0 2.55964 0 3.25V10.75C0 11.4404 0.559644 12 1.25 12H5.07341L4.82991 13.2986C4.76645 13.6371 5.02612 13.95 5.37049 13.95H9.62951C9.97389 13.95 10.2336 13.6371 10.1701 13.2986L9.92659 12H13.75C14.4404 12 15 11.4404 15 10.75V3.25C15 2.55964 14.4404 2 13.75 2H1.25ZM9.01091 12H5.98909L5.79222 13.05H9.20778L9.01091 12Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></button></div><div class=navbarSearchContainer_Bca1><div class="navbar__search searchBarContainer_NW3z" dir=ltr><input placeholder="Search documentation" aria-label=Search class="navbar__search-input searchInput_YFbd" value="" /><div class="loadingRing_RJI3 searchBarLoadingRing_YnHq"><div></div><div></div><div></div><div></div></div></div></div></div></div><div role=presentation class=navbar-sidebar__backdrop></div></nav><div id=__docusaurus_skipToContent_fallback class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class=docsWrapper_hBAB><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type=button></button><div class=docRoot_UBD9><aside class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class=sidebarViewport_aRkj><div class=sidebar_njMd><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class=menu__link href=/introduction><span class=linkLabel_WmDU>Introduction</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class=menu__link href=/quickstart><span class=linkLabel_WmDU>Quickstart</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class=menu__link href=/cloud-vs-open-source><span class=linkLabel_WmDU>Local vs Hosted Cloud</span></a><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class=menu__list-item-collapsible><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=true href=/platform/architecture><span class=categoryLinkLabel_W154>Platform</span></a></div><ul class=menu__list><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/architecture><span class=linkLabel_WmDU>Architecture</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/composition><span class=linkLabel_WmDU>Composition</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/consuming-core><span class=linkLabel_WmDU>Consuming core</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/stores><span class=linkLabel_WmDU>Stores</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/providers><span class=linkLabel_WmDU>Providers</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/artifact-storage><span class=linkLabel_WmDU>Artifact Storage</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/scope><span class=linkLabel_WmDU>Scope</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/observability><span class=linkLabel_WmDU>Observability</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/platform/lessons><span class=linkLabel_WmDU>Lessons</span></a></ul><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class=menu__list-item-collapsible><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role=button aria-expanded=true href=/cli><span class=categoryLinkLabel_W154>Advanced</span></a></div><ul class=menu__list><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current=page tabindex=0 href=/cli><span class=linkLabel_WmDU>AtomicMemory CLI</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/core-only-docker><span class=linkLabel_WmDU>Core-only Docker</span></a></ul></ul></nav></div></div></aside><main class=docMainContainer_TBSr><div class="container padding-top--md padding-bottom--lg"><div class=row><div class="col docItemCol_xLCN"><div class=docItemContainer_jfFK><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label=Breadcrumbs><ul class=breadcrumbs><li class=breadcrumbs__item><a aria-label="Home page" class=breadcrumbs__link href=/><svg viewBox="0 0 24 24" class=breadcrumbHomeIcon_YNFT><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill=currentColor /></svg></a><li class=breadcrumbs__item><span class=breadcrumbs__link>Advanced</span><li class="breadcrumbs__item breadcrumbs__item--active"><span class=breadcrumbs__link>AtomicMemory CLI</span></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type=button class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><div class=row><div class="col col--12 markdown"><header><h1 class="anchor anchorTarget_QU3I" id=atomicmemory-cli-npm><a href=#atomicmemory-cli-npm class=headingLink_no4V aria-label="Copy link to AtomicMemory CLI (npm)" title="Copy link to AtomicMemory CLI (npm)"><span class=headingText_IKAy>AtomicMemory CLI (npm)</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h1></header>
<blockquote data-llms-directive=true>
<p>Agent index: <a href=/llms.txt target=_blank rel="noopener noreferrer" class="">llms.txt</a></p>
</blockquote>
<p><code>@atomicmemory/cli</code> is the Node.js command line for direct self-hosted core
workflows. It is separate from the AtomicMemory CLI (<code>am</code> from
<a href=https://get.atomicstrata.ai target=_blank rel="noopener noreferrer" class="">get.atomicstrata.ai</a>) — use
<a class="" href=/cloud/cli>AtomicMemory CLI</a> and the <a class="" href=/quickstart>Quickstart</a> for Connected Local
activation.</p>
<p><code>atomicmemory</code> is also separate from the MCP server: <code>atomicmemory-mcp</code> is a
stdio process for agent hosts, while this package is a terminal tool for setup,
diagnostics, memory operations, and stable script output.</p>
<p>The CLI uses the same backend-agnostic SDK provider model as the rest of
AtomicMemory. The current CLI surface supports <code>atomicmemory</code> and <code>mem0</code>.
Additional SDK providers require a CLI adapter, spec, and config-schema update
before they are selectable from command scripts.</p>
<p>The npm CLI does <strong>not</strong> start a memory backend by itself. Direct memory
commands need a configured AtomicMemory service — usually Core from
<a class="" href=/core-only-docker>Core-only Docker</a> or your own deployment. For Claude Code
personal use, prefer the
<a class="" href=/integrations/coding-agents/claude-code/local>Claude Code plugin</a>: it installs
the MCP server, skill, hooks, and auto-managed local runtime for you.</p>
<h2 class="anchor anchorTarget_QU3I" id=what-you-get><a href=#what-you-get class=headingLink_no4V aria-label="Copy link to What you get" title="Copy link to What you get"><span class=headingText_IKAy>What you get</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<ul>
<li class=""><strong>Interactive terminal dashboard.</strong> Running <code>atomicmemory</code> in a real terminal
opens an Ink UI with a bottom prompt, scrollable session output, slash menu,
and styled diagnostics.</li>
<li class=""><strong>Plain command surface.</strong> Use <code>--no-interactive</code>, non-TTY output, or machine
output modes when you want static text or JSON. Use <code>--interactive</code> as a TTY
rendering hint when text output should open the Ink dashboard.</li>
<li class=""><strong>Setup and diagnostics.</strong> <code>init</code>, <code>doctor</code>, <code>status</code>, <code>validate</code>, <code>config</code>,
<code>hooks</code>, <code>completion</code>, <code>help</code>, and <code>version</code> help operators install, inspect,
and repair local configuration.</li>
<li class=""><strong>Memory workflows.</strong> <code>add</code>, <code>ingest</code>, <code>search</code>, <code>package</code>, <code>list</code>, <code>get</code>,
<code>delete</code>, and <code>import</code> expose the same durable memory primitives used by the
SDK and integrations.</li>
<li class=""><strong>Agent-safe output.</strong> <code>--agent</code> emits stable JSON envelopes for automation.</li>
</ul>
<h2 class="anchor anchorTarget_QU3I" id=install><a href=#install class=headingLink_no4V aria-label="Copy link to Install" title="Copy link to Install"><span class=headingText_IKAy>Install</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<p>Requires Node.js 20 or newer.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token function" style="color:rgb(220, 220, 170)">npm</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-g</span><span class="token plain"> @atomicmemory/cli</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory</span><br/></div></code></pre></div></div>
<p>Running <code>atomicmemory</code> opens the local dashboard. Memory operations will ask for
a profile or provider flags until you connect the CLI to an AtomicMemory
backend.</p>
<p>To try the published CLI without a global install, use:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">npx </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-y</span><span class="token plain"> @atomicmemory/cli</span><br/></div></code></pre></div></div>
<h2 class="anchor anchorTarget_QU3I" id=choose-a-setup-path><a href=#choose-a-setup-path class=headingLink_no4V aria-label="Copy link to Choose a setup path" title="Copy link to Choose a setup path"><span class=headingText_IKAy>Choose a setup path</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<table><thead><tr><th>Path<th>Use when<th>Start here<tbody><tr><td>Claude Code plugin<td>You want personal Claude Code memory with local runtime management and no separate API key for extraction.<td><a class="" href=/integrations/coding-agents/claude-code/local>Claude Code Local</a><tr><td>Connected Local (recommended)<td>You want Core on your machine with console visibility.<td><a class="" href=/quickstart>Quickstart</a> via <a class="" href=/cloud/cli>AtomicMemory CLI</a> (<code>am init</code>).<tr><td>Direct CLI against local core<td>You run <code>atomicmemory-core</code> yourself and want npm terminal commands.<td><a class="" href=/core-only-docker>Core-only Docker</a>, then configure a <code>local</code> profile below.<tr><td>Direct CLI against a self-hosted service<td>Your team operates AtomicMemory behind its own URL and token.<td>Configure a <code>self-hosted</code> profile below.<tr><td>Hosted Cloud<td>You want managed memory hosting.<td><a class="" href=/cloud/cli>AtomicMemory CLI</a> and <a class="" href=/cloud/quickstart>Add Hosted Cloud</a>.<tr><td>Mem0 adapter<td>You want the CLI shape against a Mem0 backend.<td>Use <code>--provider mem0</code>; AtomicMemory-only commands are capability-gated.</table>
<h2 class="anchor anchorTarget_QU3I" id=configure><a href=#configure class=headingLink_no4V aria-label="Copy link to Configure" title="Copy link to Configure"><span class=headingText_IKAy>Configure</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<p>Create a named local profile for a Core-only Docker deployment:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token builtin class-name" style="color:rgb(78, 201, 176)">printf</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">'%s\n'</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">'local-dev-key'</span><span class="token plain"> </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory init </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--profile</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">local</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--provider</span><span class="token plain"> atomicmemory </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --api-url http://127.0.0.1:17350 </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --trust-surface </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">local</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--user</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token string environment constant" style="color:rgb(100, 102, 149)">$USER</span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--namespace</span><span class="token plain"> my-project </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --api-key-stdin </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --save-api-key</span><br/></div></code></pre></div></div>
<p><code>--trust-surface</code> is required when the CLI is asked to trust a provider URL
without an existing saved profile. It is not a secret; it describes the
operator boundary around the URL.</p>
<table><thead><tr><th>Value<th>Use when<tbody><tr><td><code>local</code><td>The URL points at a local development service, for example <code>localhost</code>.<tr><td><code>self-hosted</code><td>Your team operates the service and owns the network boundary.<tr><td><code>authenticated-wrapper</code><td>A hosted or shared endpoint is protected by an authenticated wrapper.</table>
<p>For environment-only configuration:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_PROVIDER</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"atomicmemory"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_API_URL</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"http://127.0.0.1:17350"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_API_KEY</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"local-dev-key"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_TRUST_SURFACE</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"local"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_SCOPE_USER</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token string environment constant" style="color:rgb(100, 102, 149)">$USER</span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_SCOPE_NAMESPACE</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"my-project"</span><br/></div></code></pre></div></div>
<p>Configuration precedence is:</p>
<ol>
<li class="">CLI flags</li>
<li class=""><code>ATOMICMEMORY_*</code> environment variables</li>
<li class=""><code>~/.atomicmemory/config.json</code></li>
<li class="">command defaults</li>
</ol>
<p><code>atomicmemory config show</code> redacts saved API keys.</p>
<p>API keys should be passed through stdin or environment variables:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token builtin class-name" style="color:rgb(78, 201, 176)">printf</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">'%s\n'</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token string variable" style="color:rgb(156, 220, 254)">$ATOMICMEMORY_API_KEY</span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token plain"> </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> atomicmemory init </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--profile</span><span class="token plain"> cloud --api-key-stdin --save-api-key</span><br/></div></code></pre></div></div>
<p>Plain <code>--api-key <value></code> is rejected at parse time so secrets do not land in
shell history. <code>--api-key-stdin</code> provides an ephemeral key for most commands;
for <code>init</code>, pair it with <code>--save-api-key</code> when the key should be persisted to
the named profile.</p>
<p>Memory commands require an explicit scope user from flags, environment, or
config. The CLI does not invent a user for provider-backed operations.</p>
<p>After <code>init</code>, verify the active profile:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory status</span><br/></div></code></pre></div></div>
<p>If you skip <code>init</code>, <code>status</code> and memory commands need equivalent flags or
environment variables. A user by itself is not enough; provider-backed commands
also need a provider URL and trust surface.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory status </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--provider</span><span class="token plain"> atomicmemory </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --api-url http://127.0.0.1:17350 </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --trust-surface </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">local</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--user</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token string environment constant" style="color:rgb(100, 102, 149)">$USER</span><span class="token string" style="color:rgb(206, 145, 120)">"</span><br/></div></code></pre></div></div>
<p>If you are using the Claude Code plugin in local auto-managed mode, you usually
do <strong>not</strong> need to run <code>atomicmemory init</code>; the plugin owns the local runtime
configuration. Use this page when you want direct terminal access, manual hook
snippets, or a profile that points at an external service.</p>
<h2 class="anchor anchorTarget_QU3I" id=interactive-mode><a href=#interactive-mode class=headingLink_no4V aria-label="Copy link to Interactive mode" title="Copy link to Interactive mode"><span class=headingText_IKAy>Interactive mode</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<p>Run with no arguments in a TTY:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory</span><br/></div></code></pre></div></div>
<p>The dashboard keeps the prompt at the bottom and appends command results above
it. Slash controls are handled by the dashboard:</p>
<p>On a fresh machine, run <code>init</code> before relying on interactive commands such as
<code>status</code>, <code>add</code>, or <code>search</code>. If the dashboard says <code>scope not configured</code>,
either run <code>init</code>, set <code>ATOMICMEMORY_SCOPE_USER</code> plus the provider environment
variables above, or include flags directly in the command you type into the
dashboard:</p>
<div class="language-text codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-text codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">status --provider atomicmemory --api-url http://127.0.0.1:17350 --trust-surface local --user alice</span><br/></div></code></pre></div></div>
<table><thead><tr><th>Input<th>Purpose<tbody><tr><td><code>/</code><td>Show the command menu.<tr><td><code>/help</code>, <code>help</code>, <code>?</code><td>Show keyboard controls and command examples.<tr><td><code>/clear</code>, <code>clear</code><td>Clear the session output.<tr><td><code>/quit</code>, <code>/exit</code>, <code>quit</code>, <code>exit</code><td>Exit interactive mode.</table>
<p>Regular CLI commands are typed without a slash:</p>
<table><thead><tr><th>Input<th>Purpose<tbody><tr><td><code>doctor</code><td>Verify local config, package health, and provider readiness.<tr><td><code>status</code><td>Show the active provider, profile, scope, and capability surface.<tr><td><code>config show</code><td>Show the current profile/config in a redacted, readable format.<tr><td><code>add <text></code><td>Store a durable memory.<tr><td><code>search <query></code><td>Search scoped memories.<tr><td><code>package <query></code><td>Build prompt-ready context.</table>
<p>Use <code>PageUp</code> / <code>PageDown</code>, <code>Ctrl+U</code> / <code>Ctrl+D</code>, or the arrow keys to scroll
session output.</p>
<h2 class="anchor anchorTarget_QU3I" id=commands><a href=#commands class=headingLink_no4V aria-label="Copy link to Commands" title="Copy link to Commands"><span class=headingText_IKAy>Commands</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory doctor</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory status</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory validate</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory validate </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--online</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">help</span><span class="token plain"> search</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory version</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain" style=display:inline-block></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory </span><span class="token function" style="color:rgb(220, 220, 170)">add</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"The project uses pnpm workspaces."</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory ingest </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--mode</span><span class="token plain"> verbatim </span><span class="token string" style="color:rgb(206, 145, 120)">"Decision recap for handoff"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory ingest </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--mode</span><span class="token plain"> messages </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--file</span><span class="token plain"> ./conversation.json</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory search </span><span class="token string" style="color:rgb(206, 145, 120)">"workspace package conventions"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--limit</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">5</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory package </span><span class="token string" style="color:rgb(206, 145, 120)">"recent implementation context"</span><span class="token plain"> --token-budget </span><span class="token number" style="color:rgb(181, 206, 168)">1200</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory list </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--limit</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">20</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory get </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">memory-id</span><span class="token operator" style="color:rgb(212, 212, 212)">></span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory delete </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">memory-id</span><span class="token operator" style="color:rgb(212, 212, 212)">></span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory </span><span class="token function" style="color:rgb(220, 220, 170)">import</span><span class="token plain"> ./memories.json</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain" style=display:inline-block></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory config show</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory config profile list</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory config profile use cloud</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory config profile show </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">local</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory skill get core</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory hooks </span><span class="token function" style="color:rgb(220, 220, 170)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--host</span><span class="token plain"> codex </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--runtime</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">node</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory hooks </span><span class="token function" style="color:rgb(220, 220, 170)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--host</span><span class="token plain"> codex </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--runtime</span><span class="token plain"> python</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory hooks run user-prompt-submit </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--host</span><span class="token plain"> codex</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory completion </span><span class="token function" style="color:rgb(220, 220, 170)">bash</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory completion </span><span class="token function" style="color:rgb(220, 220, 170)">zsh</span><br/></div></code></pre></div></div>
<p><code>validate</code> is the post-install diagnostic. It checks the bundled command spec,
config schema, embedded skill, redaction behavior, and local config-file safety;
<code>--online</code> adds provider connectivity checks.</p>
<p>Provider-backed commands accept the same provider and scope overrides:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory search </span><span class="token string" style="color:rgb(206, 145, 120)">"release policy"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--provider</span><span class="token plain"> atomicmemory </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --api-url http://127.0.0.1:17350 </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> --trust-surface </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">local</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--user</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token string environment constant" style="color:rgb(100, 102, 149)">$USER</span><span class="token string" style="color:rgb(206, 145, 120)">"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">\</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--namespace</span><span class="token plain"> atomicmemory-integrations</span><br/></div></code></pre></div></div>
<p><code>--trust-surface</code> can be omitted only when an initialized profile already
supplies it.</p>
<h2 class="anchor anchorTarget_QU3I" id=hook-install><a href=#hook-install class=headingLink_no4V aria-label="Copy link to Hook install" title="Copy link to Hook install"><span class=headingText_IKAy>Hook install</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<p><code>atomicmemory hooks install</code> emits host-specific lifecycle hook config without
mutating user config files. Node is the recommended default and is bundled as
<code>atomicmemory hooks run ...</code>. Python is an advanced option for teams that set
<code>ATOMICMEMORY_PYTHON_HOOK_BIN</code> to a compatible Python hook runner.</p>
<p>For Claude Code, the plugin already ships hooks and is the recommended local
path. Use CLI-generated hooks only when you maintain Claude Code or Codex hook
configuration yourself.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory hooks </span><span class="token function" style="color:rgb(220, 220, 170)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--host</span><span class="token plain"> codex </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--runtime</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">node</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory hooks </span><span class="token function" style="color:rgb(220, 220, 170)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--host</span><span class="token plain"> codex </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--runtime</span><span class="token plain"> python</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory hooks </span><span class="token function" style="color:rgb(220, 220, 170)">install</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--host</span><span class="token plain"> claude-code </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--runtime</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">node</span><br/></div></code></pre></div></div>
<p><code>hooks run <event></code> is normally invoked by the generated host snippet, not by
operators directly. Supported events are <code>user-prompt-submit</code>, <code>post-compact</code>,
and <code>stop</code>.</p>
<p>Agent hook environments often have a thinner <code>PATH</code> than the interactive shell
that ran <code>atomicmemory hooks install</code>. Before relying on a generated snippet,
confirm the CLI resolves inside the host environment:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token builtin class-name" style="color:rgb(78, 201, 176)">command</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-v</span><span class="token plain"> atomicmemory</span><br/></div></code></pre></div></div>
<p>Codex stop payloads are often shorter than Claude Code payloads. The bundled
Node runtime defaults <code>ATOMICMEMORY_STOP_MIN_ASSISTANT_CHARS</code> to <code>200</code>; for
Codex hosts, start with <code>40</code> if shorter stop turns should be captured:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">ATOMICMEMORY_STOP_MIN_ASSISTANT_CHARS</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token number" style="color:rgb(181, 206, 168)">40</span><br/></div></code></pre></div></div>
<p>The generated snippet does not set this override for you.</p>
<p>Claude Code local extraction can use Claude Code's own authenticated session
instead of a separate Anthropic key:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">claude auth login</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">LLM_PROVIDER</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token plain">claude-code</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">EMBEDDING_PROVIDER</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token plain">transformers</span><br/></div></code></pre></div></div>
<p>That mode is for personal/local use. It requires Claude Code to be installed
and logged in, consumes the user's Claude Code / Claude subscription limits, and
is not the recommended path for hosted or team deployments. <code>LLM_PROVIDER</code>
configures the local AtomicMemory core process; CLI profile variables such as
<code>ATOMICMEMORY_API_URL</code>, <code>ATOMICMEMORY_API_KEY</code>, and scope still configure how
the CLI reaches that core process.</p>
<p>Codex local extraction defaults to account-auth:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">codex login</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">LLM_PROVIDER</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token plain">codex</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(156, 220, 254)">EMBEDDING_PROVIDER</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token plain">transformers</span><br/></div></code></pre></div></div>
<p>This is the default Codex local setup. Core reads the auth file created by
<code>codex login</code> and calls the Codex backend directly. No OpenAI API key is
required. It consumes the user's Codex account limits and is not the
recommended path for hosted or team deployments; use <code>LLM_PROVIDER=openai</code> plus
<code>OPENAI_API_KEY</code> for that mode.</p>
<h2 class="anchor anchorTarget_QU3I" id=machine-output><a href=#machine-output class=headingLink_no4V aria-label="Copy link to Machine output" title="Copy link to Machine output"><span class=headingText_IKAy>Machine output</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<p>Use <code>--json</code> for raw command data and <code>--agent</code> for a stable envelope:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token plain">atomicmemory search </span><span class="token string" style="color:rgb(206, 145, 120)">"prior decisions"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--agent</span><br/></div></code></pre></div></div>
<p>Envelope shape:</p>
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-json codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"status"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"success"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"command"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"search"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"duration_ms"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">12</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"profile"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"default"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"scope"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"> </span><span class="token property">"user"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"pip"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"> </span><span class="token property">"namespace"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"docs"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"count"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">1</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"data"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">[</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"memory"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"id"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"mem_123"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"content"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"The docs repo uses pnpm workspaces."</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"scope"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"> </span><span class="token property">"user"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"pip"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"> </span><span class="token property">"namespace"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"docs"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"kind"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"fact"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"createdAt"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"2026-05-09T12:00:00.000Z"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"provenance"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"> </span><span class="token property">"source"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"manual-handoff"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"score"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">0.82</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">]</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"meta"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"> </span><span class="token property">"truncated"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token boolean">false</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"> </span><span class="token property">"limit"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">5</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><br/></div></code></pre></div></div>
<p><code>provenance</code> is whatever the operator passed through <code>--source</code>,
<code>--source-url</code>, or <code>--source-id</code>; the CLI does not stamp <code>source: "cli"</code>
automatically.</p>
<p>Package results carry both the data-level SDK field and the envelope-level
metadata field:</p>
<div class="language-json codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-json codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"status"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"success"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"command"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"package"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"duration_ms"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">18</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"profile"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"default"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"scope"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"> </span><span class="token property">"user"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"pip"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"> </span><span class="token property">"namespace"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"docs"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"count"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">2</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"data"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"text"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"## Relevant Memory\n..."</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"tokens"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">842</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"hits"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">[</span><span class="token punctuation" style="color:rgb(212, 212, 212)">]</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"budgetConstrained"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token boolean">false</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"meta"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">{</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"token_budget"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(181, 206, 168)">1200</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"format"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"tiered"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"section"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">"inline"</span><span class="token punctuation" style="color:rgb(212, 212, 212)">,</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token property">"budget_constrained"</span><span class="token operator" style="color:rgb(212, 212, 212)">:</span><span class="token plain"> </span><span class="token boolean">false</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"> </span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token punctuation" style="color:rgb(212, 212, 212)">}</span><br/></div></code></pre></div></div>
<p><code>data</code> is command-specific: memory commands return the sanitized result for that
command, while errors in <code>--agent</code> mode are emitted as JSON and exit non-zero.</p>
<p><code>--interactive</code> is a text-mode rendering hint. It is rejected with exit code 2
when output resolves to a non-text mode such as <code>--json</code>, <code>--agent</code>, or
<code>--output quiet</code>.</p>
<h2 class="anchor anchorTarget_QU3I" id=backend-smoke><a href=#backend-smoke class=headingLink_no4V aria-label="Copy link to Backend smoke" title="Copy link to Backend smoke"><span class=headingText_IKAy>Backend smoke</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<p>Backend-gated CLI tests are skipped unless <code>ATOMICMEMORY_TEST_BACKEND=1</code> points
at a real <code>atomicmemory-core</code> instance. To exercise them deterministically
against a local Docker stack, run from <code>atomicmemory-integrations</code>:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style=--prism-color:#9CDCFE;--prism-background-color:#1E1E1E><div class=codeBlockContent_QJqH><pre tabindex=0 class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style=color:#9CDCFE;background-color:#1E1E1E><code class=codeBlockLines_e6Vv><div class=token-line style=color:#9CDCFE><span class="token function" style="color:rgb(220, 220, 170)">pnpm</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-C</span><span class="token plain"> packages/cli test:backend:docker</span><br/></div></code></pre></div></div>
<p>The harness starts a sibling <code>atomicmemory-core</code> Docker stack, layers a
CLI-side mock OpenAI-compatible LLM so ingest tests need no external API
credentials, polls the real <code>/health</code> endpoint with a bounded timeout, runs the
backend-gated suite, and tears the stack down.</p>
<p>Optional harness environment variables:</p>
<table><thead><tr><th>Var<th>Purpose<tbody><tr><td><code>ATOMICMEMORY_CORE_PATH</code><td>Path to the core checkout; defaults to sibling <code>../atomicmemory-core</code>.<tr><td><code>ATOMICMEMORY_DOCKER_APP_PORT</code><td>Host port for core's app; defaults to a free port from <code>3060</code>.<tr><td><code>ATOMICMEMORY_DOCKER_POSTGRES_PORT</code><td>Host port for core's Postgres; defaults to a free port from <code>5444</code>.<tr><td><code>ATOMICMEMORY_DOCKER_HEALTH_TIMEOUT</code><td>Bounded <code>/health</code> poll cap in seconds.<tr><td><code>ATOMICMEMORY_DOCKER_SKIP_BUILD</code><td>Reuse existing compose images when set.<tr><td><code>ATOMICMEMORY_DOCKER_KEEP_UP</code><td>Leave the stack running after the test for inspection when set.</table>
<h2 class="anchor anchorTarget_QU3I" id=see-also><a href=#see-also class=headingLink_no4V aria-label="Copy link to See also" title="Copy link to See also"><span class=headingText_IKAy>See also</span><span aria-hidden=true data-markdown-ignore=true class=headingIcon_Pk3T><svg width=0.95em height=0.95em viewBox="0 0 15 15" fill=none xmlns=http://www.w3.org/2000/svg><path d="M8.51194 3.00541C9.18829 2.54594 10.0435 2.53694 10.6788 2.95419C10.8231 3.04893 10.9771 3.1993 11.389 3.61119C11.8009 4.02307 11.9513 4.17714 12.046 4.32141C12.4633 4.95675 12.4543 5.81192 11.9948 6.48827C11.8899 6.64264 11.7276 6.80811 11.3006 7.23511L10.6819 7.85383C10.4867 8.04909 10.4867 8.36567 10.6819 8.56093C10.8772 8.7562 11.1938 8.7562 11.389 8.56093L12.0077 7.94221L12.0507 7.89929C12.4203 7.52976 12.6568 7.2933 12.822 7.0502C13.4972 6.05623 13.5321 4.76252 12.8819 3.77248C12.7233 3.53102 12.4922 3.30001 12.1408 2.94871L12.0961 2.90408L12.0515 2.85942C11.7002 2.508 11.4692 2.27689 11.2277 2.11832C10.2377 1.46813 8.94398 1.50299 7.95001 2.17822C7.70691 2.34336 7.47044 2.57991 7.1009 2.94955L7.058 2.99247L6.43928 3.61119C6.24401 3.80645 6.24401 4.12303 6.43928 4.31829C6.63454 4.51355 6.95112 4.51355 7.14638 4.31829L7.7651 3.69957C8.1921 3.27257 8.35757 3.11027 8.51194 3.00541ZM4.31796 7.14672C4.51322 6.95146 4.51322 6.63487 4.31796 6.43961C4.12269 6.24435 3.80611 6.24435 3.61085 6.43961L2.99213 7.05833L2.94922 7.10124C2.57957 7.47077 2.34303 7.70724 2.17788 7.95035C1.50265 8.94432 1.4678 10.238 2.11799 11.2281C2.27656 11.4695 2.50766 11.7005 2.8591 12.0518L2.90374 12.0965L2.94837 12.1411C3.29967 12.4925 3.53068 12.7237 3.77214 12.8822C4.76219 13.5324 6.05589 13.4976 7.04986 12.8223C7.29296 12.6572 7.52943 12.4206 7.89896 12.051L7.89897 12.051L7.94188 12.0081L8.5606 11.3894C8.75586 11.1941 8.75586 10.8775 8.5606 10.6823C8.36533 10.487 8.04875 10.487 7.85349 10.6823L7.23477 11.301C6.80777 11.728 6.6423 11.8903 6.48794 11.9951C5.81158 12.4546 4.95642 12.4636 4.32107 12.0464C4.17681 11.9516 4.02274 11.8012 3.61085 11.3894C3.19896 10.9775 3.0486 10.8234 2.95385 10.6791C2.53661 10.0438 2.54561 9.18863 3.00507 8.51227C3.10993 8.35791 3.27224 8.19244 3.69924 7.76544L4.31796 7.14672ZM9.62172 6.08558C9.81698 5.89032 9.81698 5.57373 9.62172 5.37847C9.42646 5.18321 9.10988 5.18321 8.91461 5.37847L5.37908 8.91401C5.18382 9.10927 5.18382 9.42585 5.37908 9.62111C5.57434 9.81637 5.89092 9.81637 6.08619 9.62111L9.62172 6.08558Z" fill=currentColor fill-rule=evenodd clip-rule=evenodd /></svg></span></a></h2>
<ul>
<li class=""><a class="" href=/sdk/concepts/provider-model>SDK provider model</a></li>
<li class=""><a class="" href=/sdk/guides/atomicmemory-backend>Using the AtomicMemory backend</a></li>
<li class=""><a class="" href=/integrations/overview>Integrations overview</a></li>
</ul></div></div></div><div class=row><div class="col col--12"></div></div></article><div class=row><div class="col col--12"><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href=/platform/lessons><div class=pagination-nav__sublabel>Previous</div><div class=pagination-nav__label>Lessons</div></a><a class="pagination-nav__link pagination-nav__link--next" href=/core-only-docker><div class=pagination-nav__sublabel>Next</div><div class=pagination-nav__label>Core-only Docker</div></a></nav></div></div></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href=#what-you-get class="table-of-contents__link toc-highlight">What you get</a><li><a href=#install class="table-of-contents__link toc-highlight">Install</a><li><a href=#choose-a-setup-path class="table-of-contents__link toc-highlight">Choose a setup path</a><li><a href=#configure class="table-of-contents__link toc-highlight">Configure</a><li><a href=#interactive-mode class="table-of-contents__link toc-highlight">Interactive mode</a><li><a href=#commands class="table-of-contents__link toc-highlight">Commands</a><li><a href=#hook-install class="table-of-contents__link toc-highlight">Hook install</a><li><a href=#machine-output class="table-of-contents__link toc-highlight">Machine output</a><li><a href=#backend-smoke class="table-of-contents__link toc-highlight">Backend smoke</a><li><a href=#see-also class="table-of-contents__link toc-highlight">See also</a></ul></div></div></div></div></main></div></div></div><footer class=footer_lz6l><div class=inner_TfpW><div class=top_uBKw><div class=brand_KP03><a class=brandLink_zN6t aria-label="Atomic Strata home" href=/><img src=/img/logo-mark.svg alt="" class=logo_xa73 /><span class=brandName_Nbtk>Atomic Strata</span></a><p class=tagline_ml1n>Memory infrastructure for AI applications. Run it locally with `am init`, watch it in the console, and add managed hosting when you need it.</div><div class=columns_CNuT><div class=column_KT0C><span class=colTitle_OS1M>Docs</span><a class=link_CpBN href=/introduction>Introduction</a><a class=link_CpBN href=/quickstart>Quickstart</a><a class=link_CpBN href=/cloud/overview>AtomicMemory Cloud</a><a class=link_CpBN href=/sdk/overview>SDK</a><a class=link_CpBN href=/api-reference/http/conventions>API Reference</a></div><div class=column_KT0C><span class=colTitle_OS1M>Code</span><a href=https://github.com/atomicstrata/atomicmemory/tree/main/packages/core target=_blank rel="noopener noreferrer" class=link_CpBN>Core</a><a href=https://github.com/atomicstrata/atomicmemory/tree/main/packages/sdk target=_blank rel="noopener noreferrer" class=link_CpBN>SDK</a><a href=https://github.com/atomicstrata/atomicmemory/tree/main/plugins target=_blank rel="noopener noreferrer" class=link_CpBN>Integrations</a></div><div class=column_KT0C><span class=colTitle_OS1M>Community</span><a href=https://github.com/atomicstrata/atomicmemory target=_blank rel="noopener noreferrer" class=link_CpBN>GitHub</a><a href=https://github.com/atomicstrata/atomicmemory/issues target=_blank rel="noopener noreferrer" class=link_CpBN>Issues</a></div></div></div><div class=bottom_Vxfi><span>Copyright © <!-- -->2026<!-- --> Atomic Strata. Apache-2.0 licensed.</span><span class=versions_pFJt><span class=version__X3y>core v1.1.1</span><span class=version__X3y>sdk v1.1.1</span><span class=version__X3y>cli v0.1.4</span></span></div></div></footer></div></body>