// Enable when delegating tasks to specialized sub-agents via @kimuson/super-agent CLI
| name | super-agent |
| description | Enable when delegating tasks to specialized sub-agents via @kimuson/super-agent CLI |
| path | super-agent |
@kimuson/super-agent is a tool that invokes AI agents (Claude Code, Codex, etc.) through a unified CLI interface.
npx -y @kimuson/super-agent agent-list
Returns all available agent types. Each agent is a pre-configured specialist โ specifying --agent-type automatically loads an optimized system prompt tailored to the agent's role.
# Foreground (blocks until complete)
npx -y @kimuson/super-agent agent-task --agent-type <type> "<prompt>"
# Background (non-blocking, returns session ID)
npx -y @kimuson/super-agent agent-task --agent-type <type> --background "<prompt>"
Use --background for async execution โ allows running other tasks while waiting. Retrieve results with agent-task-output:
npx -y @kimuson/super-agent agent-task-output <session-id>
For follow-up requests or questions, resume an existing session:
npx -y @kimuson/super-agent agent-task-resume <session-id> "<follow-up prompt>"
Each agent type defines preferred providers and models in priority order. The highest-priority model from globally enabled providers is selected automatically.
Since agents are invoked over the network, they may fail due to rate limits or service outages. On failure, temporarily disable the provider with provider-cooldown and retry:
# Example: "claude is rate limited until 3:00 PM"
npx -y @kimuson/super-agent provider-cooldown claude --disabled-until "15:00"
npx -y @kimuson/super-agent agent-task --agent-type <type> "<prompt>" # retry
If unexpected errors occur, the background local server may be running an outdated version. Restart it:
npx -y @kimuson/super-agent server stop