Synopsis
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
agent list
Lists all configured agents in a table showing type, name, health status, completed tasks, and failed tasks.
boolean
Output as JSON array.
agent status
Fetches the /health endpoint and displays version, overall status, and per-agent health with last-check timestamps.
boolean
Output as JSON.
agent types
Lists the agent type identifiers available in this profClaw installation (e.g., claude, openai, gemini, ollama).
boolean
Output as JSON array of strings.
Examples
Example Output
Agent Configuration
Agents are configured inconfig/agents.yml. See the configuration reference for available options.
Related
profclaw task- Create and track tasks run by agentsprofclaw chat- Chat directly with an agentprofclaw status- System-wide health overview- AI Providers - Configure provider credentials