title: GitHub App Setup description: Install the dkod GitHub App on your org, select repos, and configure webhooks.

GitHub App Setup

The dkod GitHub App enables the team dashboard by indexing session refs across your org's repositories.

Prerequisites

• An org admin role on your GitHub organization
• At least one repo with dkod session refs (refs/dkod/*)

Install the GitHub App

1. Visit the dkod GitHub App page (link available when the team dashboard launches)
2. Click Install
3. Select your organization
4. Choose which repositories to grant access to — you can select all repos or specific ones
5. Confirm the installation

Permissions

The dkod GitHub App requests minimal permissions:

The app never writes to your repositories.

How indexing works

1. The app subscribes to push webhooks on selected repos
2. When a push includes new refs/dkod/* refs, the indexer fetches the session metadata
3. Metadata, prompt summary, and embeddings are stored in the index
4. Full transcript content is not stored — it's fetched live when a user opens a session

Adding or removing repos

You can change which repos the app has access to at any time:

1. Go to your org's Settings → Integrations → GitHub Apps
2. Click Configure next to dkod
3. Update the repository access

Changes take effect immediately. Newly added repos will be indexed on the next push.

Uninstalling

Uninstalling the GitHub App removes all indexed metadata for your org. Session data in your repos is unaffected — it's just git refs.