kindgi memory

`kindgi memory`

Synopsis

kindgi memory <command>

Signature

Memory: the facts agents remember, by type and scope, and erasing a person's words.

Commands

Command	Description
`kindgi memory facts`	Memory facts: list, get, write, supersede, delete, verify, revisions.
`kindgi memory erasures`	Erasing a person's words: create, get, list, resume, export, replay (a tenant admin only).

See also

`kindgi memory facts`

Synopsis

kindgi memory facts <command>

Signature

Memory facts: list, get, write, supersede, delete, verify, revisions.

Commands

Command	Description
`kindgi memory facts list`	List the memory facts you may see, the current revision of each.
`kindgi memory facts get`	A memory fact by id: its current revision, one revision, or as it stood then.
`kindgi memory facts revisions`	A memory fact's revisions, newest first: who changed or deleted it, when and why.
`kindgi memory facts write`	Write a memory fact.
`kindgi memory facts supersede`	Change a memory fact's content: writes its next revision (same id).
`kindgi memory facts delete`	Delete a memory fact: agents and reads no longer see it; its history stays until retention removes it.
`kindgi memory facts verify`	Mark a memory fact verified: you checked it.
`kindgi memory facts retrieve`	Search the memory facts you may see: newest first, by keyword, by meaning, or both fused by rank.

See also

`kindgi memory facts list`

Synopsis

kindgi memory facts list [--type=<type>] [--scope=<json-or-@file>] [--as-of=<time>] [--limit=<n>] [--cursor=<c>]

Signature

List the memory facts you may see, the current revision of each.

Options

Option	Default	Description
`--as-of <value>`	none	Memory as it stood at this time (an ISO 8601 time with a zone, or a date: its start, UTC), deleted and superseded facts included.
`--cursor <value>`	none	Resume after this cursor, from the previous page's `nextCursor`.
`--limit <value>`	`25` (at most `100`)	The most facts to return (default 25, at most 100).
`--scope <value>`	none	Only the facts in this scope, as inline JSON or `@<file>`: any of `userId`, `orgId`, `projectId`, `threadId`, `sessionId`, `participantId`; every key given must match.
`--type <value>`	none	Only the facts of this type.

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts list --type=acme.note

See also

`kindgi memory facts get`

Synopsis

kindgi memory facts get <fact-id> [--revision=<n>] [--as-of=<time>]

Signature

A memory fact by id: its current revision, one revision, or as it stood then.

Options

Option	Default	Description
`--as-of <value>`	none	Memory as it stood at this time (an ISO 8601 time with a zone, or a date: its start, UTC), deleted and superseded facts included.
`--revision <value>`	none	This revision (its `version`), current or not.

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts get <fact-id>
pnpm exec kindgi memory facts get <fact-id> --as-of=2026-10-01T00:00:00Z

See also

`kindgi memory facts revisions`

Synopsis

kindgi memory facts revisions <fact-id>

Signature

A memory fact's revisions, newest first: who changed or deleted it, when and why.

Options

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts revisions <fact-id>

See also

`kindgi memory facts write`

Synopsis

kindgi memory facts write --input=<json-or-@file>

Signature

Write a memory fact. Prints it, with the id and version the server gave it.

Options

