edf9d0be6f
33 markdown files organized for GitBook import with SUMMARY.md navigation. Covers installation, core concepts, auto mode, configuration, all providers, cost management, skills, parallel orchestration, remote questions, teams, headless CI, and full command reference. User-facing only — no internal/dev content. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
44 lines
1.1 KiB
Markdown
44 lines
1.1 KiB
Markdown
# GitHub Sync
|
|
|
|
GSD can auto-sync milestones, slices, and tasks to GitHub Issues, PRs, and Milestones.
|
|
|
|
## Setup
|
|
|
|
1. Install and authenticate the `gh` CLI:
|
|
```bash
|
|
gh auth login
|
|
```
|
|
|
|
2. Enable in preferences:
|
|
```yaml
|
|
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
|
|
|
|
```yaml
|
|
github:
|
|
enabled: true
|
|
repo: "owner/repo"
|
|
labels: [gsd, auto-generated]
|
|
project: "Project ID" # optional: GitHub Project board
|
|
```
|