Memory
Metateam keeps semantic memory facts extracted from sessions. These facts are searchable by meaning, filterable by project/persona/session, and can also be manually added.
metateam memory without a subcommand behaves like metateam memory stats.
Stats
$ metateam memory stats [--all] [--crew <CREW>] [--station <STATION>]
Shows memory totals grouped by project and persona.
| Flag | Purpose |
|---|---|
--all |
Aggregate across all projects/personas/crews/stations |
--crew <CREW> |
Filter to one crew |
--station <STATION> |
Filter to one station |
List
$ metateam memory list [--all] [--project <PROJECT>] [--persona <P1,P2>] [--crew <CREW>] [--station <STATION>] [--session <SESSION>] [-n <LIMIT>] [--offset <OFFSET>]
Lists stored facts. Default page size is -n 50.
| Flag | Purpose |
|---|---|
--all |
Search across all projects/personas/crews/stations |
--project <PROJECT> |
Filter by project slug/ID |
--persona <P1,P2> |
Filter by one persona or comma-separated personas |
--crew <CREW> |
Filter by crew |
--station <STATION> |
Filter by station |
--session <SESSION> |
Filter by session ID |
-n, --limit <LIMIT> |
Max rows to return (default 50) |
--offset <OFFSET> |
Pagination offset (default 0) |
Examples:
$ metateam memory list --project metateam -n 20
$ metateam memory list --persona data,anvil --project metateam
Recall
$ metateam memory recall <QUERY> [--all] [--project <PROJECT>] [--persona <P1,P2>] [--crew <CREW>] [--station <STATION>] [-n <LIMIT>] [--full]
Runs semantic search (vector similarity) against stored facts. Default result size is -n 10.
| Flag | Purpose |
|---|---|
--all |
Search across all projects/personas/crews/stations |
--project <PROJECT> |
Filter by project slug/ID |
--persona <P1,P2> |
Filter by one persona or comma-separated personas |
--crew <CREW> |
Filter by crew |
--station <STATION> |
Filter by station |
-n, --limit <LIMIT> |
Max rows to return (default 10) |
--full |
Return full memory text (default is truncated preview) |
Examples:
$ metateam memory recall "session hooks migration"
$ metateam memory recall "project detection" --project metateam --full -n 5
Remember
$ metateam memory remember <FACT> [--project <PROJECT>] [--persona <PERSONA>] [--session <SESSION>]
Stores a fact manually.
| Flag | Purpose |
|---|---|
--project <PROJECT> |
Attach fact to a specific project |
--persona <PERSONA> |
Attach fact to a specific persona |
--session <SESSION> |
Attach fact to a specific session |
Example:
$ metateam memory remember "Use deploy.sh cli on macOS to avoid codesign kills" --project metateam --persona data
Show
$ metateam memory show <ID>
Shows full detail for one memory (project/persona/session metadata plus full text). ID prefixes are accepted.
Example:
$ metateam memory show 0cf4d080
Forget
$ metateam memory forget <ID> [-y]
Deletes one memory by ID.
| Flag | Purpose |
|---|---|
-y, --yes |
Skip confirmation |
Output Format
All memory commands support -j, --json for structured output.