knosh list-agents¶

List all agents defined in the agents directory.

Synopsis¶

knosh list-agents

Description¶

list-agents scans the agents directory and prints each agent's name, model, and description. It also reports any agent files that could not be parsed.

The name shown for each agent is the value to pass to --agentId when running prompt or kdocs.

Output¶

The output includes the path to the agents directory, followed by an entry for each agent:

**Agents directory:** /Users/alice/.config/knosh/agents

## my-agent
- **Description:** A helpful assistant for code review
- **Model:** anthropic/claude-sonnet-4-6

## fast-agent
- **Model:** ollama/qwen3.5:latest

Agents without a description field in their frontmatter omit the description line. Agents whose files could not be parsed are listed with an error message instead.