GitHub integration
Install the Stractal GitHub App, manage repository access, and understand sync behavior
Stractal connects to your repositories through a GitHub App with read-only access.
Installing the GitHub App
Go to Connections, click Add connection, and authorize the Stractal GitHub App on GitHub. Select which repositories to grant access to — specific repositories or all repositories in an account.
If you sign in with GitHub OAuth, your account is connected automatically. You can still add additional GitHub accounts from the Connections page.
Permissions
| Permission | Level | Purpose |
|---|---|---|
| Repository contents | Read | Read source code for Wiki synthesis |
| Repository metadata | Read | List repositories, branches, and file structure |
Stractal never pushes commits, opens pull requests, or modifies your code.
Managing access
Modify repository access anytime from GitHub > Settings > Applications > Stractal > Configure. To disconnect an account, click the disconnect button on the Connections page.
Disconnecting does not delete projects or Wikis. Existing data is preserved, but you cannot re-synthesize until the connection is restored.
Multiple GitHub accounts
You can connect more than one GitHub account — useful if you have separate personal and organization accounts. Each connection appears independently on the Connections page, and repositories from all connected accounts are available when creating projects.
Organization access
Organization owners can install the app for the entire organization. Non-owners can request approval through GitHub's approval flow. Once approved, organization repositories become available for project creation by all team members.
What Stractal reads
During synthesis, Stractal reads:
- Source code files — analyzed for domain extraction, dependency graphs, and code semantics
- Dependency files —
package.json,tsconfig.json,go.mod,requirements.txt, and similar manifests - Framework configs — build and framework configuration files relevant to understanding project structure
Stractal does not read .env files, secrets, git history, or PR/issue content.
File inclusion settings
You can control which files are included in synthesis from Project settings > Inclusion:
- Global patterns — apply to all repositories in the project. Use glob patterns to exclude directories like
node_modules/,dist/, or test fixtures. - Per-repository overrides — for multi-repo projects, set different inclusion patterns and branch selections for individual repositories.
Changes to inclusion settings take effect on the next synthesis run.
Multi-repository projects
A single project can include multiple repositories. This is useful for monorepos with separate packages or for systems split across multiple repos. Each repository's domains are analyzed independently and merged into a unified Wiki, with cross-repository dependencies captured in the domain hierarchy.