Skip to main content

Code Repositories

Connect the repository that holds your app's code and Shipbook's AI features become code-aware:

  • LogChat reads your actual source code, so when a log points at a file and line it can open that code and explain what went wrong — not just what the log says.
  • Loglytics issues get an AI Analysis: where the issue is in your code (with a direct link to the file and line), the root cause, and a suggested fix.
  • Automatic alerts include that analysis in the alert email, Slack message, and webhook payload — so the fix suggestion arrives together with the alert.

Supported providers​

  • GitHub — available now.
  • GitLab — coming soon.
  • Bitbucket — coming soon.

Connecting GitHub​

  1. Go to Preferences → Code Repositories and select Connect GitHub.
  2. GitHub will ask you to install the Shipbook app on your organization or user account. Choose the repositories you want Shipbook to access — you can limit it to just the repositories that hold your app code.
  3. After installing, the page shows the connected GitHub account.

Only account owners and admins can connect or disconnect a repository provider.

Mapping apps to repositories​

Once connected, each Shipbook app can be mapped to the repository (and branch) that holds its source code. Use the repository dropdown next to each app to pick its repository — the default branch is selected automatically, and you can change it with the branch dropdown.

The AI features only activate for apps that have a repository mapped.

Release tracking​

Mapping does more than power the AI: when you publish a GitHub release on a mapped repository, Shipbook records it automatically — the release appears on the app's Releases page with the exact publish time, tag, and a link back to GitHub, and becomes a deploy marker on the Bridge graphs. A leading v in the tag is stripped, so tag v2.4.0 matches app version 2.4.0.

What Shipbook accesses​

Shipbook reads repository content on demand — when a LogChat conversation or an issue analysis needs to look at your code. Nothing is cloned or stored; the AI fetches only the specific files it needs to understand an issue.

Disconnecting​

Select the trash icon next to the connected account to disconnect. You can also uninstall the Shipbook app from GitHub's side (GitHub → Settings → Applications) — Shipbook detects the uninstall and removes the integration automatically.