# ngit documentation

> Git collaboration over Nostr: CLI, hosting, CI, protocols, web UI, and automation.

Use the page and artifact manifest for provenance, raw Markdown, and command-schema discovery: /api/docs-manifest.json

## Pages

- [Accounts and keys](/accounts): Store identities safely, use remote signers and aliases, and select keys for automation.
- [Automate ngit safely](/agents/): Stable output, cache-aware reads, repository selection, signer safety, and machine-readable documentation for coding agents.
- [Use Nostr CI](/ci): Choose a coordinator, request service, add a workflow, read signed results, rerun a workflow, and configure secrets.
- [act workflow files](/ci/workflows/): The definitive reference for .ngit/act/workflows files: what the coordinator accepts, refuses, and adds compared with GitHub Actions.
- [Configure ngit](/configuration): Configure relay sets, repository behaviour, timeouts, identities, and cache locations.
- [GitWorkshop](/ecosystem/gitworkshop): Use a browser client for repositories, code, issues, pull requests, reviews, and CI without making it the source of truth.
- [Grasp Awesome](/ecosystem/): Explore independent clients, community workspaces, developer tools, release and CI systems, and GRASP servers for Git collaboration over Nostr.
- [GitWorkshop](/gitworkshop/): Use the GitWorkshop browser client for repositories, issues, pull requests, reviews, releases, and CI over Nostr.
- [ngit guides](/guides): Find the ngit guide for a task and jump to exact generated command syntax when needed.
- [How ngit works](/how-it-works): Understand signed Git refs on Nostr, replaceable Git servers, and GRASP providers.
- [ngit documentation](/): Centralised Git forges work great. Until they don't. ngit keeps your identity and repository state portable across multiple providers.
- [Install ngit](/install): Install ngit and git-remote-nostr on macOS, Linux, Windows, or NixOS.
- [Issues](/issues): Create, discuss, label, resolve, and reopen issues with ngit.
- [Maintainers](/maintainers): Who can do what in an ngit repository, how maintainers are invited and accept, and how to keep up with roster changes.
- [Maintainers: going deeper](/maintainers/going-deeper): Leadless and older repositories, delegated trust, maintainer removal, same-name invitations, and safe roster repair.
- [ngit-grasp changelog](/ngit-grasp/changelog/): Complete release history for ngit-grasp, imported from the stable 3.0.4 release.
- [ngit-grasp](/ngit-grasp/): Learn what ngit-grasp provides, choose a deployment, find operator reference, and read its complete release history.
- [ngit changelog](/ngit/changelog/): Complete release history for ngit, imported from the stable 3.0.3 release.
- [ngit](/ngit/): Install ngit, learn its Git-over-Nostr workflow, find command reference, and read its complete release history.
- [ngit account command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account): Generated syntax and options for ngit account.
- [ngit account connect command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/connect): Generated syntax and options for ngit account connect.
- [ngit account create command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/create): Generated syntax and options for ngit account create.
- [ngit account export-keys command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/export-keys): Generated syntax and options for ngit account export-keys.
- [ngit account forget-keys command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/forget-keys): Generated syntax and options for ngit account forget-keys.
- [ngit account login command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/login): Generated syntax and options for ngit account login.
- [ngit account logout command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/logout): Generated syntax and options for ngit account logout.
- [ngit account whoami command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/account/whoami): Generated syntax and options for ngit account whoami.
- [ngit ci command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/ci): Generated syntax and options for ngit ci.
- [ngit ci request command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/ci/request): Generated syntax and options for ngit ci request.
- [ngit ci status command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/ci/status): Generated syntax and options for ngit ci status.
- [ngit ci stop command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/ci/stop): Generated syntax and options for ngit ci stop.
- [ngit ci trigger command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/ci/trigger): Generated syntax and options for ngit ci trigger.
- [ngit container command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/container): Generated syntax and options for ngit container.
- [ngit container publish command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/container/publish): Generated syntax and options for ngit container publish.
- [ngit command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/): Generated syntax and options for ngit.
- [ngit init command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/init): Generated syntax and options for ngit init.
- [ngit issue command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue): Generated syntax and options for ngit issue.
- [ngit issue close command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/close): Generated syntax and options for ngit issue close.
- [ngit issue comment command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/comment): Generated syntax and options for ngit issue comment.
- [ngit issue create command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/create): Generated syntax and options for ngit issue create.
- [ngit issue label command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/label): Generated syntax and options for ngit issue label.
- [ngit issue list command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/list): Generated syntax and options for ngit issue list.
- [ngit issue reopen command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/reopen): Generated syntax and options for ngit issue reopen.
- [ngit issue resolved command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/resolved): Generated syntax and options for ngit issue resolved.
- [ngit issue set-cover-note command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/set-cover-note): Generated syntax and options for ngit issue set-cover-note.
- [ngit issue set-subject command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/set-subject): Generated syntax and options for ngit issue set-subject.
- [ngit issue view command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/issue/view): Generated syntax and options for ngit issue view.
- [ngit merge command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/merge): Generated syntax and options for ngit merge.
- [ngit nsite command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/nsite): Generated syntax and options for ngit nsite.
- [ngit nsite publish command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/nsite/publish): Generated syntax and options for ngit nsite publish.
- [ngit pr command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr): Generated syntax and options for ngit pr.
- [ngit pr apply command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/apply): Generated syntax and options for ngit pr apply.
- [ngit pr checkout command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/checkout): Generated syntax and options for ngit pr checkout.
- [ngit pr close command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/close): Generated syntax and options for ngit pr close.
- [ngit pr comment command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/comment): Generated syntax and options for ngit pr comment.
- [ngit pr draft command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/draft): Generated syntax and options for ngit pr draft.
- [ngit pr label command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/label): Generated syntax and options for ngit pr label.
- [ngit pr list command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/list): Generated syntax and options for ngit pr list.
- [ngit pr merge command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/merge): Generated syntax and options for ngit pr merge.
- [ngit pr ready command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/ready): Generated syntax and options for ngit pr ready.
- [ngit pr reopen command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/reopen): Generated syntax and options for ngit pr reopen.
- [ngit pr send command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/send): Generated syntax and options for ngit pr send.
- [ngit pr set-cover-note command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/set-cover-note): Generated syntax and options for ngit pr set-cover-note.
- [ngit pr set-subject command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/set-subject): Generated syntax and options for ngit pr set-subject.
- [ngit pr view command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/pr/view): Generated syntax and options for ngit pr view.
- [ngit release command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release): Generated syntax and options for ngit release.
- [ngit release app command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/app): Generated syntax and options for ngit release app.
- [ngit release app init command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/app/init): Generated syntax and options for ngit release app init.
- [ngit release app link command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/app/link): Generated syntax and options for ngit release app link.
- [ngit release app list command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/app/list): Generated syntax and options for ngit release app list.
- [ngit release app view command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/app/view): Generated syntax and options for ngit release app view.
- [ngit release asset command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/asset): Generated syntax and options for ngit release asset.
- [ngit release asset add command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/asset/add): Generated syntax and options for ngit release asset add.
- [ngit release asset list command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/asset/list): Generated syntax and options for ngit release asset list.
- [ngit release asset view command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/asset/view): Generated syntax and options for ngit release asset view.
- [ngit release list command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/list): Generated syntax and options for ngit release list.
- [ngit release publish command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/publish): Generated syntax and options for ngit release publish.
- [ngit release view command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/release/view): Generated syntax and options for ngit release view.
- [ngit repo command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/repo): Generated syntax and options for ngit repo.
- [ngit repo accept command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/repo/accept): Generated syntax and options for ngit repo accept.
- [ngit repo edit command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/repo/edit): Generated syntax and options for ngit repo edit.
- [ngit repo follow-lead command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/repo/follow-lead): Generated syntax and options for ngit repo follow-lead.
- [ngit repo init command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/repo/init): Generated syntax and options for ngit repo init.
- [ngit repo leave command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/repo/leave): Generated syntax and options for ngit repo leave.
- [ngit send command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/send): Generated syntax and options for ngit send.
- [ngit skill command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/skill): Generated syntax and options for ngit skill.
- [ngit skill install command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/skill/install): Generated syntax and options for ngit skill install.
- [ngit skill opt-out command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/skill/opt-out): Generated syntax and options for ngit skill opt-out.
- [ngit skill status command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/skill/status): Generated syntax and options for ngit skill status.
- [ngit skill upgrade command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/skill/upgrade): Generated syntax and options for ngit skill upgrade.
- [ngit sync command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/sync): Generated syntax and options for ngit sync.
- [ngit update command reference (3.0.0-rc.8 preview)](/ngit/reference/preview/update): Generated syntax and options for ngit update.
- [ngit account command reference](/ngit/reference/stable/account): Generated syntax and options for ngit account.
- [ngit account connect command reference](/ngit/reference/stable/account/connect): Generated syntax and options for ngit account connect.
- [ngit account create command reference](/ngit/reference/stable/account/create): Generated syntax and options for ngit account create.
- [ngit account export-keys command reference](/ngit/reference/stable/account/export-keys): Generated syntax and options for ngit account export-keys.
- [ngit account forget-keys command reference](/ngit/reference/stable/account/forget-keys): Generated syntax and options for ngit account forget-keys.
- [ngit account login command reference](/ngit/reference/stable/account/login): Generated syntax and options for ngit account login.
- [ngit account logout command reference](/ngit/reference/stable/account/logout): Generated syntax and options for ngit account logout.
- [ngit account whoami command reference](/ngit/reference/stable/account/whoami): Generated syntax and options for ngit account whoami.
- [ngit ci command reference](/ngit/reference/stable/ci): Generated syntax and options for ngit ci.
- [ngit ci request command reference](/ngit/reference/stable/ci/request): Generated syntax and options for ngit ci request.
- [ngit ci status command reference](/ngit/reference/stable/ci/status): Generated syntax and options for ngit ci status.
- [ngit ci stop command reference](/ngit/reference/stable/ci/stop): Generated syntax and options for ngit ci stop.
- [ngit ci trigger command reference](/ngit/reference/stable/ci/trigger): Generated syntax and options for ngit ci trigger.
- [ngit container command reference](/ngit/reference/stable/container): Generated syntax and options for ngit container.
- [ngit container publish command reference](/ngit/reference/stable/container/publish): Generated syntax and options for ngit container publish.
- [ngit command reference](/ngit/reference/stable/): Generated syntax and options for ngit.
- [ngit init command reference](/ngit/reference/stable/init): Generated syntax and options for ngit init.
- [ngit issue command reference](/ngit/reference/stable/issue): Generated syntax and options for ngit issue.
- [ngit issue close command reference](/ngit/reference/stable/issue/close): Generated syntax and options for ngit issue close.
- [ngit issue comment command reference](/ngit/reference/stable/issue/comment): Generated syntax and options for ngit issue comment.
- [ngit issue create command reference](/ngit/reference/stable/issue/create): Generated syntax and options for ngit issue create.
- [ngit issue label command reference](/ngit/reference/stable/issue/label): Generated syntax and options for ngit issue label.
- [ngit issue list command reference](/ngit/reference/stable/issue/list): Generated syntax and options for ngit issue list.
- [ngit issue reopen command reference](/ngit/reference/stable/issue/reopen): Generated syntax and options for ngit issue reopen.
- [ngit issue resolved command reference](/ngit/reference/stable/issue/resolved): Generated syntax and options for ngit issue resolved.
- [ngit issue set-cover-note command reference](/ngit/reference/stable/issue/set-cover-note): Generated syntax and options for ngit issue set-cover-note.
- [ngit issue set-subject command reference](/ngit/reference/stable/issue/set-subject): Generated syntax and options for ngit issue set-subject.
- [ngit issue view command reference](/ngit/reference/stable/issue/view): Generated syntax and options for ngit issue view.
- [ngit merge command reference](/ngit/reference/stable/merge): Generated syntax and options for ngit merge.
- [ngit nsite command reference](/ngit/reference/stable/nsite): Generated syntax and options for ngit nsite.
- [ngit nsite publish command reference](/ngit/reference/stable/nsite/publish): Generated syntax and options for ngit nsite publish.
- [ngit pr command reference](/ngit/reference/stable/pr): Generated syntax and options for ngit pr.
- [ngit pr apply command reference](/ngit/reference/stable/pr/apply): Generated syntax and options for ngit pr apply.
- [ngit pr checkout command reference](/ngit/reference/stable/pr/checkout): Generated syntax and options for ngit pr checkout.
- [ngit pr close command reference](/ngit/reference/stable/pr/close): Generated syntax and options for ngit pr close.
- [ngit pr comment command reference](/ngit/reference/stable/pr/comment): Generated syntax and options for ngit pr comment.
- [ngit pr draft command reference](/ngit/reference/stable/pr/draft): Generated syntax and options for ngit pr draft.
- [ngit pr label command reference](/ngit/reference/stable/pr/label): Generated syntax and options for ngit pr label.
- [ngit pr list command reference](/ngit/reference/stable/pr/list): Generated syntax and options for ngit pr list.
- [ngit pr merge command reference](/ngit/reference/stable/pr/merge): Generated syntax and options for ngit pr merge.
- [ngit pr ready command reference](/ngit/reference/stable/pr/ready): Generated syntax and options for ngit pr ready.
- [ngit pr reopen command reference](/ngit/reference/stable/pr/reopen): Generated syntax and options for ngit pr reopen.
- [ngit pr send command reference](/ngit/reference/stable/pr/send): Generated syntax and options for ngit pr send.
- [ngit pr set-cover-note command reference](/ngit/reference/stable/pr/set-cover-note): Generated syntax and options for ngit pr set-cover-note.
- [ngit pr set-subject command reference](/ngit/reference/stable/pr/set-subject): Generated syntax and options for ngit pr set-subject.
- [ngit pr view command reference](/ngit/reference/stable/pr/view): Generated syntax and options for ngit pr view.
- [ngit release command reference](/ngit/reference/stable/release): Generated syntax and options for ngit release.
- [ngit release app command reference](/ngit/reference/stable/release/app): Generated syntax and options for ngit release app.
- [ngit release app init command reference](/ngit/reference/stable/release/app/init): Generated syntax and options for ngit release app init.
- [ngit release app link command reference](/ngit/reference/stable/release/app/link): Generated syntax and options for ngit release app link.
- [ngit release app list command reference](/ngit/reference/stable/release/app/list): Generated syntax and options for ngit release app list.
- [ngit release app view command reference](/ngit/reference/stable/release/app/view): Generated syntax and options for ngit release app view.
- [ngit release asset command reference](/ngit/reference/stable/release/asset): Generated syntax and options for ngit release asset.
- [ngit release asset add command reference](/ngit/reference/stable/release/asset/add): Generated syntax and options for ngit release asset add.
- [ngit release asset list command reference](/ngit/reference/stable/release/asset/list): Generated syntax and options for ngit release asset list.
- [ngit release asset view command reference](/ngit/reference/stable/release/asset/view): Generated syntax and options for ngit release asset view.
- [ngit release list command reference](/ngit/reference/stable/release/list): Generated syntax and options for ngit release list.
- [ngit release publish command reference](/ngit/reference/stable/release/publish): Generated syntax and options for ngit release publish.
- [ngit release view command reference](/ngit/reference/stable/release/view): Generated syntax and options for ngit release view.
- [ngit repo command reference](/ngit/reference/stable/repo): Generated syntax and options for ngit repo.
- [ngit repo accept command reference](/ngit/reference/stable/repo/accept): Generated syntax and options for ngit repo accept.
- [ngit repo edit command reference](/ngit/reference/stable/repo/edit): Generated syntax and options for ngit repo edit.
- [ngit repo follow-lead command reference](/ngit/reference/stable/repo/follow-lead): Generated syntax and options for ngit repo follow-lead.
- [ngit repo init command reference](/ngit/reference/stable/repo/init): Generated syntax and options for ngit repo init.
- [ngit repo leave command reference](/ngit/reference/stable/repo/leave): Generated syntax and options for ngit repo leave.
- [ngit send command reference](/ngit/reference/stable/send): Generated syntax and options for ngit send.
- [ngit skill command reference](/ngit/reference/stable/skill): Generated syntax and options for ngit skill.
- [ngit skill install command reference](/ngit/reference/stable/skill/install): Generated syntax and options for ngit skill install.
- [ngit skill opt-out command reference](/ngit/reference/stable/skill/opt-out): Generated syntax and options for ngit skill opt-out.
- [ngit skill status command reference](/ngit/reference/stable/skill/status): Generated syntax and options for ngit skill status.
- [ngit skill upgrade command reference](/ngit/reference/stable/skill/upgrade): Generated syntax and options for ngit skill upgrade.
- [ngit sync command reference](/ngit/reference/stable/sync): Generated syntax and options for ngit sync.
- [ngit update command reference](/ngit/reference/stable/update): Generated syntax and options for ngit update.
- [ngit account command reference (upcoming)](/ngit/reference/upcoming/account): Generated syntax and options for ngit account.
- [ngit account connect command reference (upcoming)](/ngit/reference/upcoming/account/connect): Generated syntax and options for ngit account connect.
- [ngit account create command reference (upcoming)](/ngit/reference/upcoming/account/create): Generated syntax and options for ngit account create.
- [ngit account export-keys command reference (upcoming)](/ngit/reference/upcoming/account/export-keys): Generated syntax and options for ngit account export-keys.
- [ngit account forget-keys command reference (upcoming)](/ngit/reference/upcoming/account/forget-keys): Generated syntax and options for ngit account forget-keys.
- [ngit account login command reference (upcoming)](/ngit/reference/upcoming/account/login): Generated syntax and options for ngit account login.
- [ngit account logout command reference (upcoming)](/ngit/reference/upcoming/account/logout): Generated syntax and options for ngit account logout.
- [ngit account whoami command reference (upcoming)](/ngit/reference/upcoming/account/whoami): Generated syntax and options for ngit account whoami.
- [ngit ci command reference (upcoming)](/ngit/reference/upcoming/ci): Generated syntax and options for ngit ci.
- [ngit ci request command reference (upcoming)](/ngit/reference/upcoming/ci/request): Generated syntax and options for ngit ci request.
- [ngit ci status command reference (upcoming)](/ngit/reference/upcoming/ci/status): Generated syntax and options for ngit ci status.
- [ngit ci stop command reference (upcoming)](/ngit/reference/upcoming/ci/stop): Generated syntax and options for ngit ci stop.
- [ngit ci trigger command reference (upcoming)](/ngit/reference/upcoming/ci/trigger): Generated syntax and options for ngit ci trigger.
- [ngit command reference (upcoming)](/ngit/reference/upcoming/): Generated syntax and options for ngit.
- [ngit init command reference (upcoming)](/ngit/reference/upcoming/init): Generated syntax and options for ngit init.
- [ngit issue command reference (upcoming)](/ngit/reference/upcoming/issue): Generated syntax and options for ngit issue.
- [ngit issue close command reference (upcoming)](/ngit/reference/upcoming/issue/close): Generated syntax and options for ngit issue close.
- [ngit issue comment command reference (upcoming)](/ngit/reference/upcoming/issue/comment): Generated syntax and options for ngit issue comment.
- [ngit issue create command reference (upcoming)](/ngit/reference/upcoming/issue/create): Generated syntax and options for ngit issue create.
- [ngit issue label command reference (upcoming)](/ngit/reference/upcoming/issue/label): Generated syntax and options for ngit issue label.
- [ngit issue list command reference (upcoming)](/ngit/reference/upcoming/issue/list): Generated syntax and options for ngit issue list.
- [ngit issue reopen command reference (upcoming)](/ngit/reference/upcoming/issue/reopen): Generated syntax and options for ngit issue reopen.
- [ngit issue resolved command reference (upcoming)](/ngit/reference/upcoming/issue/resolved): Generated syntax and options for ngit issue resolved.
- [ngit issue set-cover-note command reference (upcoming)](/ngit/reference/upcoming/issue/set-cover-note): Generated syntax and options for ngit issue set-cover-note.
- [ngit issue set-subject command reference (upcoming)](/ngit/reference/upcoming/issue/set-subject): Generated syntax and options for ngit issue set-subject.
- [ngit issue view command reference (upcoming)](/ngit/reference/upcoming/issue/view): Generated syntax and options for ngit issue view.
- [ngit merge command reference (upcoming)](/ngit/reference/upcoming/merge): Generated syntax and options for ngit merge.
- [ngit pr command reference (upcoming)](/ngit/reference/upcoming/pr): Generated syntax and options for ngit pr.
- [ngit pr apply command reference (upcoming)](/ngit/reference/upcoming/pr/apply): Generated syntax and options for ngit pr apply.
- [ngit pr checkout command reference (upcoming)](/ngit/reference/upcoming/pr/checkout): Generated syntax and options for ngit pr checkout.
- [ngit pr close command reference (upcoming)](/ngit/reference/upcoming/pr/close): Generated syntax and options for ngit pr close.
- [ngit pr comment command reference (upcoming)](/ngit/reference/upcoming/pr/comment): Generated syntax and options for ngit pr comment.
- [ngit pr draft command reference (upcoming)](/ngit/reference/upcoming/pr/draft): Generated syntax and options for ngit pr draft.
- [ngit pr label command reference (upcoming)](/ngit/reference/upcoming/pr/label): Generated syntax and options for ngit pr label.
- [ngit pr list command reference (upcoming)](/ngit/reference/upcoming/pr/list): Generated syntax and options for ngit pr list.
- [ngit pr merge command reference (upcoming)](/ngit/reference/upcoming/pr/merge): Generated syntax and options for ngit pr merge.
- [ngit pr ready command reference (upcoming)](/ngit/reference/upcoming/pr/ready): Generated syntax and options for ngit pr ready.
- [ngit pr reopen command reference (upcoming)](/ngit/reference/upcoming/pr/reopen): Generated syntax and options for ngit pr reopen.
- [ngit pr send command reference (upcoming)](/ngit/reference/upcoming/pr/send): Generated syntax and options for ngit pr send.
- [ngit pr set-cover-note command reference (upcoming)](/ngit/reference/upcoming/pr/set-cover-note): Generated syntax and options for ngit pr set-cover-note.
- [ngit pr set-subject command reference (upcoming)](/ngit/reference/upcoming/pr/set-subject): Generated syntax and options for ngit pr set-subject.
- [ngit pr view command reference (upcoming)](/ngit/reference/upcoming/pr/view): Generated syntax and options for ngit pr view.
- [ngit release command reference (upcoming)](/ngit/reference/upcoming/release): Generated syntax and options for ngit release.
- [ngit release app command reference (upcoming)](/ngit/reference/upcoming/release/app): Generated syntax and options for ngit release app.
- [ngit release app init command reference (upcoming)](/ngit/reference/upcoming/release/app/init): Generated syntax and options for ngit release app init.
- [ngit release app link command reference (upcoming)](/ngit/reference/upcoming/release/app/link): Generated syntax and options for ngit release app link.
- [ngit release app list command reference (upcoming)](/ngit/reference/upcoming/release/app/list): Generated syntax and options for ngit release app list.
- [ngit release app view command reference (upcoming)](/ngit/reference/upcoming/release/app/view): Generated syntax and options for ngit release app view.
- [ngit release asset command reference (upcoming)](/ngit/reference/upcoming/release/asset): Generated syntax and options for ngit release asset.
- [ngit release asset add command reference (upcoming)](/ngit/reference/upcoming/release/asset/add): Generated syntax and options for ngit release asset add.
- [ngit release asset list command reference (upcoming)](/ngit/reference/upcoming/release/asset/list): Generated syntax and options for ngit release asset list.
- [ngit release asset view command reference (upcoming)](/ngit/reference/upcoming/release/asset/view): Generated syntax and options for ngit release asset view.
- [ngit release list command reference (upcoming)](/ngit/reference/upcoming/release/list): Generated syntax and options for ngit release list.
- [ngit release publish command reference (upcoming)](/ngit/reference/upcoming/release/publish): Generated syntax and options for ngit release publish.
- [ngit release view command reference (upcoming)](/ngit/reference/upcoming/release/view): Generated syntax and options for ngit release view.
- [ngit repo command reference (upcoming)](/ngit/reference/upcoming/repo): Generated syntax and options for ngit repo.
- [ngit repo accept command reference (upcoming)](/ngit/reference/upcoming/repo/accept): Generated syntax and options for ngit repo accept.
- [ngit repo edit command reference (upcoming)](/ngit/reference/upcoming/repo/edit): Generated syntax and options for ngit repo edit.
- [ngit repo follow-lead command reference (upcoming)](/ngit/reference/upcoming/repo/follow-lead): Generated syntax and options for ngit repo follow-lead.
- [ngit repo init command reference (upcoming)](/ngit/reference/upcoming/repo/init): Generated syntax and options for ngit repo init.
- [ngit repo leave command reference (upcoming)](/ngit/reference/upcoming/repo/leave): Generated syntax and options for ngit repo leave.
- [ngit send command reference (upcoming)](/ngit/reference/upcoming/send): Generated syntax and options for ngit send.
- [ngit skill command reference (upcoming)](/ngit/reference/upcoming/skill): Generated syntax and options for ngit skill.
- [ngit skill install command reference (upcoming)](/ngit/reference/upcoming/skill/install): Generated syntax and options for ngit skill install.
- [ngit skill opt-out command reference (upcoming)](/ngit/reference/upcoming/skill/opt-out): Generated syntax and options for ngit skill opt-out.
- [ngit skill status command reference (upcoming)](/ngit/reference/upcoming/skill/status): Generated syntax and options for ngit skill status.
- [ngit skill upgrade command reference (upcoming)](/ngit/reference/upcoming/skill/upgrade): Generated syntax and options for ngit skill upgrade.
- [ngit sync command reference (upcoming)](/ngit/reference/upcoming/sync): Generated syntax and options for ngit sync.
- [Understanding Nostr CI](/protocol/ci): Learn the roles, event flow, and trust model behind CI on Nostr, and where the protocol ends and ngit-ci begins.
- [NIP-C1 Nostr CI Specification Guidance](/protocol/ci/guidance): Understand the rationale, roles, trust decisions, publication guidance, and query patterns behind the Nostr CI events.
- [NIP-C1 Nostr CI Specification](/protocol/ci/specification): Read NIP-C1, the CI extension to NIP-34: the signed events exchanged by maintainers, coordinators, compute providers, and clients.
- [GRASP: Git hosting without the gatekeeper](/protocol/grasp): Discover how GRASP turns signed Nostr state into portable, resilient Git hosting for ngit and other clients.
- [GRASP specification](/protocol/grasp/specification): Browse the required GRASP core specification and its optional protocol profiles.
- [GRASP-01: Core service requirements](/protocol/grasp/specification/01): Implement the required relay and Git Smart HTTP behaviour for a GRASP service.
- [GRASP-02: Proactive sync](/protocol/grasp/specification/02): Implement optional proactive synchronisation of repository events and Git data.
- [GRASP-03: Proactive Sync Plus](/protocol/grasp/specification/03): Extend proactive synchronisation to preserve issue, patch, and pull request conversations.
- [GRASP-05: Archive](/protocol/grasp/specification/05): Implement the optional archive profile for backing up or mirroring repositories.
- [GRASP-06: Alternative pull request hosting](/protocol/grasp/specification/06): Host pull request Git data when a repository's own GRASP services cannot accept it.
- [GRASP-08: Private repositories](/protocol/grasp/specification/08): Implement authenticated, read-restricted GRASP services for private repositories.
- [Protocol map](/protocol/): See how Git collaboration, hosting, software publishing, and continuous integration fit together over Nostr.
- [NIP-34 overview](/protocol/nip-34): Understand the Nostr event model for repository announcements, state, patches, pull requests, issues, and status.
- [NIP-34 maintainers](/protocol/nip-34/maintainers): How NIP-34 repository announcements express maintainers, lead maintainers, moderators, invitations, acceptance, and roster history.
- [Maintainer protocol for AI implementers](/protocol/nip-34/maintainers/ai-implementers): Exhaustive implementation guidance for NIP-34 maintainer roles, history, authority, discovery, and edge cases.
- [NIP-34 with multi-maintainer support](/protocol/nip-34/specification): Read the complete proposed NIP-34, including the multi-maintainer roles and history from pull request #2324.
- [Software publishing protocols](/protocol/software-publishing): Understand NIP-82 software releases and ncontainer OCI repositories over Nostr and Blossom.
- [Pull requests](/pull-requests): Open, update, review, stack, and merge pull requests with ngit.
- [ngit quickstart](/quickstart): Create an identity, publish a repository, clone over Nostr, and open a pull request.
- [Glossary](/reference/glossary): Definitions for ngit, Nostr, NIP-34, GRASP, repository state, relays, signers, and related terms.
- [Commands and lookup](/reference/): Find ngit command syntax, configuration, troubleshooting help, and ecosystem definitions.
- [Publish releases with ngit](/releases): Add GitHub Releases-like publishing to a Nostr repository, including Zapstore-compatible APK releases.
- [The release manifest](/releases/manifest): Every field of .ngit/release.yaml, the committed file that tells ngit release what to publish and where.
- [Publish an nsite](/releases/nsites): Choose between nsyte and ngit, publish a built NIP-5A site, and expose disposable pull-request previews in GitWorkshop.
- [Repositories](/repositories): Publish, clone, inspect, edit, and synchronise an ngit repository.
- [Mirroring to GitHub or another forge](/repositories/mirroring): Keep a copy of an ngit repository on GitHub or Codeberg while the signed nostr state stays authoritative.
- [Private repositories](/repositories/private): Create and access a private repository through a self-hosted GRASP-08 service, and understand its trust boundary.
- [Roadmap](/roadmap): Read the ngit project family's direction for private repository providers, CI providers, and open source moderation.
- [Self-host ngit services](/self-host/): Choose whether to host repositories with ngit-grasp, run CI with ngit-ci, or operate both.
- [Run ngit-ci](/self-host/ngit-ci): Run the reference Nostr CI coordinator. Choose a deployment, configure it, gate execution and secrets, and protect the boundaries that matter.
- [Configure ngit-ci](/self-host/ngit-ci/configure/): Configure the ngit-ci coordinator and keep its separately prefixed microVM adapter settings distinct.
- [Deploy with Docker or Podman](/self-host/ngit-ci/deploy/docker): Deploy ngit-ci with the repository's container image and either its recommended Docker-in-Docker sidecar or a host daemon socket.
- [Run the microVM adapter](/self-host/ngit-ci/deploy/microvm): Run untrusted CI jobs in fresh QEMU/KVM microVMs with the first-party sandbox adapter.
- [Deploy on NixOS](/self-host/ngit-ci/deploy/nixos): Deploy the coordinator and microVM sandbox adapter with the repository's NixOS modules and packages.
- [Deploy in a Proxmox LXC](/self-host/ngit-ci/deploy/proxmox): Run ngit-ci in a Debian or Ubuntu Proxmox LXC with Docker Compose.
- [Coordinator configuration constraints](/self-host/ngit-ci/reference/upcoming/coordinator-constraints): Generated validation and relationship rules for the ngit-ci coordinator.
- [Coordinator secret sources and resolution](/self-host/ngit-ci/reference/upcoming/coordinator-secrets): Generated secret discovery, grouped precedence, and qualified resolution rules for ngit-ci.
- [Coordinator command and configuration](/self-host/ngit-ci/reference/upcoming/coordinator): Generated command-line and runtime configuration reference for the ngit-ci coordinator.
- [ngit-ci generated reference](/self-host/ngit-ci/reference/upcoming/): Generated coordinator and microVM adapter reference for ngit-ci operators.
- [microVM adapter configuration constraints](/self-host/ngit-ci/reference/upcoming/microvm-adapter-constraints): Generated validation and relationship rules for the ngit-ci microvm adapter.
- [microVM adapter command and configuration](/self-host/ngit-ci/reference/upcoming/microvm-adapter): Generated command-line and runtime configuration reference for the ngit-ci microvm adapter.
- [Host repositories with ngit-grasp](/self-host/ngit-grasp): Choose a deployment, protect secrets and storage, and verify an ngit-grasp service.
- [Audit a GRASP service](/self-host/ngit-grasp/audit): Use grasp-audit to check a GRASP relay and its Git endpoints for configuration and protocol issues.
- [Deploy with Docker or Podman](/self-host/ngit-grasp/deploy/docker): Deploy ngit-grasp with Compose and optional automatic HTTPS.
- [Deploy ngit-grasp](/self-host/ngit-grasp/deploy/): Choose a supported production deployment for ngit-grasp.
- [Deploy a static binary with systemd](/self-host/ngit-grasp/deploy/linux): Deploy a pinned ngit-grasp binary as a hardened Linux service.
- [Deploy ngit-grasp on NixOS](/self-host/ngit-grasp/deploy/nixos): Deploy and operate ngit-grasp through its NixOS module.
- [Deploy on managed hosting](/self-host/ngit-grasp/deploy/paas): Deploy ngit-grasp on a compatible managed container platform.
- [Deploy in a Proxmox LXC container or VM](/self-host/ngit-grasp/deploy/proxmox): Run ngit-grasp inside a Proxmox guest using systemd or Compose.
- [Monitoring](/self-host/ngit-grasp/operate/monitoring): Understand ngit-grasp metrics, health states, and monitoring architecture.
- [Prometheus and Grafana setup](/self-host/ngit-grasp/operate/prometheus): Collect ngit-grasp metrics and provision dashboards and alerts.
- [Upgrade from v2 to v3 Git family storage](/self-host/ngit-grasp/operate/storage-upgrade): Plan, verify, and recover the ngit-grasp v2 to v3 storage migration.
- [GRASP-08 private service authentication](/self-host/ngit-grasp/private-service/): Understand the trust and authentication model for a private GRASP service.
- [Deployment contract](/self-host/ngit-grasp/reference/deployment-contract): Review the runtime, persistence, identity, and upgrade contract for ngit-grasp.
- [ngit-grasp cleanup-empty-repos command reference (stable)](/self-host/ngit-grasp/reference/stable/commands/cleanup-empty-repos): Generated syntax and options for ngit-grasp cleanup-empty-repos.
- [ngit-grasp holding-eject command reference (stable)](/self-host/ngit-grasp/reference/stable/commands/holding-eject): Generated syntax and options for ngit-grasp holding-eject.
- [ngit-grasp command reference (stable)](/self-host/ngit-grasp/reference/stable/commands/): Generated syntax and options for ngit-grasp.
- [ngit-grasp integrity-check command reference (stable)](/self-host/ngit-grasp/reference/stable/commands/integrity-check): Generated syntax and options for ngit-grasp integrity-check.
- [ngit-grasp serve command reference (stable)](/self-host/ngit-grasp/reference/stable/commands/serve): Generated syntax and options for ngit-grasp serve.
- [ngit-grasp configuration reference (stable)](/self-host/ngit-grasp/reference/stable/configuration): Generated environment, command-line, default, scope, and reload metadata for ngit-grasp.
- [ngit-grasp configuration constraints (stable)](/self-host/ngit-grasp/reference/stable/constraints): Generated validation and relationship rules for ngit-grasp configuration.
- [ngit-grasp generated reference (stable)](/self-host/ngit-grasp/reference/stable/): Generated command and runtime-configuration reference for ngit-grasp operators.
- [ngit-grasp secret precedence (stable)](/self-host/ngit-grasp/reference/stable/secret-precedence): Generated relay-owner secret discovery order for ngit-grasp operators.
- [Troubleshooting ngit](/troubleshooting): Diagnose missing remote helpers, cold caches, pull request mistakes, timeouts, and ref divergence.
- [v3 launches](/v3): See what shipped across ngit v3, ngit-grasp v3, ngit-ci 0.1, and GitWorkshop v4.
- [Maintainer authority in ngit v3](/v3/maintainer-model): Why ngit and ngit-grasp v3 and GitWorkshop v4 wait for a maintainer to accept an invitation before trusting their Git state.
- [Why ngit?](/why-ngit): Learn why ngit makes Git collaboration portable across hosting providers.