Install GitHub App
PromptDeploy connects to your repositories through a GitHub App. This gives us scoped, secure access to read and write prompt files — without requiring personal access tokens.
Steps
- Sign up at promptdeploy.com and create an account
- During onboarding, click Install GitHub App — this takes you to GitHub
- Choose whether to install on your organisation or personal account
- Select which repositories the app can access:
- All repositories — PromptDeploy can see all repos (you still choose which to connect)
- Selected repositories — limit access to specific repos
- Click Install to confirm
After installation, you'll be redirected back to PromptDeploy to continue setup.
Permissions
The GitHub App requests the following permissions:
| Permission | Access | Purpose |
|---|---|---|
| Repository contents | Read & write | Read prompt files, commit changes |
| Pull requests | Read & write | Create PRs for review-mode deploys |
| Metadata | Read | List repositories and branches |
Managing the installation
You can change repository access or uninstall the app at any time from your GitHub settings:
Settings → Integrations → Applications → PromptDeploy → Configure
Multiple organisations
If you work across multiple GitHub organisations, you can install the app on each one separately. Each PromptDeploy organisation links to one GitHub App installation.
Troubleshooting
I don't see the install button Make sure you're signed in to PromptDeploy and have completed the organisation creation step in onboarding.
I installed but repos aren't showing Check that the installation grants access to the repositories you want. You can update this in GitHub under Settings → Integrations → Applications.