singularity-forge/gitbook/features/github-sync.md
ace-pm 35dc87ef53 chore: sync workspace state after rebrand
- Rebrand commits already in history (gsd → forge)
- Sync pre-existing doc, docker, and CI config updates
- All rebrand artifacts verified in place:
  * Native crates: forge-engine, forge-ast, forge-grep
  * Log prefixes: [forge] across 22+ files
  * Binary: ~/bin/sf-run
  * Workspace scopes: @sf-run/*, @singularity-forge/*
  * Nix flake: Rust toolchain ready

System ready for: nix develop && bun run build:native

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:54:20 +02:00

1.1 KiB

GitHub Sync

SF can auto-sync milestones, slices, and tasks to GitHub Issues, PRs, and Milestones.

Setup

  1. Install and authenticate the gh CLI:

    gh auth login
    
  2. Enable in preferences:

    github:
      enabled: true
      repo: "owner/repo"              # auto-detected from git remote if omitted
      labels: [gsd, auto-generated]   # labels for created items
    

Commands

Command Description
/github-sync bootstrap Initial setup — creates GitHub Milestones, Issues, and draft PRs from current .gsd/ state
/github-sync status Show sync mapping counts (milestones, slices, tasks)

How It Works

  • Milestones → GitHub Milestones
  • Slices → GitHub Issues (linked to milestone)
  • Tasks → GitHub Issue checklists
  • Completed slices → Draft PRs

Sync mapping is persisted in .gsd/.github-sync.json. The sync is rate-limit aware — it skips when the GitHub API rate limit is low.

Configuration

github:
  enabled: true
  repo: "owner/repo"
  labels: [gsd, auto-generated]
  project: "Project ID"           # optional: GitHub Project board