schwarm-cli

Command-line interface for Schwarm — a distributed system that orchestrates Claude Code agents working on tasks in parallel. Wraps the Schwarm Public API v2 to manage tasks, repositories, skills, agents, and more.

Installation

Requires Ruby >= 4.0.

gem install schwarm-cli

This installs the schwarm executable.

Configuration

Run the interactive configuration once to point the CLI at your Schwarm server and save an API key:

schwarm configure

You'll be prompted for:

• Server URL (defaults to https://schwarm.getdexter.net)
• API Key — create one from your Schwarm server's API Keys page

The credentials are saved to ~/.schwarm/config/<env>.json and the connection is tested before saving.

Usage

List top-level commands:

schwarm help
schwarm tree         # full command tree
schwarm version

Common workflows:

schwarm repos list
schwarm tasks list
schwarm tasks create --repo <REPO_ID> --name "Fix bug" --prompt "..." --status ready
schwarm tasks show <TASK_ID>
schwarm tasks handoff --repo <REPO_ID> --name "Continue WIP"

For the full set of agent-oriented workflows (dispatching tasks, DAGs, handoffs, monitoring, messaging), print the bundled skill:

schwarm skill

This is the same document AI agents read to learn how to drive the CLI, and it's kept in sync with the gem at cli/schwarm-skill.md.

Links

• Schwarm repository
• Source