Fleet Reporting
Analyze memory usage and health across your agent fleet.
report memory
Analyze memory block usage across agents. Shows fill percentages with color coding. In analyze mode, agents self-diagnose their own memory health using LLM calls.
lettactl report memory [agent] [options]Options
| Flag | Type | Description |
|---|---|---|
| --all | boolean | Report on all agents |
| --match | string | Filter agents by wildcard pattern |
| --tags | string | Filter agents by tags |
| --analyze | boolean | LLM-powered deep analysis (sends messages to agents) |
| --confirm | boolean | Skip confirmation for analyze mode |
| --output, -o | json | Output format |
Examples
All agents
lettactl report memory --allBy tag
lettactl report memory --tags 'tenant:acme'Deep analysis
lettactl report memory my-agent --analyzeBulk analysis
lettactl report memory --all --analyze --confirmNotes
Color coding: green (<50% full), yellow (50-79%), red (80%+)
Analyze mode costs tokens — each agent receives a diagnostic message
Analysis reports: topic count, space status, stale info, redundancies, suggested actions