Memory CLI reference
Read the facts Atoi keeps for you, in one Workspace or across the account, and forget them.
Use this page to inspect every public atoi memory command, its accepted flags, and one runnable example.
This command group is in preview. Confirm its output shape before you depend on it in automation.
atoi memoryRead the account memory Atoi keeps, and what the agent is holding in one conversation.
| Command | What it does |
|---|---|
atoi memory list | Read the facts Atoi keeps for you in the Workspace you are standing in, plus your Personal, one line per item. |
atoi memory snapshot | Read every fact in your account as one baseline. It refuses rather than answer a partial one. |
atoi memory forget | Forget the facts Atoi keeps in one Workspace, or one fact by id. It cannot be undone, and it takes down the cards that asked about what it forgot. |
atoi memory recall | Read what the agent is holding in one conversation: each thing it kept, under the namespace and key it kept it by. |
#memory recall
Inspect the preview memory recall contract for a paired host.
atoi memory recall --chat-id <chat-id> [--namespace <namespace>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--chat-id required | string | The conversation whose memory to read. | ||
--namespace | string | Read one namespace instead of the whole conversation. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run memory recall
atoi memory recall --chat-id thr_9c4k --namespace release --json#memory snapshot
Read what Atoi keeps about you across threads, one line per item.
atoi memory snapshot
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run memory snapshot
atoi memory snapshot --json#memory list
Read the facts Atoi keeps for you in the Workspace you are standing in, plus your Personal.
atoi memory list [--workspace <workspace-id>] [--personal] [--account]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--workspace | string | Read one Workspace instead of the one you are standing in. | ||
--personal | boolean | Read your Personal Workspace for this call. | ||
--account | boolean | Read every fact in your account, in every Workspace. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run memory list
atoi memory list --jsonPass --account to read every fact in every Workspace, the way memory snapshot does.
#memory forget
Forget the facts Atoi keeps in one Workspace, or one fact by its id.
atoi memory forget [--id <memory-id>] [--workspace <workspace-id>] [--personal] --confirm
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--id | string | Forget one fact by its id instead of the whole Workspace. | ||
--workspace | string | Forget in one Workspace instead of the one you are standing in. | ||
--personal | boolean | Forget in your Personal Workspace for this call. | ||
--confirm required | boolean | Required: forgetting cannot be undone. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run memory forget
atoi memory forget --workspace wsp_7m4c --confirm --jsonForgetting cannot be undone. The command asks for
--confirmevery time, and without--idit forgets every fact in the Workspace you are standing in.
A card in your Inbox that asked you to keep one of those facts is taken down with it, because a question about a fact that no longer exists has no answer. The reply says how many facts were forgotten and how many cards came down.
Read Run work from the terminal for the rest of this group, or the CLI reference index for every command.
Was this useful?