Connect
1
Start the connection
Go to the Connections page, or connect during onboarding. LivingContext requires either GitHub or GitLab before the app unlocks — you don’t need both.
2
Authorize with OAuth
You’re sent to GitLab to grant the
api and read_repository scopes.3
Enter your groups and projects
During onboarding, GitLab groups and projects are entered manually — type the group or project path rather than picking from a list.
What the connection powers
Tracked branches
As with GitHub, you can track branches of your code repositories so the commit updater drafts documentation updates for new commits — see Commits.Security
- OAuth tokens are encrypted at rest and refreshed automatically.
- Revoking the grant — from GitLab or from the Connections page — disconnects the integration immediately.
- Every write LivingContext makes is an ordinary commit or merge request in your project, fully visible in your GitLab history.
Working with multiple repos
As with GitHub, you can select more than one docs repository. The repo switcher controls which one repo-bound surfaces — Docs, Changelog, Commits, API Reference — display, and spaces group repositories into scopes for workspace-wide surfaces like Home and the Inbox.Troubleshooting
A project isn't found during onboarding
A project isn't found during onboarding
Double-check the full path (including the group, for example
my-group/my-project) and confirm the account you authorized has access to it. Manual entry means typos are the most common cause.Commits or merge requests are failing
Commits or merge requests are failing
Check the connection status on the Connections page. If the grant was revoked or expired, reconnect to restore access.
Only one Git provider is required. If you connect both GitHub and GitLab, each repository still belongs to exactly one provider — pick whichever hosts the repo in question.