hiivmind-pulse-gh

hiivmind-pulse-gh

A Claude Code plugin for deep GitHub automation — Projects v2, Milestones, Branch Protection, and more.

The Problem

GitHub's APIs are powerful but painful:

• GraphQL node IDs — Every operation needs opaque IDs like PVT_kwDOBx...
• Repeated lookups — "What's the ID for the Status field? What's the option ID for 'In Progress'?"
• Context amnesia — Each Claude session starts fresh, forgetting your org structure

The Solution

This plugin takes a discover-once, use-forever approach:

┌─────────────────────────────────────────────────────────────────┐
│  1. DISCOVER                                                     │
│     Init skill inspects your GitHub org structure               │
│     → Projects, fields, options, repositories, milestones       │
│                                                                  │
│  2. CACHE                                                        │
│     Store discovered IDs in .hiivmind/github/config.yaml        │
│     → Committed to git, shared with team                        │
│                                                                  │
│  3. USE                                                          │
│     Gateway command routes to appropriate skill                 │
│     → Natural language intent detection, corpus-backed syntax   │
└─────────────────────────────────────────────────────────────────┘

Installation

1. Install Prerequisites

Tool	Purpose	Install
gh	GitHub CLI	cli.github.com
jq	JSON processing	apt install jq / brew install jq
yq	YAML processing	github.com/mikefarah/yq

# Verify installation
gh auth status && jq --version && yq --version

# Ensure gh has required scopes
gh auth refresh -s read:project -s project -s repo

2. Install the Plugin

# Add the marketplace
/plugin marketplace add hiivmind/gh

# Install the plugin
/plugin install hiivmind-pulse-gh@hiivmind-pulse-gh

Run these commands in Claude Code (not in a terminal).

Gateway Command

The primary entry point for all GitHub operations:

/gh [describe what you want]

Examples

# Execute operations
/gh create issue for login timeout bug
/gh set milestone v2.0 on issue #42
/gh add PR to project
/gh protect main branch with required reviews
/gh trigger workflow ci.yml

# Discover capabilities
/gh discover
/gh what can I do with projects
/gh explore milestones
/gh help

How It Works

1. Intent Detection — Parses natural language to determine domain + operation + target
2. Context Check — Verifies workspace is initialized (if needed)
3. Confirmation — Asks before mutations
4. Execution — Routes to appropriate skill with corpus-backed API syntax

Interactive Menu

Run without arguments for a guided menu:

/gh

Discovery Mode

Explore available operations across all 26 GitHub domains:

/gh discover

What you get:

1. Quick Reference Table — All domains with their API support (CLI, REST, GraphQL)
2. Domain Drill-Down — Select a domain to see its full operation matrix
3. CLI Commands — Ready-to-use gh commands for each operation
4. Handoff to Execute — When ready, seamlessly transition to the operations skill

Example session:

You: /gh discover

Claude: === GitHub Operations Quick Reference ===

        | Domain          | gh CLI | REST | GraphQL | Notes                    |
        |-----------------|--------|------|---------|--------------------------|
        | Issues          | ✓      | ✓    | ✓       | Full CRUD via all methods|
        | Pull Requests   | ✓      | ✓    | ✓       | Full CRUD via all methods|
        | Projects v2     | ✓      | Read | ✓       | Views UI-only            |
        | Milestones      | ✗      | ✓    | Read    | CRUD via REST            |
        ... [26 domains total]

        Which domain would you like to explore?

You: Projects v2

Claude: === Projects v2 Domain ===

        | Operation        | gh CLI | REST | GraphQL | Notes                   |
        |------------------|--------|------|---------|-------------------------|
        | Add item         | ✓      | ✗    | ✓       | addProjectV2ItemById    |
        | Update field     | ✓      | ✗    | ✓       | updateProjectV2ItemField|
        | Archive item     | ✓      | ✗    | ✓       |                         |
        ...

        CLI Commands:
        | Operation   | Command                                              |
        |-------------|------------------------------------------------------|
        | Add item    | gh project item-add {number} --owner {o} --url {url} |
        | Edit field  | gh project item-edit --id {id} --field-id {f} ...    |

        What would you like to do?
        1. Execute an operation now
        2. Explore another domain
        3. Done