golem-list-and-filter-agents

Filters deployed agents by name, component, status, revision, time and environment metadata using golem-cli commands with AND-combined options and pagination.

Updated May 17, 2026
One-click install
npx skills add https://github.com/Rust-soham/golem-claw --skill golem-list-and-filter-agents-rust-soham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golem-list-and-filter-agents
Source: https://github.com/Rust-soham/golem-claw/tree/main/packages/golem/.agents/skills/golem-list-and-filter-agents
Command: npx skills add https://github.com/Rust-soham/golem-claw --skill golem-list-and-filter-agents-rust-soham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly find the right deployed agents when you have many components and need to narrow results by name, status, revision, creation time, or environment variables.

Core Features & Use Cases

  • Agent listing across components: View all agents with key fields like name, component, status, and revision.
  • Targeted filtering: Apply multiple AND-combined filters using comparators for string, numeric/ordinal fields, timestamps, status, and environment variables (env.<VAR>).
  • Operational workflows: Use pagination for large result sets and a watch refresh mode to monitor changes over time.

Quick Start

Run golem agent list CounterAgent to list agents of a specific type and review their status and revision.

Frequently Asked Questions about golem-list-and-filter-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list and filter deployed agents by status or revision in Golem?

You can list and filter deployed agents in Golem by applying multiple AND-combined flags to narrow results by status, revision, name, or component. This allows precise operational browsing across multi-component applications.

Can I filter Golem agents by environment variables?

Yes, you can filter Golem agents by environment variables using the env.<VAR> comparator. This targets specific workers based on their environment metadata, which is useful for auditing and troubleshooting configurations.

How do I handle large result sets when querying Golem agent lists?

To handle large Golem agent result sets, use pagination via the max-count and scan-cursor parameters. You can also use a watch refresh mode to continuously monitor changes in the agent list over time.

What is the difference between filtering by component-name and component type in Golem?

Filtering by component-name and component type in Golem are mutually exclusive arguments. You must choose one approach per query to successfully list agents, preventing conflicting or ambiguous filter combinations.

How do I find a specific Golem worker by its creation time?

You can find a specific Golem worker by applying timestamp comparators to filter the agent list by created time. This narrows the results to agents deployed within a specific operational window.

Does the Golem agent list command support multi-flag AND filters?

Yes, the Golem agent list command supports multi-flag AND filters, allowing you to combine comparators for string, numeric, ordinal fields, and status to precisely locate specific workers across components.