-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcli.html
More file actions
360 lines (360 loc) · 198 KB
/
Copy pathcli.html
File metadata and controls
360 lines (360 loc) · 198 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
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
<!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>CLI | Atomic Memory</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="CLI | Atomic Memory"/><meta data-rh=true name=description content="These pages describe the cloud-first CLI (Hosted Cloud as plain am init,"/><meta data-rh=true property=og:description content="These pages describe the cloud-first CLI (Hosted Cloud as plain am init,"/><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":"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.3cbc5cc1.css /><script src=/assets/js/runtime~main.d53e80e0.js defer></script><script src=/assets/js/main.8df4826f.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 Memory" class="themedComponent_mlkZ themedComponent--light_NVdE"/><img src=/img/logo-mark.svg alt="Atomic Memory" class="themedComponent_mlkZ themedComponent--dark_xIcU"/></div><b class="navbar__title text--truncate">Atomic Memory</b></a><a class="navbar__item navbar__link" href=/introduction>Atomic Memory</a><a aria-current=page class="navbar__item navbar__link navbar__link--active" href=/open-source/overview>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=/open-source/overview><span class=linkLabel_WmDU>Overview</span></a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class=menu__link href=/open-source/quickstart><span class=linkLabel_WmDU>Quickstart</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>How it works</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/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/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/artifact-storage><span class=linkLabel_WmDU>Artifact Storage</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=/platform/observability><span class=categoryLinkLabel_W154>Operate it</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/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><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 menu__link--active" aria-current=page tabindex=0 href=/cli><span class=linkLabel_WmDU>CLI</span></a></ul><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>Open Source vs Atomic Memory</span></a></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>Operate it</span><li class="breadcrumbs__item breadcrumbs__item--active"><span class=breadcrumbs__link>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=cli><a href=#cli class=headingLink_no4V aria-label="Copy link to CLI" title="Copy link to CLI"><span class=headingText_IKAy>CLI</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>
<div class="theme-admonition theme-admonition-caution admonition_xJq3 alert alert--warning"><div class=admonitionHeading_Gvgb><span class=admonitionIcon_Rf37><svg viewBox="0 0 16 16"><path fill-rule=evenodd d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"/></svg></span>Public CLI release timing</div><div class=admonitionContent_BuS1><p>These pages describe the <strong>cloud-first</strong> CLI (Hosted Cloud as plain <code>am init</code>,
Connected Local as <code>am init --local</code>). The public installer at
<a href=https://get.atomicstrata.ai target=_blank rel="noopener noreferrer" class="">get.atomicstrata.ai</a> must expose those flags
before this docs revision ships.<p>Check your binary with <code>am --version</code> and <code>am init --help</code>. If <code>--local</code> is
missing (for example on public <strong><code>am</code> 0.2.0</strong>), plain <code>am init</code> is still
Connected Local. Follow the <a class="" href=/open-source/quickstart>Open Source Quickstart</a>
using <strong><code>am init</code></strong> without <code>--local</code> until the matching release is published.<p>Run <code>npm run check:public-cli</code> before production deploy. See
<a href=#public-cli-release-contract class="">Public CLI release contract</a>. PR
<a href=https://github.com/atomicstrata/am-docs-internal/actions/workflows/ci.yml target=_blank rel="noopener noreferrer" class="">CI</a>
runs typecheck/build only; deploy and the
<a href=https://github.com/atomicstrata/am-docs-internal/actions/workflows/public-cli-contract.yml target=_blank rel="noopener noreferrer" class="">Public CLI contract</a>
workflow gate release sequencing.</div></div>
<p>Atomic Memory ships two command-line tools. They are different programs for
different jobs, and they are not interchangeable.</p>
<table><thead><tr><th>Tool<th>Install<th>Use it for<tbody><tr><td><strong><code>am</code></strong> (Atomic Memory CLI)<td><code>get.atomicstrata.ai</code><td>Sign-in, <code>am init</code>, projects, API keys, memory commands, agent MCP install. The primary CLI.<tr><td><strong><code>atomicmemory</code></strong> (Core CLI)<td><code>npm i -g @atomicmemory/cli</code><td>Legacy npm CLI. Deprecated for most workflows; still published for <code>import --type llmwiki</code> and Ink TUI power users.</table>
<p>Start with <strong><code>am</code></strong>. Use the npm CLI only when you need a workflow that <code>am</code>
does not cover yet.</p>
<p>Neither is the MCP server: <code>atomicmemory-mcp</code> is a stdio process for agent
hosts. See <a class="" href=/integrations/overview>Integrations</a>.</p>
<hr/>
<h2 class="anchor anchorTarget_QU3I" id=atomic-memory-cli-am><a href=#atomic-memory-cli-am class=headingLink_no4V aria-label="Copy link to atomic-memory-cli-am" title="Copy link to atomic-memory-cli-am"><span class=headingText_IKAy>Atomic Memory CLI (<code>am</code>)</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>The <strong>Atomic Memory CLI</strong> (<strong><code>am</code></strong>) is the primary CLI for Hosted Cloud and
Connected Local: browser login, project management, API keys, memory commands,
and agent host MCP wiring.</p>
<p>Install from <code>get.atomicstrata.ai</code>. Defaults to <code>https://api.atomicstrata.ai</code>.</p>
<div class="theme-admonition theme-admonition-important admonition_xJq3 alert alert--info"><div class=admonitionHeading_Gvgb><span class=admonitionIcon_Rf37><svg viewBox="0 0 14 16"><path fill-rule=evenodd d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"/></svg></span>Not the npm CLI</div><div class=admonitionContent_BuS1><p>This is <strong>not</strong> the Node.js <code>@atomicmemory/cli</code> package below. The npm CLI is
deprecated for most workflows and remains published for legacy paths.</div></div>
<h3 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></h3>
<p>Canonical one-liner (install + onboard):</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)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--proto</span><span class="token plain"> </span><span class="token string" style="color:rgb(206, 145, 120)">'=https'</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--tlsv1.2</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-fsSL</span><span class="token plain"> https://get.atomicstrata.ai/install.sh </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">sh</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-s</span><span class="token plain"> -- </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--init</span><br/></div></code></pre></div></div>
<p>Install only (run <code>am init</code> 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 function" style="color:rgb(220, 220, 170)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-fsSL</span><span class="token plain"> https://get.atomicstrata.ai/install.sh </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">sh</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)">source</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)">$HOME</span><span class="token string" style="color:rgb(206, 145, 120)">/.atomicmemory/env"</span><br/></div></code></pre></div></div>
<p>Prebuilt binaries for macOS and Linux (x86_64 + arm64). Installs to
<code>~/.local/bin</code> by default and adds the <strong><code>am</code></strong> symlink. PATH activation lives
in <code>~/.atomicmemory/env</code>. Credentials are stored separately (see
<a href=#defaults class="">Defaults</a> below).</p>
<p>Pin a version:</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)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-fsSL</span><span class="token plain"> https://get.atomicstrata.ai/install.sh </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">sh</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-s</span><span class="token plain"> -- </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--version</span><span class="token plain"> </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">x.y.z</span><span class="token operator" style="color:rgb(212, 212, 212)">></span><br/></div></code></pre></div></div>
<p>Skip PATH modification:</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)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-fsSL</span><span class="token plain"> https://get.atomicstrata.ai/install.sh </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">sh</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-s</span><span class="token plain"> -- --no-modify-path</span><br/></div></code></pre></div></div>
<h3 class="anchor anchorTarget_QU3I" id=hosted-cloud-am-init-default><a href=#hosted-cloud-am-init-default class=headingLink_no4V aria-label="Copy link to hosted-cloud-am-init-default" title="Copy link to hosted-cloud-am-init-default"><span class=headingText_IKAy>Hosted Cloud: <code>am init</code> (default)</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></h3>
<p>Plain <code>am init</code> defaults to <strong>Hosted Cloud</strong>: managed memory with no Docker or
OpenAI key. The CLI signs you in, selects a Cloud project, provisions or reuses
a per-installation API key (<code>am-cli-<12-hex></code>), saves the active profile, and
leaves you ready to run memory commands.</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">am init</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am memory ingest </span><span class="token string" style="color:rgb(206, 145, 120)">"I prefer aisle seats when flying."</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am memory search </span><span class="token string" style="color:rgb(206, 145, 120)">"seat preference"</span><br/></div></code></pre></div></div>
<p>Interactive <code>am init</code> offers:</p>
<ol>
<li class=""><strong>Hosted Cloud</strong> (default): managed memory, no Docker</li>
<li class=""><strong>Connected Local</strong>: Core on this machine (<code>am init --local</code>)</li>
</ol>
<p>Non-interactive automation:</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">am init </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--yes</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--project</span><span class="token plain"> </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">cloud-project-id</span><span class="token operator" style="color:rgb(212, 212, 212)">></span><br/></div></code></pre></div></div>
<p>With zero Cloud projects and <code>--yes</code> (or no TTY), init prints the onboarding
URL and recovery command and exits nonzero. Complete onboarding in the
browser, then run <code>am init</code> again.</p>
<p>Full SDK walkthrough: <a class="" href=/quickstart>Quickstart</a>. Something not working? See
<a class="" href=/cloud/troubleshooting>Troubleshooting</a>.</p>
<h3 class="anchor anchorTarget_QU3I" id=connected-local--am-init---local><a href=#connected-local--am-init---local class=headingLink_no4V aria-label="Copy link to connected-local--am-init---local" title="Copy link to connected-local--am-init---local"><span class=headingText_IKAy>Connected Local — <code>am init --local</code></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></h3>
<p>Run Core on your machine with console visibility. Requires Docker and an OpenAI
API 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 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)">OPENAI_API_KEY</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token string" style="color:rgb(206, 145, 120)">"sk-..."</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am init </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--local</span><br/></div></code></pre></div></div>
<p>Full walkthrough: <a class="" href=/open-source/quickstart>Open Source Quickstart</a>. Re-check
anytime with <code>am doctor --smoke</code>.</p>
<p>Already created a Local project in the console? Run <code>am init --local --project <slug></code> instead.</p>
<h3 class="anchor anchorTarget_QU3I" id=instance-status><a href=#instance-status class=headingLink_no4V aria-label="Copy link to Instance status" title="Copy link to Instance status"><span class=headingText_IKAy>Instance status</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></h3>
<p>Check what <code>am init --local</code> connected and configured:</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">am instance status</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am instance status --show-secrets</span><br/></div></code></pre></div></div>
<p><code>--show-secrets</code> prints the <code>CORE_API_KEY</code> <code>am init --local</code> configured for
your Core — see <a class="" href=/cloud/authentication#local-core-token-or-core_api_key>Authentication → Local: Core token or
<code>CORE_API_KEY</code></a>.</p>
<h3 class="anchor anchorTarget_QU3I" id=migration><a href=#migration class=headingLink_no4V aria-label="Copy link to Migration" title="Copy link to Migration"><span class=headingText_IKAy>Migration</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></h3>
<p>Move memories from a Local project into a Cloud project after upgrading to
Free:</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">am migrate </span><span class="token builtin class-name" style="color:rgb(78, 201, 176)">export</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--project</span><span class="token plain"> </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">local-project-slug</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">am migrate </span><span class="token function" style="color:rgb(220, 220, 170)">import</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--file</span><span class="token plain"> </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">path-to-export.jsonl</span><span class="token operator" style="color:rgb(212, 212, 212)">></span><span class="token plain"> --target-project </span><span class="token operator" style="color:rgb(212, 212, 212)"><</span><span class="token plain">cloud-project-slug</span><span class="token operator" style="color:rgb(212, 212, 212)">></span><br/></div></code></pre></div></div>
<p><strong>Export</strong> requires an <strong>active Connected Local profile</strong>. Switch with
<code>am config profile use <local-profile></code> before exporting. Export fails without
mutating your profile if the active profile is Hosted Cloud.</p>
<p><strong>Import</strong> sends records in chunks of 500 per request. v1 supports
<code>--mode merge</code> only (the default). Imported memories merge with existing scope
data; <code>--mode replace-scope</code> is rejected by the Cloud API today.</p>
<p>Memory-only — trace history doesn't move. Full walkthrough:
<a class="" href=/cloud/how-to/migrate>Migrate to Atomic Memory</a>.</p>
<h3 class="anchor anchorTarget_QU3I" id=agent-host-mcp-manual-install><a href=#agent-host-mcp-manual-install class=headingLink_no4V aria-label="Copy link to Agent host MCP: manual install" title="Copy link to Agent host MCP: manual install"><span class=headingText_IKAy>Agent host MCP: manual 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></h3>
<p>After <code>am init</code>, wire AtomicMemory into Cursor, Claude Code, or Codex with the
<strong>manual MCP configs</strong> in each host's integration guide. Do <strong>not</strong> use
<code>am integrate</code> on <strong>Hosted Cloud</strong> in current CLI releases. See
<a href=#known-product-defects-am-integrate class="">Known product defects</a> below.</p>
<p>Manual Hosted Cloud MCP env (set in the host config or your shell):</p>
<p><code>am init</code> saves a per-install CLI key for <code>am memory *</code>, but it does <strong>not</strong>
print that secret. Create a dedicated MCP key and copy its one-time output:</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">am key create mcp</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)">"amc_..."</span><span class="token plain"> </span><span class="token comment" style="color:rgb(106, 153, 85)"># paste from "API key secret (shown once): ..."</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 plain">https://api.atomicstrata.ai</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)">"you@company.com"</span><span class="token plain"> </span><span class="token comment" style="color:rgb(106, 153, 85)"># stable per-person identity</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_LOCK</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token plain">true </span><span class="token comment" style="color:rgb(106, 153, 85)"># reject caller scope overrides</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain"></span><span class="token comment" style="color:rgb(106, 153, 85)"># Do not set ATOMICMEMORY_SCOPE_NAMESPACE on Hosted Cloud today. See below.</span><br/></div></code></pre></div></div>
<p>Or create a key named <code>mcp</code> on the project's
<a class="" href=/cloud/how-to/api-keys>API Keys</a> page and copy the one-time reveal banner
into <code>ATOMICMEMORY_API_KEY</code>.</p>
<p>Pin <code>@atomicmemory/mcp-server@0.1.5</code> in the host MCP launch args. Per-host
examples: <a class="" href=/integrations/overview#wire-mcp-manually>Integrations</a>.</p>
<h4 class="anchor anchorTarget_QU3I" id=known-product-defects-am-integrate><a href=#known-product-defects-am-integrate class=headingLink_no4V aria-label="Copy link to known-product-defects-am-integrate" title="Copy link to known-product-defects-am-integrate"><span class=headingText_IKAy>Known product defects (<code>am integrate</code>)</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></h4>
<p><code>am integrate</code> exists in the CLI but is <strong>not safe to document as a Hosted
Cloud install path</strong> until these defects are fixed in <code>atomicmemory-internal</code>:</p>
<ul>
<li class=""><strong>Namespace asymmetry:</strong> the generator sets
<code>ATOMICMEMORY_SCOPE_NAMESPACE=<project_id></code> and <code>ATOMICMEMORY_SCOPE_LOCK=true</code>,
but ingest omits that namespace while search filters by it, so ingested facts can
be invisible to recall.</li>
<li class=""><strong>Scope user lock:</strong> the generator derives <code>ATOMICMEMORY_SCOPE_USER</code> from
<code>$USER</code>, <code>$USERNAME</code>, or <code>default</code> and locks it. The documented
<code>--scope-user</code> flag is rejected in the integrate subcommand position and
ignored even when passed at the top level, so common OS usernames (<code>ubuntu</code>,
<code>runner</code>, <code>default</code>) can collide across people in the same Hosted project.</li>
</ul>
<p>Use manual MCP with an explicit <code>ATOMICMEMORY_SCOPE_USER</code>,
<code>ATOMICMEMORY_SCOPE_LOCK=true</code>, and <strong>omit</strong>
<code>ATOMICMEMORY_SCOPE_NAMESPACE</code> on Hosted Cloud until product ships fixes.</p>
<h3 class="anchor anchorTarget_QU3I" id=public-cli-release-contract><a href=#public-cli-release-contract class=headingLink_no4V aria-label="Copy link to Public CLI release contract" title="Copy link to Public CLI release contract"><span class=headingText_IKAy>Public CLI release contract</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></h3>
<p>Before production deploy, run:</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"> run check:public-cli</span><br/></div></code></pre></div></div>
<p>That script downloads the live public binary from <code>get.atomicstrata.ai</code> and
asserts <code>am init --help</code> lists standalone <code>--local</code> and <code>--cloud</code> flags.</p>
<table><thead><tr><th>Gate<th>Enforcement<th>Blocks<tbody><tr><td><strong>Merge (docs quality)</strong><td><a href=https://github.com/atomicstrata/am-docs-internal/actions/workflows/ci.yml target=_blank rel="noopener noreferrer" class="">CI</a> on PRs: typecheck + build<td>Broken docs only<tr><td><strong>Deploy</strong><td><a href=https://github.com/atomicstrata/am-docs-internal/actions/workflows/deploy.yml target=_blank rel="noopener noreferrer" class="">Deploy</a> on <code>main</code>: contract before Pages upload<td>Production until public <code>am</code> matches<tr><td><strong>Release readiness</strong><td><a href=https://github.com/atomicstrata/am-docs-internal/actions/workflows/public-cli-contract.yml target=_blank rel="noopener noreferrer" class="">Public CLI contract</a> on <code>main</code>/<code>staging</code> push or manual dispatch<td>Signals CLI lag after merge; not a PR check</table>
<p>PR CI runs only <a href=https://github.com/atomicstrata/am-docs-internal/actions/workflows/ci.yml target=_blank rel="noopener noreferrer" class="">CI</a>
(typecheck + build). The live contract check does <strong>not</strong> run on pull requests.</p>
<p><strong>Merge when docs CI is green.</strong> Production deploy stays blocked on <code>main</code>
until <code>npm run check:public-cli</code> passes and the deploy workflow succeeds.</p>
<h3 class="anchor anchorTarget_QU3I" id=diagnostics><a href=#diagnostics class=headingLink_no4V aria-label="Copy link to Diagnostics" title="Copy link to Diagnostics"><span class=headingText_IKAy>Diagnostics</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></h3>
<table><thead><tr><th>Command<th>What it checks<tbody><tr><td><code>am doctor</code><td>Auth preflight, connect wiring (skipped for Hosted Cloud profile), optional <code>--smoke</code><tr><td><code>am doctor --smoke</code><td>End-to-end ingest → search → delete (Connected Local pipeline)<tr><td><code>am auth doctor</code><td>OAuth endpoints and API reachability<tr><td><code>am connect doctor</code><td>Local profile, login, Cloud sync key, Core health<tr><td><code>am integrate doctor</code><td>MCP host config vs active profile</table>
<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">am doctor</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am doctor </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--smoke</span><span class="token plain"> </span><span class="token comment" style="color:rgb(106, 153, 85)"># Connected Local round-trip</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am auth doctor</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am connect doctor </span><span class="token comment" style="color:rgb(106, 153, 85)"># Local only</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am integrate doctor</span><br/></div></code></pre></div></div>
<h3 class="anchor anchorTarget_QU3I" id=dashboard-commands-oauth><a href=#dashboard-commands-oauth class=headingLink_no4V aria-label="Copy link to Dashboard commands (OAuth)" title="Copy link to Dashboard commands (OAuth)"><span class=headingText_IKAy>Dashboard commands (OAuth)</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></h3>
<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">am auth login</span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am overview</span><br/></div></code></pre></div></div>
<p>Uses PKCE + browser — no config file required. The public OAuth <code>client_id</code> is
baked into the binary.</p>
<h3 class="anchor anchorTarget_QU3I" id=memory-commands><a href=#memory-commands class=headingLink_no4V aria-label="Copy link to Memory commands" title="Copy link to Memory commands"><span class=headingText_IKAy>Memory 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></h3>
<p>After <code>am init</code> (Hosted Cloud), the CLI stores your project API key. You do not
need to export <code>ATOMICMEMORY_API_KEY</code> for normal 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">am memory ingest </span><span class="token string" style="color:rgb(206, 145, 120)">"I prefer aisle seats when flying."</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am memory search </span><span class="token string" style="color:rgb(206, 145, 120)">"seat preference"</span><span class="token plain"></span><br/></div><div class=token-line style=color:#9CDCFE><span class="token plain">am memory list</span><br/></div></code></pre></div></div>
<p>Init-managed Hosted profiles ignore a stale <code>ATOMICMEMORY_API_KEY</code> in your
shell. To force a one-off override, set <code>ATOMICMEMORY_API_KEY_FORCE=1</code>. For
hand-created Cloud profiles or SDK/MCP clients outside the CLI, export the key
from the console:</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_API_URL</span><span class="token operator" style="color:rgb(212, 212, 212)">=</span><span class="token plain">https://api.atomicstrata.ai</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 plain">amc_dev_xxxxxxxxxxxxxxxx</span><br/></div></code></pre></div></div>
<p>See <a class="" href=/cloud/authentication>Authentication</a> and the <a class="" href=/quickstart>Quickstart</a>.</p>
<h3 class="anchor anchorTarget_QU3I" id=defaults><a href=#defaults class=headingLink_no4V aria-label="Copy link to Defaults" title="Copy link to Defaults"><span class=headingText_IKAy>Defaults</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></h3>
<table><thead><tr><th>Setting<th>Default<tbody><tr><td>API URL<td><code>https://api.atomicstrata.ai</code><tr><td>Default profile<td><code>cloud</code> (Hosted Cloud after plain <code>am init</code>)<tr><td>OAuth callback<td><code>http://127.0.0.1:9876/callback</code></table>
<p>Config and credentials live under the OS application support directory:</p>
<ul>
<li class="">macOS: <code>~/Library/Application Support/ai.atomicstrata.atomicmemory/</code></li>
<li class="">Linux: <code>$XDG_CONFIG_HOME/atomicmemory/</code> (default <code>~/.config/atomicmemory/</code>)</li>
</ul>
<p><code>~/.atomicmemory/env</code> is PATH activation only — not where API keys are stored.</p>
<p>Override API URL with <code>ATOMICMEMORY_API_URL</code>, active profile with
<code>ATOMICMEMORY_PROFILE</code>, or <code>am config profile use</code>.</p>
<h3 class="anchor anchorTarget_QU3I" id=common-commands><a href=#common-commands class=headingLink_no4V aria-label="Copy link to Common commands" title="Copy link to Common commands"><span class=headingText_IKAy>Common 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></h3>
<p>Grouped by job — each group links back to the section above.</p>
<h4 class="anchor anchorTarget_QU3I" id=init--doctor><a href=#init--doctor class=headingLink_no4V aria-label="Copy link to Init & doctor" title="Copy link to Init & doctor"><span class=headingText_IKAy>Init & doctor</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></h4>
<table><thead><tr><th>Command<th>Description<tbody><tr><td><code>am init</code><td>Hosted Cloud activation (default)<tr><td><code>am init --local</code><td>Connected Local (Docker + OpenAI)<tr><td><code>am init --project <id-or-slug></code><td>Connect to an existing console project<tr><td><code>am doctor</code><td>Auth + wiring checks for the active profile<tr><td><code>am doctor --smoke</code><td>End-to-end memory round-trip (Connected Local)<tr><td><code>am integrate doctor</code><td>MCP host config vs active profile</table>
<h4 class="anchor anchorTarget_QU3I" id=connect--instance><a href=#connect--instance class=headingLink_no4V aria-label="Copy link to Connect & instance" title="Copy link to Connect & instance"><span class=headingText_IKAy>Connect & instance</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></h4>
<table><thead><tr><th>Command<th>Description<tbody><tr><td><code>am auth login</code><td>Browser OAuth login for dashboard commands<tr><td><code>am instance status</code><td>Show what <code>am init --local</code> connected<tr><td><code>am instance status --show-secrets</code><td>Same, including the local <code>CORE_API_KEY</code></table>
<h4 class="anchor anchorTarget_QU3I" id=memory><a href=#memory class=headingLink_no4V aria-label="Copy link to Memory" title="Copy link to Memory"><span class=headingText_IKAy>Memory</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></h4>
<table><thead><tr><th>Command<th>Description<tbody><tr><td><code>am memory ingest <text></code><td>Ingest a memory claim<tr><td><code>am memory ingest --file ./memories.jsonl</code><td>Batch ingest<tr><td><code>am memory search <query></code><td>Search memories<tr><td><code>am memory list</code><td>List stored memories</table>
<h4 class="anchor anchorTarget_QU3I" id=migration-commands><a href=#migration-commands class=headingLink_no4V aria-label="Copy link to Migration commands" title="Copy link to Migration commands"><span class=headingText_IKAy>Migration 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></h4>
<table><thead><tr><th>Command<th>Description<tbody><tr><td><code>am migrate export --project <slug></code><td>Export a Local project's memories<tr><td><code>am migrate import --file <path> --target-project <slug></code><td>Import exported memories into a Cloud project</table>
<h4 class="anchor anchorTarget_QU3I" id=cloud-administration><a href=#cloud-administration class=headingLink_no4V aria-label="Copy link to Cloud administration" title="Copy link to Cloud administration"><span class=headingText_IKAy>Cloud administration</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></h4>
<table><thead><tr><th>Command<th>Description<tbody><tr><td><code>am overview</code><td>Dashboard overview via your browser session<tr><td><code>am org list</code><td>List organizations<tr><td><code>am project list</code><td>List projects<tr><td><code>am key create <name></code><td>Create a Cloud API key; prints a one-time <code>amc_…</code> secret</table>
<h3 class="anchor anchorTarget_QU3I" id=uninstall><a href=#uninstall class=headingLink_no4V aria-label="Copy link to Uninstall" title="Copy link to Uninstall"><span class=headingText_IKAy>Uninstall</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></h3>
<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)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-fsSL</span><span class="token plain"> https://get.atomicstrata.ai/install.sh </span><span class="token operator" style="color:rgb(212, 212, 212)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(220, 220, 170)">sh</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">-s</span><span class="token plain"> -- </span><span class="token parameter variable" style="color:rgb(156, 220, 254)">--uninstall</span><br/></div></code></pre></div></div>
<p>Removes binaries and PATH blocks. Config and credentials in the application
support directory are left intact unless you purge them manually.</p>
<h3 class="anchor anchorTarget_QU3I" id=related-docs><a href=#related-docs class=headingLink_no4V aria-label="Copy link to Related docs" title="Copy link to Related docs"><span class=headingText_IKAy>Related docs</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></h3>
<ul>
<li class=""><a class="" href=/quickstart>Quickstart</a> — Hosted Cloud first memory loop</li>
<li class=""><a class="" href=/open-source/quickstart>Open Source Quickstart</a> — Connected Local via <code>am init --local</code></li>
<li class=""><a class="" href=/cloud/how-to/migrate>Migrate to Atomic Memory</a> — move memories with <code>am migrate</code></li>
<li class=""><a class="" href=/cloud/troubleshooting>Troubleshooting</a> — recover from a failed init or doctor run</li>
<li class=""><a class="" href=/cloud/authentication>Authentication</a> — API key vs OAuth</li>
<li class=""><a class="" href=/cli#core-cli-atomicmemorycli>npm CLI (legacy)</a> — advanced self-hosted workflows</li>
</ul>
<hr/>
<h2 class="anchor anchorTarget_QU3I" id=core-cli-atomicmemorycli><a href=#core-cli-atomicmemorycli class=headingLink_no4V aria-label="Copy link to core-cli-atomicmemorycli" title="Copy link to core-cli-atomicmemorycli"><span class=headingText_IKAy>Core CLI (<code>@atomicmemory/cli</code>)</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/cli</code> is the legacy Node.js command line for direct self-hosted
core workflows. <strong><code>am</code></strong> from <a href=https://get.atomicstrata.ai target=_blank rel="noopener noreferrer" class="">get.atomicstrata.ai</a>
is the supported path for sign-in, <code>am init</code>, memory commands, and agent MCP
install. The npm package remains published for <code>import --type llmwiki</code> and
teams that rely on the Ink terminal UI.</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
Open Source. 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 Open Source service — usually Core from the
<a class="" href=/open-source/quickstart>Open Source Quickstart</a> via <code>am init --local</code>, 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>
<h3 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></h3>
<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>
<h3 class="anchor anchorTarget_QU3I" id=install-1><a href=#install-1 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></h3>
<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 Open Source
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>
<h3 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></h3>
<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=/open-source/quickstart>Open Source Quickstart</a> via <code>am init --local</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=/open-source/quickstart>Open Source Quickstart</a>, then configure a <code>local</code> profile below.<tr><td>Direct CLI against a self-hosted service<td>Your team operates Open Source 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><code>am init</code> and <a class="" href=/quickstart>Quickstart</a>.<tr><td>Mem0 adapter<td>You want the CLI shape against a Mem0 backend.<td>Use <code>--provider mem0</code>; Open Source-only commands are capability-gated.</table>
<h3 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></h3>
<p>Create a named local profile for a local Core 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 (npm <strong><code>atomicmemory</code></strong> CLI local profiles —
not Hosted Cloud MCP):</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> (npm CLI profile file)</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>
<h3 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></h3>
<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>
<h3 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></h3>
<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>
<h3 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></h3>
<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 Open Source 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>
<h3 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></h3>
<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>
<h3 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></h3>
<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>
<h3 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></h3>
<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 Open Source 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/consuming-core><div class=pagination-nav__sublabel>Previous</div><div class=pagination-nav__label>Consuming core</div></a><a class="pagination-nav__link pagination-nav__link--next" href=/cloud-vs-open-source><div class=pagination-nav__sublabel>Next</div><div class=pagination-nav__label>Open Source vs Atomic Memory</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=#atomic-memory-cli-am class="table-of-contents__link toc-highlight">Atomic Memory CLI (<code>am</code>)</a><ul><li><a href=#install class="table-of-contents__link toc-highlight">Install</a><li><a href=#hosted-cloud-am-init-default class="table-of-contents__link toc-highlight">Hosted Cloud: <code>am init</code> (default)</a><li><a href=#connected-local--am-init---local class="table-of-contents__link toc-highlight">Connected Local — <code>am init --local</code></a><li><a href=#instance-status class="table-of-contents__link toc-highlight">Instance status</a><li><a href=#migration class="table-of-contents__link toc-highlight">Migration</a><li><a href=#agent-host-mcp-manual-install class="table-of-contents__link toc-highlight">Agent host MCP: manual install</a><li><a href=#public-cli-release-contract class="table-of-contents__link toc-highlight">Public CLI release contract</a><li><a href=#diagnostics class="table-of-contents__link toc-highlight">Diagnostics</a><li><a href=#dashboard-commands-oauth class="table-of-contents__link toc-highlight">Dashboard commands (OAuth)</a><li><a href=#memory-commands class="table-of-contents__link toc-highlight">Memory commands</a><li><a href=#defaults class="table-of-contents__link toc-highlight">Defaults</a><li><a href=#common-commands class="table-of-contents__link toc-highlight">Common commands</a><li><a href=#uninstall class="table-of-contents__link toc-highlight">Uninstall</a><li><a href=#related-docs class="table-of-contents__link toc-highlight">Related docs</a></ul><li><a href=#core-cli-atomicmemorycli class="table-of-contents__link toc-highlight">Core CLI (<code>@atomicmemory/cli</code>)</a><ul><li><a href=#what-you-get class="table-of-contents__link toc-highlight">What you get</a><li><a href=#install-1 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></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 Memory home" href=/><img src=/img/logo-mark.svg alt="" class=logo_xa73 /><span class=brandName_Nbtk>Atomic Memory</span></a><p class=tagline_ml1n>Memory infrastructure for AI applications. Start with Hosted Cloud (`am init`), run Core locally when you need it (`am init --local`), and wire agents with manual MCP configs from the integration guides.</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=/introduction>Atomic Memory</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 Memory. Apache-2.0 licensed.</span><span class=versions_pFJt><span class=version__X3y>core v1.2.1</span><span class=version__X3y>sdk v1.1.1</span><span class=version__X3y>cli v0.1.5</span></span></div></div></footer></div></body>