GitHub – Town Docs
GitHub
Connect GitHub to give your assistant access to repositories, pull requests, commits, and code files.
What’s included
With GitHub connected, your assistant can:
- View repositories — See your accessible repos
- Read files — Access code, configs, and documentation
- Create and update files — Make changes with commits
- Track commits — See recent activity and changes
- Work with pull requests — List, view comments, and create new PRs
Connecting GitHub
- Go to Integrations
- Find GitHub and click Connect
- Authorize Town on GitHub
- Select which repositories to grant access to (or all)
- Return to Town
You can limit access to specific repositories during the GitHub authorization. Town only sees repos you explicitly grant access to.
What your assistant can do
| Capability | What it does | Makes changes? |
|---|---|---|
| List repositories | See your accessible repos | No |
| Read files | View code, configs, and docs | No |
| Create or update files | Add or edit files (creates commits) | Yes |
| List commits | See recent changes | No |
| List pull requests | View open and closed PRs | No |
| Create pull request | Open a new PR | Yes |
| View PR comments | Read discussion on pull requests | No |
| View issue comments | Read discussion on issues | No |
Tools that create commits or pull requests make real changes to your repositories. Use approval-required mode for routines that use these tools.
Tracking PRs in Town
When you open a PR in Town, you can instantly follow its status and merge changes without opening GitHub. Use the GitHub PR context card (seen after opening a PR) to track changes, fix issues, and ultimately merge (or auto-merge) changes. You can also use this card to track the deploy status so you know exactly when your changes are pushed to your live site.
Use cases
Activity reports
Monitor what’s happening across your repositories:
- Daily digest of commits and pull requests
- Highlight stale PRs that need attention
- Track what shipped this week
PR review reminders
Stay on top of code reviews:
- Find PRs waiting for your review
- Get daily reminders about unreviewed requests
- Filter by how long they’ve been open
Code monitoring
Watch for specific changes:
- Alert when critical files are modified
- Track dependency updates
- Monitor configuration changes
Automated documentation
Keep docs in sync with your code:
- Generate release notes from commits
- Update changelogs automatically
- Summarize what changed in a release
Configuration
Repository access
During GitHub authorization, you choose:
- All repositories — Access to everything in your account
- Selected repositories — Only specific repos
You can change this in your GitHub settings later.
Best practices
Start with read-only access. Begin with routines that only read data (list repos, view commits and PRs). Add write capabilities after testing.
Use approval-required for changes. Any routine that creates commits or pull requests should require your approval.
Limit repository access. Only grant access to the repos your routines actually need.
Troubleshooting
”Repository not found”
- Check if the repo is included in your GitHub authorization
- Verify the repository name is correct
- Private repos require explicit access grants
Can’t create files or PRs
- Ensure your GitHub authorization includes write access
- Check repository branch protection rules
- Verify you have push access to the repository
Last updated on August 8, 2026