Skip to main content
packs.lock records the commit each release tag pointed at when it was installed. A published release must never move: when the repository’s copy of a recorded tag now points elsewhere, or a clone checks out a different commit than git ls-remote reported, the install is refused and nothing changes. Branch-tracking packs are exempt.

Arguments

string
required
A bare name (the <name> directory of github.com/tylerdavis/graph-packs) or a git URL; a name already in [packs] installs that entry

Options

string
The pack’s directory inside the repository, whose releases are the tags <DIR>/vX.Y.Z; default: the repository root (a bare name’s own directory)Format: DIR.
string
Install under this name instead of the manifest’sFormat: NAME.
string
A major line (v2), an exact release (v2.1.0, pinned) or a branch; default: the newest releaseFormat: REF.
boolean
Target the global layer (~/.config/graph/) instead of the project’s ./.graph/
string
Target this graph directory, laid out like .graph/ (config.toml, packs/, packs.lock)Format: PATH.
boolean
Print a JSON envelope instead of text

Global options

integer
Increase log verbosity (-v info, -vv debug, -vvv trace)