Installation

Release binaries and the container image

graph ships as a single binary and a container image — grab whichever fits. Current release: v0.11.0.

Release binaries

Tagged releases publish binaries for macOS (arm64) and Linux (x86_64) with SHA-256 checksums.

macOS (arm64)

Download graph-v0.11.0-macos-arm64.tar.gz

Linux (x86_64)

Download graph-v0.11.0-linux-x86_64.tar.gz

Or from the command line:

macOS (arm64)

curl -fsSLO "https://github.com/tylerdavis/graph/releases/download/v0.11.0/graph-v0.11.0-macos-arm64.tar.gz"
tar xzf graph-*.tar.gz && install -m 0755 graph ~/.local/bin/
graph --help

Linux (x86_64)

curl -fsSLO "https://github.com/tylerdavis/graph/releases/download/v0.11.0/graph-v0.11.0-linux-x86_64.tar.gz"
tar xzf graph-*.tar.gz && install -m 0755 graph ~/.local/bin/
graph --help

On macOS, the first run of a freshly downloaded binary pauses ~1s while Gatekeeper scans it. Every run after that is instant.

Container image

Each release also publishes ghcr.io/tylerdavis/graph (tags vX.Y.Z, X.Y, latest): the Linux binary plus git, jq, gh, and curl — everything the github and slack tool packs shell out to. It doubles as the runtime for CI jobs (no install step) and works standalone:

docker run --rm -e ANTHROPIC_API_KEY -e GRAPH_STORAGE=memory \
  -v "$PWD:/work" -w /work ghcr.io/tylerdavis/graph:v0.11.0 plan list

While the repository is private the image is too — docker login ghcr.io with a token that has read:packages first (CI jobs use the workflow’s GITHUB_TOKEN).

Requirements

Requirement	Notes
macOS (arm64) or Linux (x86_64)	the platforms release binaries are published for
An LLM provider key	e.g. ANTHROPIC_API_KEY — see Quickstart

First-run notes

• graph creates its data directory at ~/.local/share/graph/ on first use (configurable via [settings] data_dir).
• State is plain files under the data directory, safe under concurrent runs. Use GRAPH_STORAGE=memory for ephemeral runs that should leave nothing behind — see Storage.