Reference
CLI
The `granary-ai` npm package installs `granary`. It supports local/Git sources, locked restoration, reviewed updates, and standards conversion. Requires Node.js 26+ and Git; macOS and Linux are supported.Client and core API
`granary-ai` combines SDK exports, optional plugin subpaths, and the `granary` executable. Importing its root never starts the CLI. The workspace separates `@granary/core`, `@granary/sdk`, `@granary/cli`, and `@granary/plugins`; these component packages remain private and have not been independently published.Pack manifest
An installable pack's `granary.json` describes files and included packs. Only `name` is required; the same contract configures consumer projects through the `granary-ai` CLI and SDK.Presets
A recommended set is a pack containing other `packs`. Membership is recursive and explicit; directory discovery does not imply inclusion.Project configuration
`granary.json` describes authored packs and adopted source material. Only `name` is required. Put source-backed selections and named inline definitions under `packs`. The `granary-ai` CLI and SDK use the same contract.Separate upstream sources
A curated `granary.json` composes selected material from other repositories. It uses the same manifest contract as a portable pack or consumer project; there is no separate definition format.Sources
Local directories and Git repositories supply reference material. Sources can own a `granary.json`, but participation is optional: consumers can select ordinary repository files themselves.