Connect a Repository

Once the GitHub App is installed, you can connect repositories that contain your AI prompt files.

Steps

1. Go to Repos in the sidebar (or continue through onboarding)
2. You'll see a list of repositories available through your GitHub App installation
3. Click Connect on the repository you want to add
4. PromptDeploy checks for a .promptdeploy.yml config file in the repo root
   • If found: your prompt definitions are imported automatically
   • If not found: you can configure prompts manually in the next step

What happens on connect

When you connect a repository, PromptDeploy:

1. Reads the repository's file tree
2. Looks for .promptdeploy.yml in the root
3. If config exists, creates prompt definitions matching your config
4. Stores the repository connection (repo name, installation ID, default branch)

No file content is stored — only metadata about which files are configured as prompts.

Repository limits

The number of repositories you can connect depends on your plan:

Plan	Repository limit
Free	1
Team	5
Business	Unlimited

Disconnecting a repository

To disconnect a repository, navigate to the repo page and click Disconnect. This removes the connection and all prompt configurations for that repo. It does not modify any files in your GitHub repository.