Skip to main content

​
Synopsis

profclaw agent <subcommand> [flags]

​
Description

agent commands let you inspect the AI agents that are registered and running in profClaw. Agents are responsible for processing tasks and chat sessions. Each agent has a type (e.g., claude, openai, ollama), a name, and health/performance statistics.

​
Subcommands

SubcommandAliasDescription
listlsList all configured agents with health and stats
statushealthShow full health status of all agents
types-List available agent type identifiers

​
agent list

Lists all configured agents in a table showing type, name, health status, completed tasks, and failed tasks.
​
--json
boolean
Output as JSON array.

​
agent status

Fetches the /health endpoint and displays version, overall status, and per-agent health with last-check timestamps.
​
--json
boolean
Output as JSON.

​
agent types

Lists the agent type identifiers available in this profClaw installation (e.g., claude, openai, gemini, ollama).
​
--json
boolean
Output as JSON array of strings.

​
Examples

profclaw agent list

​
Example Output

Type      Name             Status      Completed  Failed
claude    Claude Agent     ● Healthy   142        3
openai    GPT-4o Agent     ● Healthy   87         1
ollama    Llama3 Agent     ● Unhealthy 0          5

​
Agent Configuration

Agents are configured in config/agents.yml. See the configuration reference for available options. 
# config/agents.yml
agents:
  - type: claude
    name: Claude Agent
    model: claude-sonnet-4-6
  - type: openai
    name: GPT-4o Agent
    model: gpt-4o