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.
  • ngit and GitWorkshop are clients that consume compatible services.

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

Profiles

ProfileRoleRequirement
GRASP-01Core Git service authorised by signed repository stateRequired
GRASP-02Proactive synchronisationOptional
GRASP-03Proactive Sync PlusOptional
GRASP-05Archive behaviourOptional
GRASP-06Alternative pull request hostingOptional
GRASP-08Private repository serviceOptional

The future gitgrasp.com protocol site should render the normative specification separately from operator explanations and mark requirement language clearly. ngit.dev keeps this concise protocol map beside the ngit-grasp operator guide.

Git collaboration, without the platform.