---
title: GitHub
slug: github
docTags: 
createdAt: 2025-03-20T22:01:43.997Z
---

Connect Aiden with your GitHub repositories to get intelligent assistance with code management, infrastructure as code, and CI/CD workflows. Once enabled, Aiden becomes your DevOps coding partner, helping you manage configurations, troubleshoot workflows, and implement best practices through natural conversations.

## Capabilities

With GitHub integration, Aiden can:

- Explore repository files and codebases
- Build a knowledge base about your infrastructure configurations
- Create pull requests with suggested improvements for infra and config changes
- Review infrastructure code and configuration changes
- Debug `GitHub Actions` workflow issues
- Generate new configuration files based on existing patterns
- Analyze deployment history and failures
- Recommend security and best practice enhancements

## Example Interactions

- `Review the Terraform changes in PR #245 in repo acme/iac`
- `Can you improve the security of the cart-service Doeckerfile`
- `What's causing the CI pipeline failure in the auth-service repo?`
- `Generate a GitHub Actions workflow for Node.js testing similar to that of the auth-service`
- `Create a PR to optimize our Kubernetes resource configs`
- `Help me understand the structure of our Ansible playbooks`

## Configuration Steps

1. Generate a GitHub Personal Access Token (PAT) by following the steps in this [GitHub doc](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic)
2. Navigate to **Integrations** in the sidebar
3. Locate the GitHub integration card and click **Activate**
4. Configure your GitHub access: 
   - GitHub Personal Access Token
5. Click **Save** to enable the integration

:::hint{type="info"}
GitHub app based authentication is coming soon
:::

![](https://api.archbee.com/api/optimize/xpy-ZuNXAextve6S5Tto2/looHxGyQ7sczGoVgnr2FZ_screen-shot-2025-03-20-at-31713-pm.png)

### Security Best Practices

- Create a token with minimum required permissions
- Limit repository access to only what's necessary
- Regularly rotate the PAT
- Enable branch protection on critical repositories
- Consider using required reviews for Aiden-generated PRs