Install GraphForge

The GraphForge command is gf. These steps install version 0.6.0.

npx (recommended)

Needs Node.js 20 or newer: download Node.js (opens in a new tab).

In your project folder, install the GraphForge agent skills:

npx @curatelabs/graphforge-cli@0.6.0 skills install

In an empty folder, npx @curatelabs/graphforge-cli@0.6.0 init sets up GraphForge there, skills included.

To type gf, install it globally:

npm install -g @curatelabs/graphforge-cli@0.6.0

Python

Needs uv: install uv (opens in a new tab).

uv tool install "graphforge==0.6.0"

Rust

To install gf with Rust's cargo, follow the graphforge-cli crate quickstart (opens in a new tab).

Sign in and publish

Just ran init? Set an author, create a Branch and commit a first Version, then push: Share with gf in the GraphForge docs (opens in a new tab).

Sign in once, then push from your Project folder:

gf auth login

Hub: graphforge.sh

gf push <owner>/<name>

Hub: graphforge.sh

Pushing to a Project that doesn't exist yet creates it: gf push asks Public or Private, or takes --public or --private. Public is free; private needs a plan.

Troubleshooting

gf runs git fetch

Oh My Zsh's git plugin makes gf an alias for git fetch. Check with type gf. If it says “gf is an alias for git fetch”, run unalias gf, and add that line to the end of ~/.zshrc to keep it.