Import shared memory

Users with Full access can publish shared memory through the Team OS API. For a client import, the client must exist and be active. Full access does not need a separate client grant.

Import a team note

npm run team -- memory import --file ./team-note.md --visibility team --title "Team note"

Import a client note

npm run team -- memory import --file ./acme-note.md --visibility client --client acme --title "Acme note"

By default, the source path is manual/<file-name>. Use --source-path when you need a stable path:

npm run team -- memory import --file ./onboarding.md --visibility client --client acme --source-path manual/acme/onboarding.md

Expected output:

Import indexed: manual/acme/onboarding.md
ID: <import-id>
Source: <source-id>
Chunks inserted: 3

The import creates a durable import record before indexing. If indexing fails, an admin can list and retry it later.

List and retry imports

List recent imports:

npm run team -- memory imports --limit 5

List only failed imports:

npm run team -- memory imports --status failed

Retry a failed import:

npm run team -- memory retry --id <import-id>

Retry normally forces re-indexing. Add --no-force only when you want the server to skip unchanged content.

Next: Published memory