ngit ci cancel
request cancellation of one exact workflow run
Parent command: ngit ci
Related guide: CI
Usage
text
Usage: ngit ci cancel [OPTIONS] <COORDINATOR> <RUN-ID>Arguments and options
| Input | Description | Details |
|---|---|---|
<COORDINATOR> | Coordinator public key (npub or hex) | required |
<RUN-ID> | Exact workflow run id from ci status (64 lowercase hexadecimal characters) | required |
--offline | Use the local repository and maintainer cache without refreshing it | — |
-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, profile, or cached Nostr display 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 prompts where supported (non-interactive by default) | 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 | Show detailed progress immediately and retain diagnostics | global; conflicts with -q, --quiet |
--repo-relay-only | Only publish nostr events to repository relays, not user or default relays | global |
--proactive-auth | Authenticate to eligible relays on AUTH challenges before a request is rejected | global |
--repo <REMOTE|NADDR|NOSTR-URL> | Target repository for repo-scoped operations, overriding auto-detection | global |
--json | Output machine-readable JSON on stdout | global; conflicts with -i, --interactive |
-h, --help | Print help (see a summary with '-h') | — |
-V, --version | Print version | — |
Details
Request cancellation of one exact workflow run (kind 9846). By default, running jobs follow their cancellation grace periods. Use --force (kind 9848) to stop all active tasks in that run immediately, bypassing those grace periods; this also escalates an earlier ordinary cancellation. Requires a confirmed repository maintainer. Pass the coordinator and 64-character run id reported by ci status, and select the repository perspective used by that run with --repo. A successful command means the request was published; use ci status to observe confirmed completion. Cancellation cannot roll back effects already published.