super-agent

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.

Usage Flow

1. List available agents

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.

2. Run a task

# 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>

3. Resume a session

For follow-up requests or questions, resume an existing session:

npx -y @kimuson/super-agent agent-task-resume <session-id> "<follow-up prompt>"

Rate Limits and Provider Fallback

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

Troubleshooting

If unexpected errors occur, the background local server may be running an outdated version. Restart it:

npx -y @kimuson/super-agent server stop