ngit release publish
publish a new release or explicitly edit an existing release
Parent command: ngit release
Related guide: Releases
Upcoming command surface
This page is generated from an unreleased ngit commit. Its interface may change before the next release.
Usage
text
Usage: ngit release publish [OPTIONS] <VERSION>Arguments and options
| Input | Description | Details |
|---|---|---|
<VERSION> | Exact release version; identifiers are not normalized | required |
--app <APP> | Application identifier, naddr, or application coordinate | — |
--channel <CHANNEL> | Release channel (defaults to main when creating) | — |
--notes <TEXT> | Release notes | conflicts with --notes-file <PATH> |
--notes-file <PATH> | Read release notes from a file | conflicts with --notes <TEXT> |
--released-at <UNIX_SECONDS> | Release date as Unix seconds (defaults to now when creating) | — |
--tag <TAG> | Git tag used for {tag} manifest expansion | — |
--commit <COMMIT> | Git commit represented by this release (defaults to HEAD when creating) | — |
--manifest <PATH> | Release assets and publication defaults; creation also discovers .ngit/release.yaml | — |
--asset <PLATFORM=URL> | Add a URL-backed asset as PLATFORM=URL (repeatable) | repeatable |
--file <[PLATFORM=]PATH> | Upload PATH, or use PLATFORM=PATH shorthand (repeatable) | repeatable |
--platform <PLATFORM> | Target platform for one bare --file PATH (repeatable) | repeatable |
--asset-event <ASSET> | Reuse an existing kind 3063 asset event (repeatable) | repeatable |
--platform-agnostic-asset <URL> | Add a URL-backed asset with no target platform (repeatable) | repeatable |
--platform-agnostic-file <PATH> | Upload a local platform-agnostic asset to Blossom (repeatable) | repeatable |
--accept-platform-agnostic-assets | Acknowledge reused asset events which have no platform tags | — |
--add-application-platforms | Add release-only platforms to the replaceable application event | — |
--allow-partial-platforms | Permit a non-main release to omit application platforms | — |
--blossom-server <URL> | Override kind-10063 discovery with an ordered Blossom server (repeatable) | repeatable |
--edit | Explicitly replace an existing release; never creates a missing release | — |
--strict-metadata | Treat metadata warnings as errors | — |
--relay <URL> | Extend discovery and publication with a relay (repeatable) | repeatable |
--zapstore-relay | Also publish to the Zapstore catalog relay; does not change Blossom | — |
--json | Output as JSON | — |
-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 |
-f, --force | Force operations, bypass safety guards | global |
-v, --verbose | Enable verbose output | global |
--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 |
-h, --help | Print help (see a summary with '-h') | — |
-V, --version | Print version | — |