Skip to content

Design

The authoritative design lives in the repository at docs/planning/gnit-design.md.

The locked decisions are recorded in docs/decisions/:

  • Name and scope: gnit.
  • Change and Pin are co-primary.
  • gnit land is the canonical human publish verb.
  • Hooks are not installed by default.
  • A nitted repo announces itself to agents through a managed, version-stable block in AGENTS.md/CLAUDE.md, written on gnit init and repaired by gnit doctor.
  • The public site deploys from site/ on pushes to master once GitHub Pages is configured.
  • The CLI is Rust, distributed as a single binary, with Clawdapus-style install/update/release ergonomics.

The central principle is reconstruct-not-enforce: Git remains the source of truth, and Gnit rebuilds the workspace graph from ordinary Git commits, trailers, the roster, and Pin artifacts.

Gnit is an early design for Git-native multi-repo workspaces.