| name | smith-vault |
| description | Browse vault contents — session logs, sub-agent memory, and queue status. |
| argument-hint | [sessions|agents|queue|status|projects] [<name>] |
Smith Vault Browser
Browse the contents of the .smith/vault/ persistent memory system.
Arguments: $ARGUMENTS
Behavior
No Arguments — Dashboard Summary
When invoked with no arguments, show a summary dashboard:
-
Recent Sessions: List the 5 most recent session logs from .smith/vault/sessions/ with their date, status (from frontmatter), branch, and number of file change entries (count lines matching **Edit** or **Write**).
-
Active Sub-Agents: List any sub-agent type/ID combinations found in .smith/vault/agents/. For each type directory, list identifiers (filenames) with their invocation count (count ### Invocation headings in each file).
-
Queue Status: Count of .md files in .smith/vault/queue/. Show "Empty" if none.
-
Bank: Count of .md files in .smith/vault/bank/ (excluding archive/ subdirectory). Show "Empty" if none.
-
Vault Size: Show total file count and disk usage of .smith/vault/.
Subcommands
-
/smith-vault sessions — List all session logs with date, status, branch, and file change count. Sort by date descending.
-
/smith-vault sessions <filename> — Show the full contents of a specific session log file. Accept either the full filename or a partial match (e.g., 2026-04-02 matches the first session from that date).
-
/smith-vault agents — List all sub-agent types (subdirectories of agents/) and their identifiers with invocation counts.
-
/smith-vault agents <type> — List all identifiers for a given agent type with their full invocation history.
-
/smith-vault queue — Show pending queue items. List each .md file in queue/ with its frontmatter summary. Show "Queue is empty" if none.
-
/smith-vault status — Show vault health metrics:
-
/smith-vault projects — Read ~/.smith/projects.json and list all registered projects with their vault paths and last session dates. Highlight the current project.
Implementation Notes
- All data is read from
.smith/vault/ using standard file reads and grep
- Session frontmatter is YAML — parse
status, branch, session_start fields
- File change count = number of lines containing
**Edit** or **Write** in a session log
- Agent invocation count = number of
### Invocation headings in an agent file
- For partial filename matches on sessions, match against the date portion (YYYY-MM-DD)
- If the vault directory doesn't exist, show a message: "No vault found. Run
/smith to initialize."