Connecting GitHub

AIDEN uses GitHub OAuth to access your repositories.

Setup

1. Open AIDEN → Settings → GitHub
2. Click Connect GitHub
3. Authorize AIDEN in the browser popup
4. Your GitHub account is now linked

Features

Clone Repositories

Once connected, you can create projects by cloning any of your GitHub repositories:

1. New Project → From Repository
2. Select a repository from your account
3. Choose a branch
4. Pick a local directory for the clone

Automatic Pull Requests

When an AI agent completes a story, AIDEN can automatically:

1. Push the feature branch to GitHub
2. Create a Pull Request with:
   • Title matching the story title
   • Description from the story spec
   • Link back to the AIDEN story
3. Track the PR status on the Kanban board

PR Management

From the story detail view, you can:

• View the PR on GitHub
• Check CI/CD status
• Merge the PR directly from AIDEN
• Close or update the PR

GitHub Token

AIDEN securely stores your GitHub OAuth token locally. The token is used for:

• Repository listing and cloning (via Octokit)
• Branch and PR management
• Commit status checks

To disconnect, go to Settings → GitHub → Disconnect.