Agent skill

finding-agents

Find other agents on the same server. Use when the user asks about other agents, wants to migrate memory from another agent, or needs to find an agent by name or tags.

View SKILL.md on GitHub Repository
Stars 2,070
Forks 205

Install this agent skill to your Project

npx add-skill https://github.com/letta-ai/letta-code/tree/main/src/skills/builtin/finding-agents

SKILL.md

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

bash
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:

bash
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:

bash
letta agents list

Examples

List all agents (up to 20):

bash
letta agents list

Find agent by exact name:

bash
letta agents list --name "ProjectX-v1"

Search agents by name (fuzzy):

bash
letta agents list --query "project"

Find only Letta Code agents:

bash
letta agents list --tags "origin:letta-code"

Find agents with multiple tags:

bash
letta agents list --tags "frontend,production" --match-all-tags

Include memory blocks in results:

bash
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 name
  • description - Agent description
  • tags - Agent tags
  • blocks - Memory blocks (if --include-blocks used)

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-agents to get agent_id values, 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:

  1. Load both skills: searching-messages and finding-agents
  2. Search messages across all agents:
    bash
    letta messages search --query "topic" --all-agents --limit 10
  3. Note the agent_id values from matching messages
  4. Get agent details:
    bash
    letta agents list --query "partial-name"
    Or use the agent_id directly in the Letta API

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

letta-ai/letta-code

adding-models

Guide for adding new LLM models to Letta Code. Use when the user wants to add support for a new model, needs to know valid model handles, or wants to update the model configuration. Covers models.json configuration, CI test matrix, and handle validation.

2,070 205
Explore
letta-ai/letta-code

searching-messages

Search past messages to recall context. Use when you need to remember previous discussions, find specific topics mentioned before, pull up context from earlier in the conversation history, or find which agent discussed a topic.

2,070 205
Explore
letta-ai/letta-code

converting-mcps-to-skills

Connect to MCP (Model Context Protocol) servers and create skills for repeated use. Load when a user wants to use an MCP server, connect to external tools via MCP, or when they mention MCP, model context protocol, or specific MCP servers.

2,070 205
Explore
letta-ai/letta-code

working-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.

2,070 205
Explore
letta-ai/letta-code

Migrating from Codex and Claude Code

Find and search historical conversation data from Claude Code and OpenAI Codex CLIs. Use when you need to understand a user's coding patterns, learn about a project from past sessions, or bootstrap agent memory from historical context.

2,070 205
Explore
letta-ai/letta-code

migrating-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.

2,070 205
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results