Skip to content

GRASP protocol overview

GRASP, Git Relays Authorised via Signed-Nostr Proofs, is a protocol, not a server product. It defines how signed Nostr state can authorise Git hosting and how clients discover server capabilities.

Specification and implementation

  • grasp owns the portable protocol specifications.
  • ngit-grasp is one implementation and owns its deployment, configuration, operations, monitoring, and internal architecture docs.
  • Grasp Awesome lists projects that implement GRASP, including Pyramid and n34-relay, which are not yet feature-complete.
  • ngit and GitWorkshop are two clients, among others, that consume compatible services.

Keeping those boundaries visible prevents an implementation setting from being mistaken for a protocol requirement.

Specification

The specification is organised as one required core profile and optional profiles. Read the GRASP specification for the profile map and normative Markdown imported from the pinned grasp revision.

For implementation choices and operational procedures, continue to the ngit-grasp operator guide. To use GRASP-08 as a client, see Private repositories.