fix: auto-correct swapped agent/cloud args and improve help text (#300)

- Auto-correct swapped arguments (e.g., `spawn sprite claude` now runs
  as `spawn claude sprite`) instead of just warning and exiting
- Document `ls` alias for `list` in help text
- Add SPAWN_NO_UPDATE_CHECK env var to troubleshooting section
- Bump version to 0.2.21

Agent: ux-engineer

Co-authored-by: A <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
A 2026-02-10 16:14:50 -08:00 committed by GitHub
parent 1be86da79f
commit e07d9ef5cd
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 7 additions and 4 deletions

View file

@ -1,6 +1,6 @@
{
"name": "@openrouter/spawn",
"version": "0.2.20",
"version": "0.2.21",
"type": "module",
"bin": {
"spawn": "cli.js"

View file

@ -235,8 +235,10 @@ export async function cmdRun(agent: string, cloud: string, prompt?: string): Pro
const manifest = await loadManifestWithSpinner();
if (!manifest.agents[agent] && manifest.clouds[agent] && manifest.agents[cloud]) {
p.log.warn(`It looks like you swapped the agent and cloud arguments.`);
p.log.info(`Try: ${pc.cyan(`spawn ${cloud} ${agent}`)}`);
process.exit(1);
p.log.info(`Running: ${pc.cyan(`spawn ${cloud} ${agent}`)}`);
const tmp = agent;
agent = cloud;
cloud = tmp;
}
validateAgent(manifest, agent);
@ -648,7 +650,7 @@ ${pc.bold("USAGE")}
Execute agent with prompt from file
spawn <agent> Show available clouds for agent
spawn <cloud> Show available agents for cloud
spawn list Full matrix table
spawn list (or ls) Full matrix table
spawn agents List all agents with descriptions
spawn clouds List all cloud providers
spawn update Check for CLI updates
@ -686,6 +688,7 @@ ${pc.bold("TROUBLESHOOTING")}
${pc.dim("*")} Missing credentials: Check cloud-specific READMEs in the repo
${pc.dim("*")} Update issues: Try ${pc.cyan("spawn update")} or reinstall manually
${pc.dim("*")} Garbled unicode: Set ${pc.cyan("SPAWN_NO_UNICODE=1")} for ASCII-only output
${pc.dim("*")} Slow startup: Set ${pc.cyan("SPAWN_NO_UPDATE_CHECK=1")} to skip auto-update
${pc.bold("MORE INFO")}
Repository: https://github.com/${REPO}