Skip to main content
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.

​
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 uses gh 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: Updates are pushed to the UI automatically — no refresh needed.

​
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
If a task has multiple PRs, Whim surfaces the most recently updated one.

​
Review workflow

  1. Task completes — the agent finishes and optionally opens a PR
  2. Review in GitHub — your team reviews using GitHub’s standard tools
  3. Track in Whim — PR status flows back to the dashboard automatically
  4. Merge — merge in GitHub; Whim updates the status to “merged”
If a reviewer requests changes, fork the task or send a follow-up prompt — the agent pushes new commits to the same branch, updating the existing PR.

​
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.