teamshift
Run TeamShift agent teams from your terminal. Metered by usage — you do not
bring your own model key, so a run costs you TeamShift credit rather than an
Anthropic or OpenAI bill.
npx teamshift login
npx teamshift catalog
npx teamshift add code-audit-swarm
npx teamshift run <team-id> "review services/api for auth mistakes"
teamshift teams lists callable teams, including teams you built yourself in the
portal; teamshift agents lists callable individual agents. Keeping the two
inventories separate prevents a large internal agent library from burying the
teams a customer actually runs. add is idempotent — running it twice will not
duplicate a team or overwrite edits you have made to it.
Parallel fan-out
The reason to reach for the CLI instead of the API: one command dispatches many
prompts at once and reports what each one cost.
npx teamshift run <team-id> \
-p "audit auth" -p "map the schema" -p "find dead code" --concurrency 3
STATUS CHARGE TIME PROMPT
───────── ────── ──── ───────────────
completed $1.20 4.1s audit auth
completed $1.20 4.0s map the schema
completed $1.20 4.0s find dead code
3 run(s) · $3.60 total · 8.1s wall clock (12.1s if run one at a time)
--file prompts.txt reads one prompt per line. Concurrency is bounded (default
5) so a large batch does not trip the API's write rate limit. Completed runs
print their scrubbed deliverable after the status table; --json includes it as
the outcome's output field.
Already using Claude Code or Codex?
Prefer the MCP server — it exposes the same teams as tools inside your existing
agent, with no second CLI to learn. Both install commands are in the portal under
Programmatic setup.
Auth
TEAMSHIFT_API_KEY wins over the stored config, so CI never has to write a file.
teamshift login writes ~/.teamshift/config.json at mode 0600.
TEAMSHIFT_API_URL overrides the endpoint.
Exit codes
0 | every run completed and returned its deliverable |
1 | usage/auth error, timeout, failed run, or missing deliverable |
2 | out of credit — add credits and rerun |
Releasing
Published on npm as teamshift. To release: bump version, pnpm build, run
the package tests, then npm publish --access public from this directory.