feat(skills): improve async-pr-review workflow and logging

[mattKorwel]

What

This PR introduces the Async PR Review Skill (async-pr-review), a powerful new capability that allows the Gemini CLI to perform comprehensive, agentic code reviews in the background while you continue working.

Why

Reviewing pull requests is often a context-switching, time-consuming task. We wanted a way to offload the heavy lifting—fetching the PR, provisioning an isolated environment, running the build/tests, and conducting a deep AI-driven code review—without blocking your main terminal or requiring you to wait interactively.

This skill showcases an advanced "Agentic Asynchronous Pattern":

1. Zero Context Pollution: It automatically provisions ephemeral git worktrees (.gemini/tmp/async-reviews/pr-<number>) so your main workspace and branches remain entirely untouched.
2. Headless Inference: It utilizes gemini --approval-mode=yolo in a detached background script to perform actual LLM reasoning and code analysis asynchronously.
3. Multi-Stage Evaluation: Instead of a monolithic check, it breaks the review down into granular, trackable stages (Setup, Build & Lint, Automated Tests, Manual Execution, Code Review).
4. Reliable Notifications: When the background job finishes (or fails), it alerts you via terminal escape sequences and native macOS notifications (osascript), so you never miss a completed review.

How

The skill is composed of:

1. async-review.sh: A background dispatcher that fetches the PR, creates the ephemeral worktree, and launches parallel sub-tasks (compilation, testing, and a headless Gemini review). It writes discrete .log and .exit files for each stage. It also includes a robust notify subsystem for macOS and terminal alerts.
2. check-async-review.sh: A status checker that polls the ephemeral .exit files to report real-time progress (IN_PROGRESS vs COMPLETE).
3. SKILL.md: The orchestrating prompt that teaches the interactive Gemini agent how to start reviews and how to synthesize the final .md logs into a cohesive recommendation for the user.

Testing

• Tested manually by triggering the async-pr-review skill to evaluate active PRs in the background.
• Verified isolation: Confirmed that the user's primary git worktree is unaffected during the review process.
• Verified status polling: Executed check-async-review.sh during active runs to confirm it correctly parses .exit files to report IN_PROGRESS or COMPLETE.
• Verified notifications: Confirmed native macOS popups appear reliably upon task completion and simulated failures.

Demo

Launch the skill by asking it to review a PR# in the background

After launching the async PR you can ask cli to check on the status at any time (it will also do this in the background for you)

[gemini-code-assist]

Note

Gemini is unable to generate a summary for this pull request due to the file types involved not being currently supported.

[github-actions]

Size Change: -4 B (0%)

Total Size: 26.5 MB

ℹ️ View Unchanged

Filename	Size	Change
./bundle/gemini.js	26.1 MB	-4 B (0%)
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js	221 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js	227 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js	11.5 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js	132 B	0 B
./bundle/sandbox-macos-permissive-open.sb	890 B	0 B
./bundle/sandbox-macos-permissive-proxied.sb	1.31 kB	0 B
./bundle/sandbox-macos-restrictive-open.sb	3.36 kB	0 B
./bundle/sandbox-macos-restrictive-proxied.sb	3.56 kB	0 B
./bundle/sandbox-macos-strict-open.sb	4.82 kB	0 B
./bundle/sandbox-macos-strict-proxied.sb	5.02 kB	0 B

_{compressed-size-action}

[NTaylorMullen]

Should remove the node/npx bits by default. Alternatively feel free to encourage the model to utilize those within a sandbox that has no network access if you need them