ngit repo edit
update repository metadata on nostr
Parent command: ngit repo
Related guides: Repository metadata, Maintainers
Upcoming command surface
This page is generated from an unreleased ngit commit. Its interface may change before the next release.
Usage
text
Usage: ngit repo edit [OPTIONS]Arguments and options
| Input | Description | Details |
|---|---|---|
--name <NAME> | name of repository; --title is an alias | conflicts with --acknowledge-maintainer-change <NPUB> |
--description <DESCRIPTION> | optional description | conflicts with --acknowledge-maintainer-change <NPUB> |
--add-grasp-server <URL> | add a grasp server (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--remove-grasp-server <URL> | remove a grasp server (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--add-additional-relay <URL> | add a relay beyond those provided by grasp servers (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--remove-additional-relay <URL> | remove an additional relay (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--add-additional-clone <URL> | add a git clone URL beyond those provided by grasp servers (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--remove-additional-clone <URL> | remove an additional git clone URL (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--web <WEB> | homepage | repeatable; values per use 1+; conflicts with --acknowledge-maintainer-change <NPUB> |
-u, --u <UPSTREAM> | informational NIP-34 subordinate-fork u tag fields | repeatable; values per use 1+; conflicts with --acknowledge-maintainer-change <NPUB> |
--add-maintainer <NPUB> | invite one maintainer | — |
--remove-maintainer <NPUB> | remove one maintainer relationship | — |
--acknowledge-maintainer-change <NPUB> | record one maintainer's signed acceptance or departure boundary | conflicts with --add-additional-clone <URL>, --add-additional-relay <URL>, --add-grasp-server <URL>, --add-hashtag <TAG>, --clean, --description <DESCRIPTION>, --earliest-unique-commit <EARLIEST_UNIQUE_COMMIT>, --lead-maintainer <NPUB>, --name <NAME>, --no-lead-maintainer, --private, --public, --remove-additional-clone <URL>, --remove-additional-relay <URL>, --remove-grasp-server <URL>, --remove-hashtag <TAG>, -u, --u <UPSTREAM>, --web <WEB> |
--lead-maintainer <NPUB> | assign the lead maintainer | conflicts with --acknowledge-maintainer-change <NPUB>, --no-lead-maintainer |
--no-lead-maintainer | affirm deliberately leadless governance for this add or remove | conflicts with --acknowledge-maintainer-change <NPUB>, --lead-maintainer <NPUB> |
--add-hashtag <TAG> | add a repository hashtag (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--remove-hashtag <TAG> | remove a repository hashtag (repeatable) | repeatable; conflicts with --acknowledge-maintainer-change <NPUB> |
--earliest-unique-commit <EARLIEST_UNIQUE_COMMIT> | usually root commit but will be more recent commit for forks | conflicts with --acknowledge-maintainer-change <NPUB> |
--clean | drop unknown tags from the existing announcement when republishing | conflicts with --acknowledge-maintainer-change <NPUB> |
--private | mark the repository private | conflicts with --acknowledge-maintainer-change <NPUB>, --public |
--public | remove the private marker | conflicts with --acknowledge-maintainer-change <NPUB>, --private |
--force | reserved for future state-only replacement; collisions still fail | — |
-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 |
-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 |
--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 | — |
Argument groups
| Constraint | Inputs |
|---|---|
| At most one may be used | --acknowledge-maintainer-change <NPUB>, --add-maintainer <NPUB>, --remove-maintainer <NPUB> |
Details
update an existing repository announcement on nostr
repository announcements are created with ngit init; use this command for every later metadata or roster change. Omitted settings are preserved; collection settings use targeted --add-* and --remove-* actions