Skip to content

ngit ci secrets ​

Publish an encrypted atomic secret update to a live coordinator inbox

Parent command: ngit ci

Related guide: CI

Usage ​

text
Usage: ngit ci secrets [OPTIONS] <COORDINATOR>

Arguments and options ​

InputDescriptionDetails
<COORDINATOR>Coordinator public key (npub or hex)required
--set-file <PATH>JSON file mapping secret names to values; values are never accepted on argv—
--set-from-env <NAME>Set NAME from the environment variable NAME (repeatable)repeatable
--confirmation-timeout <CONFIRMATION_TIMEOUT>Seconds to wait for coordinator confirmation (0 publishes without waiting). Relay delivery succeeds independently; JSON confirmation remains pending if no matching status arrives before this deadlinedefault 90
--remove <NAME>Remove a secret name (repeatable)repeatable
-n, --nsec <NSEC>nsec or hex private keyglobal; 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 fileglobal; conflicts with --nbunksec <NBUNKSEC>, --nbunksec-file <PATH>, -n, --nsec <NSEC>, --signer <NPUB|ALIAS|NAME>
--nbunksec <NBUNKSEC>Established remote signer connection encoded as nbunksecglobal; 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 fileglobal; conflicts with --nbunksec <NBUNKSEC>, -n, --nsec <NSEC>, --nsec-file <PATH>, --signer <NPUB|ALIAS|NAME>
--signer <NPUB|ALIAS|NAME>Use a configured signer by npub, profile, or cached Nostr display name for this commandglobal; conflicts with --nbunksec <NBUNKSEC>, --nbunksec-file <PATH>, -n, --nsec <NSEC>, --nsec-file <PATH>
-c, --customizeShow customization options via git configglobal
-d, --defaultsUse default values without prompting (non-interactive mode)global; conflicts with -i, --interactive
-i, --interactiveEnable prompts where supported (non-interactive by default)global; conflicts with -d, --defaults, --json
-f, --forceForce operations, bypass safety guardsglobal
-q, --quietSuppress progress and other non-essential outputglobal; conflicts with -v, --verbose
-v, --verboseShow detailed progress immediately and retain diagnosticsglobal; conflicts with -q, --quiet
--repo-relay-onlyOnly publish nostr events to repository relays, not user or default relaysglobal
--proactive-authAuthenticate to eligible relays on AUTH challenges before a request is rejectedglobal
--repo <REMOTE|NADDR|NOSTR-URL>Target repository for repo-scoped operations, overriding auto-detectionglobal
--jsonOutput machine-readable JSON on stdoutglobal; conflicts with -i, --interactive
-h, --helpPrint help (see a summary with '-h')—
-V, --versionPrint version—