swarm run
```
Install
npx skillscat add mj1618/swarm-cli Install via the SkillsCat registry.
About this skill
This skill runs AI agents directly from the command line using plain text prompts. It solves the need to execute agents with configurable iterations, timeouts, environment variables, and background operation. Developers should use it for automated, repeatable agent tasks without a separate interface.
SKILL.md
swarm run
Run AI agents with inline string prompts.
Basic Usage
swarm run -s "Your prompt here"All Options
| Flag | Short | Description |
|---|---|---|
--prompt-string |
-s |
Prompt string (required) |
--iterations |
-n |
Number of iterations (default 1, 0 = unlimited) |
--forever |
-F |
Run indefinitely until manually stopped |
--model |
-m |
Model override (e.g. sonnet, opus) |
--detach |
-d |
Run in background |
--name |
-N |
Name the agent for easy reference |
--working-dir |
-C |
Run agent in a different directory |
--env |
-e |
Set env vars, repeatable (e.g. -e KEY=VALUE) |
--label |
-l |
Attach labels, repeatable (e.g. -l team=backend) |
--timeout |
Total timeout (e.g. 30m, 2h) |
|
--iter-timeout |
Per-iteration timeout (e.g. 10m) |
|
--on-complete |
Shell command to run when agent completes | |
--prefix |
Content to prepend to the prompt | |
--suffix |
Content to append to the prompt | |
--parent |
-P |
Parent agent ID (for sub-agents) |
Examples
# Simple one-shot task
swarm run -s "Fix the failing tests in src/"
# Run 5 iterations in the background
swarm run -s "Review and improve error handling" -n 5 -d
# Run forever with a model override
swarm run -s "Monitor logs and report issues" -F -m sonnet
# Named agent in a specific directory
swarm run -s "Refactor the auth module" -N auth-refactor -C ~/projects/app -d
# With a timeout and on-complete hook
swarm run -s "Run the full test suite" --timeout 30m --on-complete "notify-send 'Done'"
# With environment variables and labels
swarm run -s "Deploy to staging" -e ENV=staging -e DRY_RUN=true -l team=infra -d
# With prompt prefix/suffix
swarm run -s "Implement the feature" --prefix "You are an expert Go developer." --suffix "Write tests for everything."
# Unlimited iterations, detached
swarm run -s "Continuously check for regressions" -n 0 -dInstall
npx skillscat add mj1618/swarm-cli Install via the SkillsCat registry.