Agents Commands¶
Manage ACP (Agent Client Protocol) coding agents for SuperQode.
Overview¶
The superqode agents command group discovers, inspects, installs, and checks ACP coding agents. The catalog combines the cached official ACP Registry, bundled offline metadata, and user definitions from ~/.superqode/agents.
agents list¶
List all available coding agents.
superqode agents list [OPTIONS]
Options¶
| Option | Description |
|---|---|
--store | Show agent store interface |
--protocol acp | Limit output to ACP agents |
--tier featured | Show installed agents and missing featured agents |
--tier enterprise | Show installed agents and missing enterprise agents |
--tier all | Show the complete catalog. This is the default |
--refresh | Refresh the official ACP Registry cache before listing |
Examples¶
# List all agents
superqode agents list
# Show the focused catalog
superqode agents list --tier featured
superqode agents list --tier enterprise
# Refresh upstream metadata and versions
superqode agents list --refresh
# Show agent store
superqode agents list --store
Installed agents are always shown regardless of the selected catalog tier.
agents refresh¶
Refresh the official ACP Registry and write the result to ~/.superqode/acp_registry_cache.json.
superqode agents refresh
Normal startup and picker operations do not require network access. If the registry cannot be reached, SuperQode uses the stale cache or bundled catalog.
agents show¶
Show detailed information about a specific agent.
superqode agents show AGENT
Arguments¶
| Argument | Description |
|---|---|
AGENT | Agent identifier (e.g., opencode, claude) |
Examples¶
# Show OpenCode agent details
superqode agents show opencode
# Show Claude Code agent details
superqode agents show claude
agents doctor¶
Check ACP agent installation, setup, and optional protocol health.
superqode agents doctor [AGENT] [OPTIONS]
Options¶
| Option | Description |
|---|---|
--live | Start the ACP agent and check protocol support |
--timeout | Live protocol check timeout in seconds (default: 10.0) |
--json | Emit JSON output |
agents install¶
Install an ACP coding agent.
superqode agents install AGENT
agents free-models¶
List free-tier models discovered across all installed ACP agents.
superqode agents free-models [OPTIONS]
Options¶
| Option | Description |
|---|---|
--agent | Only show free models from this agent |
--refresh | Skip the discovery cache and re-probe live |
--json | Emit JSON instead of a table |
agents store¶
Show the agent store interface.
superqode agents store
agents connect¶
Connect directly to an ACP coding agent.
superqode agents connect AGENT [--project-dir DIR]
This compatibility command is deprecated. New scripts should use:
superqode connect acp AGENT --project-dir DIR
Existing automation can continue using agents connect, but the connect acp form is the maintained connection surface.
Related Commands¶
superqode connect acp <agent>- Connect to an ACP agent:connect acp- Open the installed and featured TUI picker:connect acp enterprise- Open the enterprise agent picker:connect acp all- Open the complete TUI catalog:connect acp refresh- Refresh the cache from the TUIsuperqode providers list- List BYOK providers