ngit pr send
submit PR with advanced options (alias for ngit send)
Parent command: ngit pr
Related guide: Pull requests
Preview command surface
This page is generated from a tagged ngit prerelease. Test it before relying on it in production.
Usage
text
Usage: ngit pr send [OPTIONS] [SINCE_OR_RANGE]Arguments and options
| Input | Description | Details |
|---|---|---|
<SINCE_OR_RANGE> | commits to send as proposal; like in git format-patch eg. HEAD~2 | default `` |
--in-reply-to <IN_REPLY_TO> | references to an existing proposal for which this is a new version and/or events / npubs to tag as mentions | repeatable; values per use 0+ |
--no-cover-letter | don't prompt for a cover letter | — |
--subject <SUBJECT> | optional cover letter subject/title | — |
--description <DESCRIPTION> | optional cover letter description | — |
--force-pr | publish as Pull Request even if each commit is < 60kb | — |
--force-patch | publish as Patches even if they may be > 60kb; cannot be used when the existing proposal is already a PR kind (downgrades are not possible) | — |
-o, --push-option <PUSH_OPTIONS> | git push options to pass to the git server (eg. -o secret-scanning.skip) | repeatable; values per use 0+ |
--git-server <GIT_SERVER> | git server URL to use for pushing the PR; accepts either a GRASP server base URL (eg. relay.ngit.dev) or a full clone URL (eg. https://github.com/user/repo.git) | — |
--target-branch <TARGET_BRANCH> | branch this PR should target instead of the repository default | — |
--base <BASE> | commit, branch, root PR, or PR update to use as the base for this publication | — |
-n, --nsec <NSEC> | nsec or hex private key | global; conflicts with --nbunksec <NBUNKSEC>, --nbunksec-file <PATH>, --nsec-file <PATH>, --signer <NPUB|ALIAS|NAME> |
--nsec-file <PATH> | read an nsec or hex private key from a path resolving to a regular file | global; conflicts with --nbunksec <NBUNKSEC>, --nbunksec-file <PATH>, -n, --nsec <NSEC>, --signer <NPUB|ALIAS|NAME> |
--nbunksec <NBUNKSEC> | established remote signer connection encoded as nbunksec | global; conflicts with --nbunksec-file <PATH>, -n, --nsec <NSEC>, --nsec-file <PATH>, --signer <NPUB|ALIAS|NAME> |
--nbunksec-file <PATH> | read an nbunksec connection from a path resolving to a regular file | global; conflicts with --nbunksec <NBUNKSEC>, -n, --nsec <NSEC>, --nsec-file <PATH>, --signer <NPUB|ALIAS|NAME> |
--signer <NPUB|ALIAS|NAME> | use a configured signer by npub, alias, or cached profile name for this command | global; conflicts with --nbunksec <NBUNKSEC>, --nbunksec-file <PATH>, -n, --nsec <NSEC>, --nsec-file <PATH> |
-c, --customize | show customization options via git config | global |
-d, --defaults | Use default values without prompting (non-interactive mode) | global; conflicts with -i, --interactive |
-i, --interactive | Enable interactive prompts (default behavior) | global; conflicts with -d, --defaults, --json |
-f, --force | Force operations, bypass safety guards | global |
-q, --quiet | Suppress progress and other non-essential output | global; conflicts with -v, --verbose |
-v, --verbose | Enable verbose output | global; conflicts with -q, --quiet |
--repo-relay-only | Only publish nostr events to repository relays, not user or default relays | global |
--repo <REMOTE|NADDR|NOSTR-URL> | Target repository for repo-scoped operations. Accepts a configured nostr:// remote name, an naddr, or a nostr:// URL. Overrides nostr.repo, tracked-upstream, and remote-based auto-detection. Available at any command position: ngit --repo upstream send ngit issue --repo upstream create ngit issue create --repo upstream | global |
--json | Output one machine-readable JSON document on stdout | global; conflicts with -i, --interactive |
-h, --help | Print help (see a summary with '-h') | — |
-V, --version | Print version | — |
Details
submit PR with advanced options
for a simpler flow, push a branch with the pr/ prefix using native git: git push -o 'title=My PR' -o 'description=details here' -u origin pr/my-branch