swarm-cli

Coordinate multi-agent workflows via CLI with memory, task, and messaging commands.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/ImBIOS/swarm-tools --skill swarm-cli-imbios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swarm-cli
Source: https://github.com/ImBIOS/swarm-tools/tree/main/packages/opencode-swarm-plugin/claude-plugin/skills/swarm-cli
Command: npx skills add https://github.com/ImBIOS/swarm-tools --skill swarm-cli-imbios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinates multi-agent workflows by providing a CLI to manage hivemind memory, hive task tracking, and swarm mail coordination, reducing context switching and coordination gaps.

Core Features & Use Cases

  • Memory (Hivemind): store, query, and retrieve learnings to inform future actions.
  • Hive: create, query, close tasks; visualize task trees; manage parallel work.
  • Swarm Mail: reserve, send, and coordinate messages and file checkpoints between agents.
  • Progress & Checkpoints: track milestones and save context before risky operations.
  • Analytics: monitor tool usage and swarm activity to improve workflows.

Quick Start

Initialize the swarm CLI in your project and run your first swarm task.

Frequently Asked Questions about swarm-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multi-agent workflows with persistent memory and task tracking?

You coordinate multi-agent workflows by using a CLI to manage hivemind memory, track task lifecycles, and coordinate inter-agent messaging. This reduces context switching and fills coordination gaps between parallel workers.

What is swarm mail coordination and how does it manage file reservations between agents?

Swarm mail coordination is a CLI mechanism to reserve, send, and coordinate messages and file checkpoints between agents. It ensures parallel workers can safely save context and manage file access without conflicts.

How do I track task lifecycles and visualize task trees for parallel work?

You track task lifecycles by using CLI commands to create, query, and close tasks while visualizing task trees. This manages parallel work by maintaining structured task hierarchies and monitoring progress milestones.

Can I store and retrieve learnings to inform future actions in a multi-agent context?

Yes, you can store, query, and retrieve learnings using the hivemind memory feature. It provides local persistence to inform future actions and reduce repetitive context switching across coordinated swarm tasks.

Does this CLI require any external dependencies or components to manage swarm tasks?

No external dependencies or components are required to manage swarm tasks. The CLI operates independently with local persistence and basic input validation for memory lookup, task tracking, and messaging.

What are the limitations of using a CLI for inter-agent messaging and task coordination?

The CLI provides basic input validation and local persistence, meaning coordination relies on local data flows rather than distributed network protocols. It is designed for swarm contexts needing persistent memory and file reservations rather than real-time remote synchronization.