Sabaki Guide
GitHub Project Evidence Setup In Sabaki
How to connect GitHub repositories so Sabaki can preserve repository and commit evidence.
GitHub project evidence sync is the Sabaki workflow for reading permitted repositories and recent commits, then storing them as evidence items instead of KPI snapshots.
Key Takeaways
- GitHub is evidence-oriented in Sabaki; it does not currently write KPI rows.
- Sabaki can connect with a personal access token or GitHub App installation credentials.
- Repository and commit evidence can support Advisor answers, readiness work, and source-backed company context.
How To Sync GitHub Evidence
- Choose the credential typeUse a personal access token or GitHub App installation credentials with access to the relevant repositories.
- Connect GitHub in SabakiOpen Apps, choose GitHub, and paste the credential in the expected format.
- Run Sync NowSync up to the current repository and commit evidence set.
- Review evidenceUse Advisor or source-backed views to inspect repository and commit evidence.
- Rotate credentials deliberatelyReconnect GitHub if the token or GitHub App installation changes.
Quick Comparison
| Synced Item | Source | Where It Appears |
|---|---|---|
| Repository evidence | Permitted GitHub repositories | Source-backed project and company context |
| Commit evidence | Recent commits per repository | Source-backed technical progress evidence |
| Sync cursor | Repository count and auth mode | Connection sync status |
Frequently Asked Questions
Does GitHub update KPIs?
No. The current GitHub connection stores evidence items rather than KPI snapshots.
How many repositories are synced?
Sabaki caps the sync to a bounded repository set and recent commits so the connection stays manageable.
Can I use a GitHub App?
Yes. The connector supports GitHub App credentials when app ID, installation ID, and private key are provided.
What should GitHub evidence be used for?
Use it to support product progress, technical readiness, and Advisor answers that need source-backed repository context.