GitHub Integration

The GitHub integration syncs markdown files from your repositories into the Workestra Knowledge Base, keeping your internal docs up to date automatically.

Setup

1. Go to Knowledge Base → Settings → GitHub
2. Click Connect GitHub
3. Authorize the Workestra GitHub App
4. Select repositories to sync

How It Works

1. Initial sync — All markdown files from selected repos are imported
2. Webhook updates — Push events trigger incremental syncs
3. AI indexing — Imported documents are embedded for semantic search

Configuration

Repository Selection

Choose specific repositories and branches to sync. You can sync from multiple repos.

Path Filtering

Optionally restrict sync to specific directories (e.g., only /docs folder).

Branch Selection

Select which branch to sync from (defaults to the repository's default branch).

Automatic Updates

When you push changes to a synced repository:

1. GitHub sends a webhook to Workestra
2. Changed files are re-imported
3. AI embeddings are updated
4. Search index reflects the latest content

No manual intervention needed — your Knowledge Base stays current with your codebase.