gitbutler-workflow

Coordinate parallel agent work using virtual branches with JSON status outputs.

1|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/Abstract-Data/mediaite-ghostink --skill gitbutler-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitbutler-workflow
Source: https://github.com/Abstract-Data/mediaite-ghostink/tree/main/.cursor/skills/gitbutler-workflow
Command: npx skills add https://github.com/Abstract-Data/mediaite-ghostink --skill gitbutler-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate parallel agent work within a single working directory by using virtual branches so multiple tasks can progress without duplicating environments or clashing changes.

Core Features & Use Cases

  • Notion-guided playbook that adds parallel-agent framing on top of the core GitButler CLI, enabling JSON-status workflows (--json --status-after) and per-file branch assignments.
  • Supports multiple agents operating in one directory, with commits directed to virtual branches to avoid conflicts and to clearly organize work on different files.

Quick Start

Use the gitbutler workflow to enable parallel-agent play by creating virtual branches in a single working directory and viewing structured JSON status.

Frequently Asked Questions about gitbutler-workflow

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

FAQPage Schema
How do I coordinate parallel agents working in the same git repository without conflicts?

To coordinate parallel agents in a single repository without conflicts, you can use virtual branches to direct agent commits to isolated streams. This allows multiple tasks to progress in one working directory without duplicating environments or clashing changes.

How do I get machine-readable status outputs for parallel agent workflows?

You can get machine-readable status outputs for parallel agent workflows by using the JSON-status workflow commands. This provides structured, JSON-based status reporting to track the progress of multiple agents operating within a single project directory.

Can I assign multiple agents to modify different files in the same directory?

Yes, multiple agents can modify different files in the same working directory. By applying per-file branch assignments, commits are directed to specific virtual branches to clearly organize work and avoid conflicts between agents.

Do I need a specific playbook to run parallel agent tasks with virtual branches?

You need a Notion-guided playbook to run parallel agent tasks with virtual branches. This playbook adds parallel-agent framing on top of the core GitButler CLI, ensuring alignment with Notion guidance while enabling JSON status workflows.

What is the best way to organize commits from multiple AI agents in one project?

The best way to organize commits from multiple AI agents in one project is by using virtual branches. This approach directs commits to separate virtual branches based on file assignments, preventing clashes and organizing work clearly.

Why does running multiple agents in a single working directory cause environment duplication?

Running multiple agents in a single working directory causes environment duplication when virtual branches are not used. By applying virtual branches, multiple tasks can progress in one directory, eliminating the need to duplicate environments.