What the GitHub integration does
Suppose a teammate files an issue and you want a fix drafted before you even open your editor. Mention 100xprompt in a comment and it goes to work. Depending on where the mention happens, it either amends an existing pull request or opens a new one.Answers on issues
Mention it in an issue comment and it investigates, then either replies with an analysis or turns the issue into a pull request that closes it.
Works on pull requests
Mention it on a pull request - including a review comment on a specific line - and it commits changes directly to that PR’s branch.
Opens pull requests
When its work produces code changes, it pushes a branch and opens a pull request for you to review and merge.
Runs on your terms
Every run happens in GitHub Actions with your secrets, checks the commenter’s write access first, and shares a link to the full session.
How it works
The integration runs as a GitHub Actions workflow. An event in your repository triggers the workflow. The workflow runs 100xprompt with the context of that issue or pull request. 100xprompt proposes its changes back through the same PR or a new one.Because it runs in GitHub Actions, 100xprompt uses your repository or organization secrets for model access and never needs credentials stored anywhere else. Each run leaves a link back to the Actions log and, for public repositories, a shareable session.
Install it into a repository
Suppose you want to automate a specific repository. Run the guided, one-time installer from that repository. It connects the GitHub app, lets you pick a provider and model, and writes a workflow file for you to commit.Run the installer from your repo
From the root of your git repository, run:The command detects your GitHub repository from its
origin remote, so run it inside a checked-out clone.Authorize the GitHub app
The installer opens GitHub in your browser so you can install the 100xprompt app on the target repository (or your whole organization). It waits until the installation is detected, then continues automatically.
Choose a provider and model
Pick the provider and model the agent should use for this repository. This choice is written into the generated workflow so every run uses it by default.
Commit the generated workflow
The installer writes a workflow file into
.github/workflows/. Commit and push it so GitHub starts listening for events:Add your provider secret
In your repository or organization Settings → Secrets, add the API key(s) for the provider you chose. The installer prints the exact secret names to add. The workflow reads them at runtime.
Trigger the agent
Mention the agent in a comment to invoke it. Out of the box it responds to/100xprompt or the shorthand /oc, and you can customize the trigger phrase (see Configure the workflow below). Matching is case-insensitive. How 100xprompt responds depends on where you mention it and what you say.
| Where you mention it | What you write | What 100xprompt does |
|---|---|---|
| Issue comment | Just the trigger (e.g. /100xprompt) | Summarizes the issue thread as a reply. |
| Issue comment | A request after the trigger | Works on the request, opens a pull request that closes the issue, and comments back. |
| Pull request comment | Just the trigger | Summarizes the pull request thread. |
| Pull request comment | A request after the trigger | Makes the change and commits it to the PR’s branch, then replies. |
| PR review comment (on a line) | Just the trigger | Reviews the commented lines and suggests improvements for them. |
| PR review comment (on a line) | A request after the trigger | Applies your request with the file and diff as context, then commits. |
When 100xprompt works on an issue, it creates a fresh branch and opens a new pull request that closes the issue. When it works on a pull request, it commits back to that PR’s existing branch - including pull requests opened from forks, where it pushes to the contributor’s fork branch.
What it can see
100xprompt reads the surrounding context before it starts. On a pull request, that includes the title and description, the changed files, prior comments, and review threads. On an issue, it reads the title, body, and comment history. Images and file attachments in the triggering comment are downloaded and made available to the agent too.Review the proposed change
When 100xprompt’s work results in code changes, it turns that work into something you can review - never a silent push to your default branch.Every reply includes a link back to the GitHub Actions run, and for public repositories, a link to the full 100xprompt session - so you can always trace how a change was produced.
Bring a PR into your terminal
Suppose the agent opened a pull request and you want to keep working on it locally. Check it out and open an interactive session in one step:#42 (handling fork branches automatically), then launches 100xprompt in that working tree. If the pull request was created by the GitHub integration and links a shared session, that session is imported so you continue with full history and context.
Configure the workflow
The workflow the installer generates works out of the box. When you want to tune behavior, adjust the inputs on the workflow step:| Input | What it controls |
|---|---|
model | The provider and model the agent uses, in provider/model form. Set during install; required. |
agent | Run a specific primary agent instead of the default. |
prompt | Provide a fixed instruction for the run instead of reading it from the comment. |
mentions | Customize the trigger phrase(s) - a comma-separated list, matched case-insensitively. |
share | Control whether the run’s session is shared. Sessions are shared by default for public repositories. |
Can I change the trigger phrase?
Can I change the trigger phrase?
Yes. Set the
mentions input on the workflow step to a comma-separated list of phrases. Anyone who includes one of those phrases in a comment invokes the agent. Matching is case-insensitive.Does it work on pull requests from forks?
Does it work on pull requests from forks?
Yes. When a mentioned pull request comes from a fork, 100xprompt checks out the contributor’s fork branch, makes the change, and pushes back to that same fork branch so the update appears on the existing pull request.
Who is allowed to trigger it?
Who is allowed to trigger it?
Only users with write or admin access to the repository. On every user-triggered run, 100xprompt checks the commenter’s permission level first and refuses to act for anyone without write access.
How do I keep it from touching private code?
How do I keep it from touching private code?
The agent runs with the permissions granted to the workflow and the GitHub app on your repository. Pair it with your repository’s branch protection and reviews so nothing merges without human approval, and scope the model provider’s secrets to only the repositories that need them.
Tips and limits
Related
- Automation workflows: reusable agents, models, and non-interactive runs.
- SDK: drive 100xprompt programmatically to build your own integrations.
- Permissions: the same guardrails that apply on GitHub.
Automation workflows
Recipes and building blocks - agents, models, and non-interactive runs you can reuse anywhere.
SDK
Drive 100xprompt programmatically to build your own automations and integrations.
Permissions
Control what the agent is allowed to do - the same guardrails apply on GitHub.