Documentation

GitHub SCM

Pull request observation, lifecycle feedback, and explicit PR actions.

AO uses GitHub for the current pull-request lane. Authentication is lazy and non-blocking at daemon startup; use ao doctor to inspect local GitHub readiness.

Associate a pull request

Claim a PR while spawning or attach it later:

ao spawn --project my-app --name review-fix --claim-pr 42
ao session claim-pr 42
# From outside the worker, target it explicitly:
ao session claim-pr ao-123 42

Inside a worker, the one-argument form reads the target session from AO_SESSION_ID.

PR ownership prevents multiple active workers from silently driving the same pull request. Add --no-takeover when a conflicting owner must be treated as an error.

Observation and feedback

The daemon polls active PRs with ETag guards and semantic diffing. New CI failures, human review feedback, and merge conflicts are reduced into durable facts and can nudge the owning agent. The desktop consumes concise summaries; raw CI logs and full review comment bodies are not part of the current summary API.

Explicit actions

ao pr merge 42
ao pr resolve-comments 42
ao review trigger <worker-session-id>

Reviewer agents are configured separately from worker agents. The shipped reviewer harnesses are claude-code, codex, and opencode.