ngit release asset add
attach an existing asset and explicitly replace a release
Parent command: ngit release asset
Related guide: Releases
Preview command surface
This page is generated from a tagged ngit prerelease. Test it before relying on it in production.
Usage
text
Usage: ngit release asset add [OPTIONS] --edit <RELEASE>Arguments and options
| Input | Description | Details |
|---|---|---|
<RELEASE> | Release app@version, naddr, event-id, nevent, or unambiguous version | required |
--app <APP> | Application context for a bare release version | — |
--url <URL> | URL of a new asset to download, hash, and publish | conflicts with --blossom-server <URL>, --event <ASSET>, --file <PATH> |
--file <PATH> | Local asset to upload to Blossom | conflicts with --event <ASSET>, --url <URL> |
--event <ASSET> | Existing kind 3063 asset event to attach | conflicts with --android-certificate-sha256 <SHA256>, --android-min-allowed-version-code <CODE>, --android-version-code <CODE>, --asset-id <ID>, --asset-version <VERSION>, --blossom-server <URL>, --commit <COMMIT>, --file <PATH>, --filename <NAME>, --mime <MIME>, --min-allowed-version <VERSION>, --min-platform-version <VERSION>, --original-url <URL>, --platform <PLATFORM>, --supported-nip <NIP>, --target-platform-version <VERSION>, --url <URL>, --variant <VARIANT> |
--platform <PLATFORM> | Target platform (repeatable) | repeatable; conflicts with --event <ASSET>, --platform-agnostic |
--platform-agnostic | Explicitly acknowledge that the asset has no target platform | conflicts with --platform <PLATFORM> |
--asset-id <ID> | Asset identifier (defaults to the application identifier) | conflicts with --event <ASSET> |
--asset-version <VERSION> | Asset version (defaults to the release version) | conflicts with --event <ASSET> |
--filename <NAME> | Published filename override | conflicts with --event <ASSET> |
--mime <MIME> | MIME type override | conflicts with --event <ASSET> |
--min-platform-version <VERSION> | Minimum supported platform version | conflicts with --event <ASSET> |
--target-platform-version <VERSION> | Target platform version | conflicts with --event <ASSET> |
--supported-nip <NIP> | Supported NIP number (repeatable) | repeatable; conflicts with --event <ASSET> |
--variant <VARIANT> | Build variant | conflicts with --event <ASSET> |
--commit <COMMIT> | Source commit identifier | conflicts with --event <ASSET> |
--min-allowed-version <VERSION> | Minimum allowed asset version | conflicts with --event <ASSET> |
--android-version-code <CODE> | Android version code | conflicts with --event <ASSET> |
--android-min-allowed-version-code <CODE> | Minimum allowed Android version code | conflicts with --event <ASSET> |
--android-certificate-sha256 <SHA256> | Android signing certificate SHA-256 (repeatable) | repeatable; conflicts with --event <ASSET> |
--original-url <URL> | Original web source when it differs from the asset URL | conflicts with --event <ASSET> |
--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; conflicts with --event <ASSET>, --url <URL> |
--edit | Confirm replacement of the existing release event | required |
--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 |
-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 |
-h, --help | Print help (see a summary with '-h') | — |
-V, --version | Print version | — |