Skip to main content
The GitHub integration is Kasava’s most comprehensive integration, enabling repository indexing, issue management, commit analysis, and Projects V2 sync. GitHub serves as the foundation for Kasava’s code intelligence features.

​
Capabilities

FeatureDescription
Repository IndexingIndex code for semantic search and AI chat
Issues & PRsSync issues and pull requests to Products
Projects V2Sync GitHub Projects boards with Kanban view
CommitsAI-powered semantic analysis of commit history
WebhooksReal-time updates on changes
Code IntelligenceAST parsing, symbol extraction, and semantic search

​
Connecting GitHub

GitHub connection is handled through the GitHub App installation flow, which differs from other OAuth-based integrations.
1

Navigate to Integrations

Go to Settings > Integrations in the sidebarSettings menu with Integrations highlighted
2

Find GitHub Issues

In the Task Management section, locate the GitHub Issues integration cardGitHub Issues integration card
3

Click Connect

Click the green Connect button to begin the GitHub App installation
4

Select Account

Choose whether to install for your personal account or an organization you administer
5

Choose Repositories

Select All repositories or Only select repositories to control accessGitHub repository selection screen
6

Complete Installation

Click Install to finish. You’ll be redirected back to Kasava.

​
Repository Access Options

When installing the GitHub App, you can choose your access level:

​
All Repositories

Grants Kasava access to all current and future repositories in your account or organization. Best for:
  • Full organization adoption
  • Automatic access to new repositories
  • Simplified management

​
Select Repositories

Choose specific repositories for Kasava to access. Best for:
  • Trying Kasava with a few repositories first
  • Restricting access to specific projects
  • Compliance requirements
You can update repository access anytime in GitHub Settings > Applications > Kasava.

​
Multiple GitHub Installations

Kasava supports connecting multiple GitHub App installations, allowing you to access repositories from different GitHub accounts or organizations within a single Kasava organization.

​
Adding Additional Installations

1

Go to Settings > Integrations

Navigate to the integrations settings page
2

Click Add Installation

If GitHub is already connected, click Add GitHub Installation to connect another account
3

Select New Account

Choose a different GitHub account or organization to install
4

Grant Access

Select repositories and complete the installation
Multi-installation support is useful for agencies managing multiple clients, or organizations with separate GitHub accounts for different projects.

​
Managing Repositories

Once the GitHub App is connected, manage your repositories from Settings > Repositories. Settings navigation with Repositories highlighted

​
Repository List

The Repositories page displays a split-view interface:
  • Left panel - List of all connected repositories with search and filter
  • Right panel - Quick overview of the selected repository showing sync status, default branch, and indexing status
Repositories settings page with list and overview panels

​
Adding Repositories from GitHub App

Click Manage Repositories to import repositories that the GitHub App has access to:
1

Open Manage Repositories

From Settings > Repositories, click the Manage Repositories button
2

Select Repositories

Check the repositories you want to import. Repositories are sorted by creation date with newest first.Manage Repositories dialog with repository checkboxes
3

Apply Changes

Click Apply Changes to import the selected repositories. You can import multiple repositories at once.
Only repositories that the GitHub App has access to will appear in the list. To add more repositories, click Update GitHub Settings to modify access in GitHub Settings > Applications > Kasava.

​
Importing Public Repositories

Import any public GitHub repository without needing GitHub App access - useful for exploring open source projects:
1

Click Import Public Repo

From Settings > Repositories, click the Import Public Repo button
2

Enter Repository Details

Enter the repository in one of these formats:
  • Full URL: https://github.com/facebook/react
  • Owner/repo format: facebook/react Import Public Repository dialog
3

Configure Options

  • Branch (optional) - Specify a branch or leave empty to use the default branch
  • Start indexing immediately - Enable to begin code indexing right after import
4

Import

Click Import Repository to add the public repository
Public repositories sync manually without real-time webhook updates. Use the Sync button on the repository overview to pull the latest changes whenever needed.

​
Removing Repositories

To remove a repository from Kasava:
  1. Click Manage Repositories
  2. Uncheck the repository you want to remove
  3. Click Apply Changes
  4. Confirm the removal when prompted

​
Repository Detail Page

Click View Details on any repository from the overview panel to access the full repository page with detailed information and management options.

​
Overview Tab

The Overview tab displays key repository information:
InformationDescription
Default BranchThe primary branch for the repository
Last SyncWhen data was last synchronized from GitHub
Index StatusCurrent indexing progress and number of files indexed
DescriptionRepository description from GitHub

