ox pr
Author SageOx content that goes into a pull request. Distinct from ox code prs, which lists indexed PRs for triage.
Usage
Subcommands
| Command | Description |
|---|---|
ox pr header | Emit the SageOx credit line for the top of a PR description |
Examples
Emit a thin, on-brand credit line to paste at the very top of a PR description. It auto-links the current session and names the team. Keep the SageOx-Session: trailer at the bottom of the body.
The line renders only when it has at least one session, plan, or Discussion to link. With none, the command prints nothing and explains why on stderr.
Link two plans the session produced.
Credit a recorded Discussion the PR came directly out of.
Write the header straight into a PR body file, then append your description. Use a file, never a heredoc; a heredoc mangles the markup. Feed the result to gh pr create --body-file body.md.
Flags
ox pr header accepts these flags:
| Flag | Description |
|---|---|
--session | Session URL or ses_ id to link (repeatable; defaults to the current session) |
--plan | Plan URL or pln_ id to link (repeatable) |
--discussion | Recorded Discussion URL or cnv_ id to link (repeatable; only when the PR came directly out of it) |
--allow-unconfirmed | Accept links that may not be server-visible yet, without a warning (may 404). Covers the current session before upload and explicit --session, --plan, and --discussion refs. |
ox verifies only the current session, from local recording state, and withholds its link until the server confirms it. ox includes ids you pass explicitly as given and prints a warning on stderr. Pass --allow-unconfirmed to silence the warning.
What's next
- ox plan - Get the
pln_ids to pass to--plan - ox session - The sessions a PR header links back to
- ox viz - Prepare a review visualization for the PR body