Inspection
List and inspect agents, blocks, tools, and other resources.
get
List resources on the Letta server. Supports agents, blocks, archives, tools, folders, files, mcp-servers, conversations, and archival memory.
lettactl get <resource> [options]Options
| Flag | Type | Description |
|---|---|---|
| --output, -o | table | json | yaml | wide | Output format |
| --agent, -a | string | Filter by agent name |
| --shared | boolean | Show resources used by 2+ agents |
| --orphaned | boolean | Show resources attached to 0 agents |
| --tags | string | Filter agents by tags (AND logic) |
| --canary | boolean | Show only canary agents |
| --full | boolean | Show full archival entry text |
| --query | string | Semantic search in archival memory |
Examples
List all agents
lettactl get agentsJSON output
lettactl get agents -o jsonShared blocks
lettactl get blocks --sharedFilter by tag
lettactl get agents --tags 'tenant:acme'Search archival
lettactl get archival -a my-agent --query 'pricing'List conversations
lettactl get conversations my-agentdescribe
Show detailed information about a specific resource including full config, attached resources, and source code.
lettactl describe <resource> <name> [options]Options
| Flag | Type | Description |
|---|---|---|
| --canary | boolean | Describe the canary version |
Examples
Describe agent
lettactl describe agent my-agentDescribe block
lettactl describe block brand_guidelinesDescribe tool
lettactl describe tool my-custom-toolDescribe conversation
lettactl describe conversation <conv-id>files
Show file attachment state (open/closed) for an agent.
lettactl files <agent-name>Examples
View files
lettactl files my-agentcontext
Show context window token usage breakdown for an agent.
lettactl context <agent-name>Examples
View context
lettactl context my-agent