When an AI agent finishes its work, you’ll typically open a pull request from the task branch. Whim automatically detects PRs created from task branches and links them to the corresponding task with real-time status tracking.Documentation Index
Fetch the complete documentation index at: https://docs.whim.run/llms.txt
Use this file to discover all available pages before exploring further.
Creating a pull request
From the AI agent
The most common approach — include instructions like “open a PR when done” in your prompt. The agent usesgh pr create to open a pull request from the task branch.
From GitHub
Create a PR manually in GitHub from the task branch (e.g.,whim-ww-42). Whim detects it automatically via webhook.
Whim links PRs to tasks by matching the branch name. Any PR from a
whim-* branch is automatically associated with the corresponding task.Status tracking
Once a PR is linked, Whim tracks its state in real time:| Status | Meaning |
|---|---|
| Draft | PR is open but marked as draft |
| Open | PR is ready for review |
| Merged | PR has been merged |
| Closed | PR was closed without merging |
PR display
Linked PRs appear on the task in both list and detail views:- A status badge shows the current state with a color-coded indicator
- Clicking the badge opens the PR on GitHub
- The PR number is displayed for quick reference
Review workflow
- Task completes — the agent finishes and optionally opens a PR
- Review in GitHub — your team reviews using GitHub’s standard tools
- Track in Whim — PR status flows back to the dashboard automatically
- Merge — merge in GitHub; Whim updates the status to “merged”
Multiple PRs per task
A task can have more than one linked PR — for example, PRs to multiple repos in a monorepo, or a closed PR replaced by a new one from the same branch. Whim tracks all of them but surfaces the most recent in the UI.Branch Isolation
How every task gets its own isolated Git branch.