finding-agents
Finding Agents
This skill helps you find other agents on the same Letta server.
When to Use This Skill
- User asks about other agents they have
- User wants to find a specific agent by name
- User wants to list agents with certain tags
- You need to find an agent ID for memory migration
- You found an agent_id via message search and need details about that agent
CLI Usage
letta agents list [options]
Options
| Option | Description |
|---|---|
--name <name> |
Exact name match |
--query <text> |
Fuzzy search by name |
--tags <tag1,tag2> |
Filter by tags (comma-separated) |
--match-all-tags |
Require ALL tags (default: ANY) |
--include-blocks |
Include agent.blocks in response |
--limit <n> |
Max results (default: 20) |
Common Patterns
Finding Letta Code Agents
Agents created by Letta Code are tagged with origin:letta-code. To find only Letta Code agents:
letta agents list --tags "origin:letta-code"
This is useful when the user is looking for agents they've worked with in Letta Code CLI sessions.
Finding All Agents
If the user has agents created outside Letta Code (via ADE, SDK, etc.), search without the tag filter:
letta agents list
Examples
List all agents (up to 20):
letta agents list
Find agent by exact name:
letta agents list --name "ProjectX-v1"
Search agents by name (fuzzy):
letta agents list --query "project"
Find only Letta Code agents:
letta agents list --tags "origin:letta-code"
Find agents with multiple tags:
letta agents list --tags "frontend,production" --match-all-tags
Include memory blocks in results:
letta agents list --query "project" --include-blocks
Output
Returns the raw API response with full agent details. Key fields:
id- Agent ID (e.g.,agent-abc123)name- Agent namedescription- Agent descriptiontags- Agent tagsblocks- Memory blocks (if--include-blocksused)
Related Skills
- migrating-memory - Once you find an agent, use this skill to copy/share memory blocks
- searching-messages - Search messages across all agents to find which agent discussed a topic. Use
--all-agentsto getagent_idvalues, then use this skill to get full agent details.
Finding Agents by Topic
If you need to find which agent worked on a specific topic:
- Load both skills:
searching-messagesandfinding-agents - Search messages across all agents:
letta messages search --query "topic" --all-agents --limit 10 - Note the
agent_idvalues from matching messages - Get agent details:
Or use the agent_id directly in the Letta APIletta agents list --query "partial-name"
More from letta-ai/letta-code
initializing-memory
Comprehensive guide for initializing or reorganizing agent memory. Load this skill when running /init, when the user asks you to set up your memory, or when you need guidance on creating effective memory files.
70syncing-memory-filesystem
Manage git-backed memory repos. Load this skill when working with git-backed agent memory, setting up remote memory repos, resolving sync conflicts, or managing memory via git workflows.
67creating-skills
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Letta Code's capabilities with specialized knowledge, workflows, or tool integrations.
59working-in-parallel
Guide for working in parallel with other agents. Use when another agent is already working in the same directory, or when you need to work on multiple features simultaneously. Covers git worktrees as the recommended approach.
59migrating-memory
Migrate memory blocks from an existing agent to the current agent. Use when the user wants to copy or share memory from another agent, or during /init when setting up a new agent that should inherit memory from an existing one.
58acquiring-skills
Guide for safely discovering and installing skills from external repositories. Use when a user asks for something where a specialized skill likely exists (browser testing, PDF processing, document generation, etc.) and you want to bootstrap your understanding rather than starting from scratch.
57