sync-pull

star 2

Pull changes from GitHub Project board into local taskboard. Syncs subtasks, description, priority, and re-links tickets by ULID metadata.

Tristan578 By Tristan578 schedule Updated 3/5/2026

name: sync-pull description: "Pull changes from GitHub Project board into local taskboard. Syncs subtasks, description, priority, and re-links tickets by ULID metadata."

/sync-pull — Pull GitHub Project to Local Taskboard

Pull changes from the GitHub Project board (SpawnForge #2) into the local taskboard.

Commands

# Pull changes from GitHub
cd project-forge && python3 .claude/hooks/github_project_sync.py pull

# Check sync status
cd project-forge && python3 .claude/hooks/github_project_sync.py status

V2 Bidirectional Sync

Pull handles full ticket content from GitHub (not just status):

  • Subtask sync: Parses - [ ]/- [x] checkboxes from GitHub body, creates/updates local subtasks
  • Body sync: Detects description/priority changes via bodyHash, updates local ticket
  • Re-linking: If a mapping entry is lost, re-links tickets by ULID from <!-- SPAWNFORGE_METADATA --> block — no duplicates
  • Backward compat: Still parses v1 format (**Taskboard:** PF-N (ULID)) for old tickets

When to Use

  • At the start of every work session
  • After another contributor has updated tickets on GitHub
  • After modifying subtask checkboxes directly on GitHub

Prerequisites

  • gh CLI authenticated
  • Taskboard API running on port 3010
  • Python 3 available
Install via CLI
npx skills add https://github.com/Tristan578/project-forge --skill sync-pull
Repository Details
star Stars 2
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator