# Swarmclaw

Manage your SwarmClaw agent fleet, agents, tasks, chats, chatrooms, goals, schedules...

- Repository: https://github.com/swarmclawai/swarmclaw (703 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-06-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add swarmclawai/swarmclaw --skill swarmclaw -g -a claude-code -y`
Codex: `npx skills add swarmclawai/swarmclaw --skill swarmclaw -g -a codex -y`
Cursor: `npx skills add swarmclawai/swarmclaw --skill swarmclaw -g -a cursor -y`
Gemini CLI: `npx skills add swarmclawai/swarmclaw --skill swarmclaw -g -a gemini-cli -y`

## Description

Manage your SwarmClaw agent fleet, agents, tasks, chats, chatrooms, goals, schedules, memory, wallets, connectors, autonomy, and 40+ more command groups. Use when asked to dispatch work, check agent status, coordinate multi-agent work, run diagnostics, manage schedules, set goals, or orchestrate across a SwarmClaw dashboard instance.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Overview

SwarmClaw is a self-hosted AI agent orchestration platform. This skill gives you CLI access to manage agents, tasks, chats, chatrooms, goals, schedules, memory, wallets, connectors, autonomy controls, webhooks, extensions, and more across one or many SwarmClaw instances.

The CLI maps 1:1 to the SwarmClaw REST API. Every command follows the pattern:

```
swarmclaw <group> <action> [id] [--flags]
```

Install the CLI:

```bash
npm i -g @swarmclawai/swarmclaw
```

## Setup

1. Install: `npm i -g @swarmclawai/swarmclaw`
2. Set env var: `export SWARMCLAW_ACCESS_KEY=<your-key>` (shown in terminal on first run)
3. Default URL: `http://localhost:3456`, override with `SWARMCLAW_URL` or `--base-url`
4. Full docs: https://swarmclaw.ai/docs

## Output Modes

Use machine-readable output when parsing results:

- **`--json`**, structured JSON output (preferred for all API-mapped commands)
- **`--raw`**, plain text output (legacy commands)

Filter results with `--query key=value`:

```bash
swarmclaw tasks list --json --query status=in_progress
swarmclaw memory list --json --query agentId=abc123 --query q=pricing
swarmclaw runs list --json --query sessionId=xyz --query limit=10
```

## Core Commands

### Agents

Manage your agent fleet, create, configure, monitor, and clone agents.

```bash
# List all agents
swarmclaw agents list --json

# Get full agent details
swarmclaw agents get <agentId> --json

# Create an agent (pass JSON body via --data)
swarmclaw agents create --data '{"name":"Research Bot","provider":"anthropic","model":"claude-sonnet-4-20250514"}' --json

# Update agent config
swarmclaw agents update <agentId> --data '{"name":"Updated Name","soul":"You are a research assistant"}' --json

# Get live agent status (running chats, current task, etc.)
swarmclaw agents status <agentId> --json

# Clone an agent with all its config
swarmclaw agents clone <agentId> --json

The rest: https://github.com/swarmclawai/swarmclaw/blob/HEAD/swarmclaw/SKILL.md