Skip to main content
Version: 0.0.5

Install

How to install, verify, upgrade, and remove the graft binary.

Install methods​

From source​

go install github.com/Shaik-Sirajuddin/graft/cmd/graft@latest

This builds the graft binary into your $GOBIN (usually ~/go/bin). Ensure that directory is on your PATH.

Homebrew (planned)​

brew install graft

npm (planned)​

npm install -g graft

Verify​

graft --version
graft --help

Upgrade​

Using graft update​

The easiest way to upgrade an existing installation:

graft update

This checks the GitHub releases API and installs a newer binary if one is available. To check without installing:

graft update --check

graft update works outside an initialized workspace — it does not need a .graft/ directory.

Manually (from source)​

go install github.com/Shaik-Sirajuddin/graft/cmd/graft@latest

Uninstall​

Remove the binary from your $GOBIN/PATH:

rm "$(command -v graft)"

graft also keeps a per-project store at .graft/ and a global sqlite database. To fully remove graft state from a project, run graft destroy first (this removes the workspace row from the global database and the .graft/ directory while keeping your provider files), then delete .graft/ if anything remains:

graft destroy --yes

See graft destroy --help and the CLI reference.

Platform notes​

macOS and Windows are both supported. On Windows, symlink creation for skills requires Developer Mode or Administrator privileges. Without those, graft skill commands report a capability error rather than silently creating a file copy. See Skills.

Outbound network access​

  • graft update and graft update --check contact api.github.com/repos/Shaik-Sirajuddin/graft/releases/latest.
  • The embedded catalog is offline-first; graft catalog verify runs entirely offline.
  • Some providers' model resolution may contact models.dev at build time (not at runtime).

See Endpoints for the full list.

Next​