hive-workflow

Track and manage work items with git-backed hive commands.

729|67|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/joelhooks/swarm-tools --skill hive-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hive-workflow
Source: https://github.com/joelhooks/swarm-tools/tree/main/packages/opencode-swarm-plugin/examples/skill/hive-workflow
Command: npx skills add https://github.com/joelhooks/swarm-tools --skill hive-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hive provides a local-first issue tracking and task management approach to keep AI agents and humans aligned, reducing context switching and coordination drift across tasks and teams.

Core Features & Use Cases

  • Open, update, and close work items (bugs, features, tasks, epics) using hive commands
  • Coordinate across multiple agents with a git-backed task board and Swarm Mail
  • Query and manage the lifecycle of cells with hive_create, hive_query, hive_update, hive_close, hive_create_epic
  • Sync changes with hive_sync to maintain a consistent, collaborative history

Quick Start

Initialize the hive in your project, then create an epic or a task to begin tracking work. Use hive_create_epic to define a large initiative, add subtasks with hive_create, move items through states (open → in_progress → closed) with hive_update/hive_close, and finally run hive_sync to propagate changes to the shared history.

Frequently Asked Questions about hive-workflow

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

FAQPage Schema
How do I track work items and tasks across distributed AI agents?

You can track work items across distributed agents using a local-first hive system with git-backed persistence. It coordinates the creation, updating, and tracking of bugs, features, tasks, and epics via Swarm Mail to keep agents aligned.

What is the best way to coordinate epics and subtasks for local-first project management?

The best way to coordinate epics and subtasks locally is using hive commands. Define large initiatives with hive_create_epic, add subtasks with hive_create, and move items through states like open, in_progress, and closed using hive_update and hive_close.

How does git-backed task synchronization work for multi-agent coordination?

Git-backed task synchronization works by running hive_sync to propagate work item changes to a shared collaborative history. This maintains a consistent task board across multiple agents and reduces context switching.

Can I manage the lifecycle of bugs and features without relying on a centralized tracking server?

Yes, you can manage the lifecycle of bugs and features without a centralized server. This local-first tracking system uses hive_query to find items and hive_close to resolve them, storing all task data locally with git-backed persistence.

Do I need Swarm Mail to coordinate task updates across distributed agents?

Swarm Mail is used to coordinate task updates and reduce coordination drift across distributed agents. It works alongside the local hive commands to keep AI agents and humans aligned without requiring a centralized server.