​
Documents Tab

View and configure auto-generated documentation:
  • Browse generated documentation files
  • Configure documentation generation settings
  • Set up triggers and filters for automatic updates

​
Insights Tab

AI-generated insights about your codebase:
  • Code quality observations
  • Architecture recommendations
  • Trends and patterns detected

​
Activity Tab

View commits and pull requests with AI-powered analysis:
  • Commit Type Detection - Automatic categorization (feat, fix, refactor, etc.)
  • Impact Assessment - High, Medium, or Low impact rating
  • Business Value - AI-assessed business impact
  • Filter by date range, authors, or commit type

​
Logs Tab

View synchronization and system logs:
  • Sync events and their status
  • Indexing progress
  • Any errors that occurred

​
Settings Tab

Configure repository-specific settings:
  • Enable or disable code indexing
  • Manage sync preferences
  • Configure branch settings

​
Code Indexing

Index repositories to enable powerful AI features:
  • Semantic Code Search - Search code by meaning, not just keywords
  • AI Chat - Ask questions about your codebase and get intelligent answers
  • Symbol Navigation - Jump to function definitions, class declarations, and more
To enable indexing for a repository:
  1. Go to Settings > Repositories
  2. Select a repository from the list
  3. Click View Details to open the repository page
  4. Navigate to the Settings tab
  5. Enable code indexing
See Code Intelligence for details on what indexing enables.

​
Issues & Pull Requests

Sync GitHub issues and pull requests to your Kasava Products for unified project management.
1

Create or Open a Product

Navigate to an existing Product or create a new one
2

Link GitHub Repository

In Product settings, click to link a GitHub repository
3

Select Repository

Choose from your connected repositories
4

Enable Issue Sync

Toggle on issue and PR syncing in the configuration

​
Issue Features

Once synced, you can:
  • View issue details, descriptions, and comments
  • See and update assignees and labels
  • Track issue status (open/closed)
  • Link issues to Plans and other Kasava entities

​
Pull Request Features

  • View PR status, reviewers, and approval status
  • See linked issues for each PR
  • Check CI/CD status
  • View merge status and conflicts

​
GitHub Projects V2

Link GitHub Projects V2 boards to Kasava Products for enhanced Kanban management.
1

Open Product Settings

Navigate to your Product and click the settings icon
2

Link GitHub Project

In the external projects section, click Link GitHub Project
3

Select Project

Choose from available GitHub Projects V2 in your connected repositoriesGitHub Project selection dropdown
4

Configure Mapping

Kasava automatically maps Status fields to Kanban columns

​
Kanban Board

Once linked, your Product’s Kanban view shows issues organized by GitHub Project status:
  • Drag and drop issues between columns to update their status
  • Changes sync back to GitHub Projects in real-time
  • View issues from multiple platforms side-by-side

​
Field Mapping

GitHub FieldKasava Field
StatusKanban column
AssigneesAssignees
LabelsLabels
MilestoneSprint/Iteration

​
Commit Analysis

Kasava uses AI to analyze commits and extract valuable insights:

​
Commit Type Detection

Automatically categorizes commits:
  • feat - New feature
  • fix - Bug fix
  • refactor - Code restructuring
  • docs - Documentation changes
  • test - Test additions or modifications
  • chore - Maintenance tasks

​
Impact Assessment

Each commit is rated for impact:
  • High - Breaking changes, major features
  • Medium - Notable improvements, significant fixes
  • Low - Minor changes, small fixes

​
Additional Analysis

  • Complexity Score - Estimated complexity based on files changed and diff size
  • Business Value - AI-assessed business impact of the change
  • Component Detection - Which parts of your system are affected

​
Personalized Analysis with AI Learning

Commit analysis automatically applies your AI Learning patterns. When you correct how the AI categorizes commits:
  • Future commits are classified according to your preferences
  • File path patterns you’ve defined are respected
  • Your terminology preferences are used in descriptions
  • Severity thresholds match your standards
