mcpField
F
finding-agents

finding-agents

github.com/letta-aiAgent workflows3.7k75 installsUpdated today
Repository

About finding-agents

A Letta skill for locating agents on the same server by name or tags, and retrieving their details. It helps users identify agents and IDs for follow-up tasks such as memory migration.

Key features

  1. 01List agents on the server
  2. 02Filter by exact or fuzzy name
  3. 03Filter by one or more tags
  4. 04Include memory blocks in results
  5. 05Search messages to identify agents

Use cases

  1. 01Find an agent by its name
  2. 02Locate agents with selected tags
  3. 03Get an agent ID for memory migration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/letta-ai/letta-code --skill finding-agents

After installing, type/finding-agentsin Claude Code to confirm it loaded.

Details

From the project README

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
OptionDescription
--name <name>Exact name match
--query <text>Fuzzy search by name
--tags <tag1,tag2>Filter by tags (comma-separated)
--match-all-tagsRequire ALL tags (default: ANY)
--include-blocksInclude 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 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
Finding Agents by Topic

If you need to find which agent worked on a specific topic:

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

Comments

Markdown supported