/kosuke:open-pr
/kosuke:open-pr commits your session's work, pushes the branch and opens a pull request with a title and a description. If the branch already has an open pull request, it brings that one up to date instead. The Open PR button runs this skill, and Open a pull request covers the button.
When to use it
Run it when the work is ready for review, or to refresh the description after more changes. Type it yourself when you want a draft, reviewers or evidence links. The button sends it without them.
It commits and pushes whatever your Commits preference is, because opening a pull request needs published commits.
Run it
Type /kosuke:open-pr, or $kosuke:open-pr in a Codex session.
| Argument | What it does | Default |
|---|---|---|
--target-branch <branch> | The branch the pull request targets. The button passes it when the project settings name one. | The project's Target Branch |
-d, --draft | Opens the pull request as a draft. Ignored once a pull request is open. | Ready for review |
--ready | Marks the draft pull request ready for review. It commits, pushes and opens nothing. It works only when qa: passed and review: passed or review: skipped sit on the current head. | Off |
-r, --reviewers <names> | Requests reviewers, separated by commas or spaces. First names and nicknames match the repository's collaborators. | Nobody |
-e, --evidence <links> | Adds an Evidence section with links that show the change working, such as a recording or a Preview link. | No Evidence section |
| Any other text | Extra context for the description. | None |
/kosuke:open-pr
/kosuke:open-pr -d -r tom,alice
/kosuke:open-pr -r alice -e https://example.com/recording.mp4 Mention the new export limit
What it does
- It commits the pending work. It stages only what belongs to the change and leaves out secrets, build output and scratch files. When a git hook fails, it fixes what the hook reports.
- It pushes the branch. If the remote branch moved, it merges it in first.
- It writes the title and the description from what is on the branch.
- It matches each reviewer name to a GitHub login. When a name matches several logins or none, it asks you which one you meant.
- It opens the pull request, or updates the open one.
- It replies with the link, the branch it targets, whether it is a draft, the reviewers, and anything it could not do.
On an update, it rewrites the description and keeps any text a person added by hand. It changes the title only when the work has moved past it. With -r, the requested reviewers are replaced by the ones you name, and requested teams stay. Without -r, the reviewers stay as they are.
If the open pull request targets a different branch from the Target Branch, it asks whether to keep it there or move it. When it moves it and the branch holds commits from elsewhere, it suggests a Sync.
What you get
- Commits with the pending work, pushed to the branch.
- A pull request with a Summary, a list of Changes and, with
-e, an Evidence section. Links to the chat session and to its QA Report, when it has one, follow. - A session in Under Review when the pull request is ready for review, or still Active when it is a draft.
- A session title that matches the pull request title.
The pull request opens as you when you have a GitHub Connection, and as Kosuke App otherwise. If your GitHub Connection cannot write to the repository, Kosuke App opens it. When Kosuke App opens it, the description names you in a Created by: line.