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 ```bash 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 ```bash # 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`: ```bash npx -y @kimuson/super-agent agent-task-output <session-id> ``` ### 3. Resume a session For follow-up requests or questions, resume an existing session: ```bash 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: ```bash # 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: ```bash npx -y @kimuson/super-agent server stop ```