> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Reference


[CLIThe `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.](/reference/cli)[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.](/reference/core-api)[Pack manifestAn 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.](/reference/pack-manifest)[PresetsA recommended set is a pack containing other `packs`. Membership is recursive and explicit; directory discovery does not imply inclusion.](/reference/presets)[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.](/reference/project-config)[Separate upstream sourcesA 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.](/reference/pack-definition)[SourcesLocal directories and Git repositories supply reference material. Sources can own a `granary.json`, but participation is optional: consumers can select ordinary repository files themselves.](/reference/sources)