Connecting GitHub to Calmo

Calmo integrates with GitHub to help you track repository activities, investigate code issues, and perform root cause analysis directly from your Slack workspace. This guide will walk you through the process of connecting your GitHub account to Calmo.

Prerequisites

A GitHub account with access to your repositories
A Calmo account

Generating a GitHub Personal Access Token (PAT)

To connect GitHub to Calmo, you’ll need to generate a Personal Access Token (PAT) with read-only permissions. Follow these steps:

Log in to your GitHub account
Navigate to Settings by clicking on your profile icon in the top right corner
Scroll down to the Developer settings section in the left sidebar
Select Personal access tokens and then Tokens (classic)
Click the Generate new token button and select Generate new token (classic)
Provide a descriptive name for your token (e.g., “Calmo Integration”)
Set an expiration date according to your organization’s security policies
Select the following read-only permissions:
- repo:status - Access commit status
- repo_deployment - Access deployment status
- public_repo - Access public repositories
- repo:read - Read access to code
- read:org - Read organization data
Click Generate token
Copy the generated token immediately (you won’t be able to see it again)

Data Synced from GitHub to Calmo

When you connect GitHub to Calmo, the integration fetches the following data:

Repositories - Information about your repositories, including names, descriptions, and metadata
Pull Requests - Status and details of open and recently closed pull requests
Issues - Open and recently closed issues from your repositories
Commits - Recent commit history and changes
Deployments - Information about recent deployments and their status

This data enables Calmo to provide comprehensive code analysis and investigation capabilities directly within your Slack workspace, without requiring you to switch contexts to the GitHub interface.