For example, if you’ve taught Kasava that commits to src/core/** should be classified as “high impact” rather than “medium”, all future commits to that path will follow your preference.
If a commit is miscategorized, correct it from the Activity tab. Over time, Kasava learns your project’s conventions and improves automatically.
View commit analytics in the Analytics section of your repository.

​
@kasava Commands in Issues

Use @kasava mentions in GitHub issue comments to trigger AI-powered actions directly from your workflow. This feature lets team members request summaries, generate documentation, and perform analysis without leaving GitHub.

​
How It Works

  1. Comment on any GitHub issue with @kasava followed by a command
  2. Kasava detects the mention via webhooks
  3. The AI processes your request using the issue context
  4. Results are posted as a reply comment on the issue

​
Built-in Commands

CommandDescription
@kasava summarizeSummarize the issue discussion and key decisions
@kasava documentGenerate documentation from the issue content
@kasava planCreate an implementation plan for the issue
@kasava design-docGenerate a design document
@kasava prototypeCreate a prototype spec from requirements
@kasava diagnoseAnalyze and diagnose the problem described
@kasava postmortemGenerate a postmortem analysis
@kasava insightsExtract key insights from the discussion
@kasava changelogGenerate changelog entries
@kasava reportCreate a status report
@kasava review-prepPrepare materials for a review meeting
@kasava relatedFind related issues in your repositories
@kasava impactAnalyze the potential impact of changes
@kasava linkSuggest links to relevant resources
@kasava sync-statusCheck synchronization status

​
Command Arguments

Commands support natural language arguments to filter or customize the output: Filter by recent comments: 
@kasava summarize last 5 comments
@kasava summarize last 10 comments
Filter by date range: 
@kasava summarize since last week
@kasava summarize since 3 days ago
@kasava summarize since 2025-01-15
Filter by participants: 
@kasava summarize between @alice and @bob
@kasava summarize by @charlie
Filter by mentions: 
@kasava summarize mentioning @security-team
Combine filters: 
@kasava summarize last 10 comments by @alice since last week

​
Multiple Commands

You can trigger multiple commands in a single comment: 
@kasava summarize
@kasava plan
Both commands will be processed and their results posted.

​
Asking Questions

If you mention @kasava without a recognized command, it routes to the AI chat agent. You can ask free-form questions about the issue: 
@kasava what are the main blockers here?
@kasava can you explain the proposed solution?

​
Custom Commands

Organizations can create custom action types in Settings > Templates > Action Types. Custom commands extend the built-in set with organization-specific workflows. Once created, custom commands work just like built-in ones: 
@kasava my-custom-action
See Settings for information on creating custom action types.

​
Authorization

By default, only organization members can use @kasava commands. Administrators can enable external collaborators in Settings > Integrations > Permissions.
User TypeDefault Access
Organization members✅ Allowed
External collaborators❌ Requires admin permission
To enable external collaborators:
  1. Go to Settings > Integrations
  2. Find Permission Settings
  3. Enable Allow External Collaborators
This setting can also be configured per-repository.
Use @kasava commands in long issue threads to quickly catch up on discussions without reading every comment.

​
Historical Sync

Sync and analyze your repository’s history:

​
Commit History Sync

1

Open Repository

Navigate to the repository you want to sync
2

Go to Settings

Click the repository settings
3

Enable Historical Sync

Turn on historical commit sync and select a date range
4

Monitor Progress

Watch the sync progress in the repository dashboard
Historical sync provides:
  • Commit trends over time
  • Author contribution patterns
  • Change frequency analysis
  • Complete project history

​
Troubleshooting

Check that you’ve granted access to the repository during GitHub App installation. Go to GitHub Settings > Applications > Kasava to update repository access.
Verify that:
  1. The repository is linked to your Product
  2. Issue sync is enabled in Product settings
  3. The GitHub integration shows as connected
Large repositories may take longer to index. Check the sync status in the repository dashboard. If stuck, try clicking “Retry” to restart the indexing process.
You may need to request or grant organization access. In GitHub, go to Settings > Applications > Kasava and click “Request” or “Grant” next to the organization name.

​
Permissions

The Kasava GitHub App requests these permissions:
PermissionPurpose
Repository contentsRead code for indexing and search
IssuesRead and create issues
Pull requestsRead PR information
ProjectsAccess GitHub Projects V2
MetadataRead repository information
WebhooksReceive real-time updates

​
Security

  • GitHub App tokens are encrypted at rest
  • Access can be revoked anytime in GitHub Settings > Applications
  • Kasava never stores your GitHub password
  • All API communication uses HTTPS

Code Intelligence

Learn about indexing and semantic search

Products

Link GitHub repositories to Products

AI Learning

Customize how AI analyzes commits and PRs