memory.status
Reports memory health and metadata for the project's agent memory store: file counts, index sizes, pending proposals with age and drift, and security posture. Use this read-only status to decide if maintenance is needed.
Instructions
Report memory health and metadata for the project's .agent-memory/ store: file counts per kind, index + current-state sizes, pending staged proposals (with age, TTL remaining, and drift status per proposal), orphaned branch-local files, secret-scan / git / lock posture. Read-only; never modifies any file. Call this to decide whether memory needs maintenance (stale staging, drifted proposals) before proposing further updates.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memory_version | Yes | the agent-memory binary version | |
| repo | Yes | project name from the manifest | |
| active_branch | No | current git branch, empty outside a repo | |
| durable_files | Yes | count of long-lived git-tracked memory files | |
| archive_files | Yes | count of files under archive/ | |
| local_sessions | Yes | count of session-log files under sessions/ | |
| local_current_files | Yes | count of branch-local current.*.md files | |
| orphan_local_files | No | local current files whose branch no longer exists | |
| index_size_bytes | Yes | size of the FTS5 shadow index on disk | |
| current_size_bytes | Yes | combined size of the active branch + shared current files | |
| staged_updates | No | pending staged proposals with age, TTL, and drift status | |
| stale_notes | No | files flagged stale by freshness tracking (future) | |
| security | Yes | secret-scan + provenance posture | |
| git | Yes | git integration flags | |
| lock | Yes | advisory-lock state |