GitHub
Connect GitHub repositories for code-aware planning and issue sync.
Lisa's GitHub integration provides two capabilities: repository analysis for code-aware planning, and issue sync for bidirectional issue management.
Connecting GitHub
- Navigate to Settings > Integrations in your organization
- Click Connect GitHub
- Complete the GitHub OAuth flow
- Select the repositories you want to connect
Repository analysis
Once connected, Lisa can clone and analyze your repositories:
- Structure analysis — Framework detection, directory layout, key patterns
- Code exploration — Browse files, understand architecture, identify modules
- Context for issues — Lisa references actual code when creating issues and specs
Using repo context
Ask Lisa:
- "Analyze the auth module in our webapp repo"
- "What testing patterns do we use?"
- "Create issues for refactoring the API layer based on the codebase"
Lisa clones the repo into an isolated workspace and provides insights based on the actual code.
Issue sync
Bidirectional sync between Lisa issues and GitHub Issues:
| Lisa | GitHub |
|---|---|
| Status | Labels (mapped) |
| Priority | Labels (mapped) |
| Description | Body (Markdown) |
| Labels | Labels |
| Milestone | Milestone |
Mapping
- Lisa statuses map to GitHub labels:
status:todo,status:in-progress,status:done - Lisa priorities map to GitHub labels:
priority:high,priority:medium,priority:low - Milestones sync by name matching
Webhooks
Lisa listens for GitHub webhooks to receive real-time updates:
- Issue created/updated/closed
- Label changes
- Milestone changes
Configure the webhook URL in your GitHub repository settings:
https://your-lisa-url/api/webhooks/github