gitbutler-cli

Claude Code Tools

A multi-plugin marketplace for Claude Code with Git workflow skills and comprehensive documentation for skill development.

What's Included

Plugins

This marketplace includes two plugins:

Core Plugin

Purpose: Shared base plugin with Git fundamentals and common utilities

Location: core/

Includes:

• git-fundamentals skill: Essential Git knowledge (repositories, commits, branches, workflows)
• Best practices for commits and collaboration
• Foundation for advanced Git tools

When Claude uses this:

• User asks about basic Git operations
• Need to explain Git fundamentals
• Teaching version control concepts

GitButler CLI Plugin

Purpose: Advanced Git workflows with virtual branches and operation history

Location: gitbutler-cli/

Includes:

• gitbutler-cli skill: Complete GitButler CLI command reference
• Common workflow patterns
• Progressive documentation (core concepts → detailed reference)
• Safe operation guidance with undo support

Features:

• Virtual branch management - multiple branches active simultaneously
• Operation history - complete undo/redo capability
• Stack operations - commit management, squashing, moving
• Safe operations - every action is reversible

When Claude uses this:

• User mentions "GitButler", "but command", or "virtual branches"
• Working with multiple features simultaneously
• Managing stacked commits
• Need safe Git operations with undo capability

Dependencies: Requires core plugin (automatically installed)

Documentation

AI Documentation (ai_docs/)

Extracted documentation optimized for AI context:

• Claude Code Skill Specifications (ai_docs/claude-code/)

  • Complete guide to writing Claude Code skills
  • YAML frontmatter requirements
  • Best practices for skill development

• GitButler Documentation (ai_docs/gitbutler/)

  • GitButler concepts and workflows
  • Complete CLI command reference
  • Use cases and comparisons with traditional Git

Quick Start

# 1. Add the marketplace
/plugin marketplace add amitkot/claude-code-tools

# 2. Install plugins (gitbutler-cli automatically installs core)
/plugin install gitbutler-cli@claude-code-tools

# 3. Start using them!
# Ask Claude: "Can you help me with GitButler?"
# Ask Claude: "Explain Git branches to me"

Installation

Prerequisites

1. Claude Code - Anthropic's official CLI for Claude (Get Claude Code)

2. GitButler CLI (for GitButler skill) - Install from gitbutlerapp/gitbutler

Public Readiness

Before changing repository visibility or publishing a release, run the local audit:

pre-commit run --all-files
just audit-public
gitleaks detect --source . --redact --no-banner
git status --short --ignored

The public-readiness gate targets the current tree and future commits. Repository history is not rewritten.

Installing Plugins

Option 1: Via Plugin Marketplace (Recommended)

The easiest way to install and keep plugins updated:

# Add this marketplace
/plugin marketplace add amitkot/claude-code-tools

# Install GitButler CLI plugin (automatically installs core)
/plugin install gitbutler-cli@claude-code-tools

# Or install individual plugins
/plugin install core@claude-code-tools
/plugin install gitbutler-cli@claude-code-tools

# Later, update to the latest versions
/plugin update gitbutler-cli
/plugin update core

# List installed plugins
/plugin list

Plugins will be automatically available in all your Claude Code sessions.

Benefits:

• One-command installation
• Automatic dependency management (core installed with gitbutler-cli)
• Easy updates with /plugin update
• Easy removal with /plugin remove
• Version management built-in

Option 2: Manual Installation

If you prefer manual installation, you can copy the skill directly:

# Create skills directory
mkdir -p ~/.claude/skills

# Copy plugins
cp -r core/skills/* ~/.claude/skills/
cp -r gitbutler-cli/skills/* ~/.claude/skills/

# Verify installation
ls ~/.claude/skills/git-fundamentals
ls ~/.claude/skills/gitbutler-cli

# Navigate to your project
cd /path/to/your/project

# Create skills directory
mkdir -p .claude/skills

# Copy plugins
cp -r /path/to/claude-code-tools/core/skills/* .claude/skills/
cp -r /path/to/claude-code-tools/gitbutler-cli/skills/* .claude/skills/

# Verify installation
ls .claude/skills/

Verification

Test that Claude Code recognizes the skills:

1. Start Claude Code in a terminal
2. Ask: "Can you help me with GitButler?" → Should use gitbutler-cli skill
3. Ask: "Explain Git branches to me" → Should use git-fundamentals skill

Using the Skills