Option	Default	Description
`--input <value>`	required	The fact as inline JSON or `@<file>`: its `type` and `content`, and optionally `scope` (default: your tenant; narrow it with `userId`, `orgId`, `projectId`, `threadId`, `sessionId`, or an app's end user with `projectId` and `participantId`), `retention` (`keepDays`, `keepUntil`, `legalHold`), `subjects` (whom it is about: `[{"kind":"participant","id":"…"}]`) and `validFrom`/`validUntil`/`observedAt`. Required.

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts write --input=@fact.json

See also

`kindgi memory facts supersede`

Synopsis

kindgi memory facts supersede <fact-id> --input=<json-or-@file> [--expect-version=<n>]

Signature

Change a memory fact's content: writes its next revision (same id). Prints the new revision.

Options

Option	Default	Description
`--expect-version <value>`	none	Only if the fact is still at this revision (its `version`); if someone changed it first, nothing changes and the command fails with `fact-changed`.
`--input <value>`	required	The next revision as inline JSON or `@<file>`: its `content`, and optionally `retention`, `subjects` and `validFrom`/`validUntil`/`observedAt` (absent ones keep their current values). Its type and scope stay. Required.

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts supersede <fact-id> --input='{"content":"Prefers phone"}' --expect-version=1

See also

`kindgi memory facts delete`

Synopsis

kindgi memory facts delete <fact-id> [--expect-version=<n>]

Signature

Delete a memory fact: agents and reads no longer see it; its history stays until retention removes it. Prints the closed revision.

Options

Option	Default	Description
`--expect-version <value>`	none	Only if the fact is still at this revision (its `version`); if someone changed it first, nothing changes and the command fails with `fact-changed`.

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts delete <fact-id>

See also

`kindgi memory facts verify`

Synopsis

kindgi memory facts verify <fact-id> [--expect-version=<n>]

Signature

Mark a memory fact verified: you checked it. Prints the new revision (trust: verified).

Options

Option	Default	Description
`--expect-version <value>`	none	Only if the fact is still at this revision (its `version`); if someone changed it first, nothing changes and the command fails with `fact-changed`.

Every command also takes the global flags.

Examples

From Give an agent memory:

pnpm exec kindgi memory facts verify <fact-id>

See also

`kindgi memory facts retrieve`

Synopsis

kindgi memory facts retrieve --query=<json-or-@file>

Signature

Search the memory facts you may see: newest first, by keyword, by meaning, or both fused by rank.

Options

Option	Default	Description
`--query <value>`	required	The retrieval as inline JSON or `@<file>`: a `mode` (`list`, `keyword`, `semantic` or `both`), and optionally `query` (required for a search), `type`, `scope` and `limit`. `semantic` and `both` need embeddings on the runtime (`KINDGI_MEMORY_EMBEDDINGS`). Required.

Every command also takes the global flags.

Examples

Search facts by keyword.

kindgi memory facts retrieve --query='{"mode":"keyword","query":"delivery window","limit":5}'

Run a retrieval whose query is kept in a file.

kindgi memory facts retrieve --query=@query.json

See also

`kindgi memory erasures`

Synopsis

kindgi memory erasures <command>

Signature

Erasing a person's words: create, get, list, resume, export, replay (a tenant admin only).

Commands

Command	Description
`kindgi memory erasures create`	Erase a person's words: their facts, conversations, the runs that served them, and what those left in provenance.
`kindgi memory erasures get`	An erasure: its status, phase, and what each store cleared.
`kindgi memory erasures list`	Erasures, newest first.
`kindgi memory erasures resume`	Try an erasure again now; --force stops one waiting on a run in a flow that serves other people (that run is cancelled).
`kindgi memory erasures export`	The erasure ledger, content-free, to keep off-box: restoring a backup rolls it back too, and `replay` takes it.
`kindgi memory erasures replay`	After restoring a backup: put the exported ledger back, and erase again whoever the tenant holds again.

See also

`kindgi memory erasures create`

Synopsis

kindgi memory erasures create (--participant=<id> | --external=<id> | --fact=<fact-id> | --conversation=<conversation-id>)

Signature

Erase a person's words: their facts, conversations, the runs that served them, and what those left in provenance. Runs in the background; a tenant admin only.

Options

Option	Default	Description
`--conversation <value>`	none	One conversation.
`--external <value>`	none	A person facts name as an `external` subject.
`--fact <value>`	none	One fact, every revision.
`--participant <value>`	none	An app's end user (the `participantId` it gave).

Every command also takes the global flags.

Examples

From Erase a person's data:

pnpm exec kindgi memory erasures create --participant=end-7

See also

`kindgi memory erasures get`

Synopsis

kindgi memory erasures get <erasure-id>

Signature

An erasure: its status, phase, and what each store cleared.

Options

Every command also takes the global flags.

Examples

From Erase a person's data:

pnpm exec kindgi memory erasures get <erasure-id>

See also

`kindgi memory erasures list`

Synopsis

kindgi memory erasures list [--limit=<n>] [--cursor=<c>]

Signature

Erasures, newest first.

Options

Option	Default	Description
`--cursor <value>`	none	Resume after this cursor (the previous page's `nextCursor`).
`--limit <value>`	`25` (at most `100`)	The most to return (default 25, at most 100).

Every command also takes the global flags.

Examples

From Erase a person's data:

pnpm exec kindgi memory erasures list

See also

`kindgi memory erasures resume`

Synopsis

kindgi memory erasures resume <erasure-id> [--force]

Signature

Try an erasure again now; --force stops one waiting on a run in a flow that serves other people (that run is cancelled).

Options

Option	Default	Description
`--force`	off	Don't wait for the shared flow's run: cancel it and go on (it would otherwise wait until its deadline).

Every command also takes the global flags.

Examples

From Erase a person's data:

pnpm exec kindgi memory erasures resume <erasure-id>           # try again now
pnpm exec kindgi memory erasures resume <erasure-id> --force   # stop waiting: cancel that run and go on

See also

`kindgi memory erasures export`

Synopsis

kindgi memory erasures export [--out=<file>]

Signature

The erasure ledger, content-free, to keep off-box: restoring a backup rolls it back too, and replay takes it.

Options

Option	Default	Description
`--out <value>`	standard output	Write it to this file (else, to stdout).

Every command also takes the global flags.

Examples

From Back up and restore the runtime's database:

npx --yes @kindgi/cli@0.1 memory erasures export --out=erasures-$(date +%F).json

From Erase a person's data:

pnpm exec kindgi memory erasures export --out=erasure-ledger.json

See also

`kindgi memory erasures replay`

Synopsis

kindgi memory erasures replay <export-file>

Signature

After restoring a backup: put the exported ledger back, and erase again whoever the tenant holds again.

Options

Every command also takes the global flags.

Examples

From Back up and restore the runtime's database:

npx --yes @kindgi/cli@0.1 memory erasures replay erasures-<date>.json

From Erase a person's data:

pnpm exec kindgi memory erasures replay erasure-ledger.json

See also