Download Forage.
Free for 30 days.

Download and extract the archive

Click the button above to download forage-win.zip. Extract it to get two files: forage-win.exe and vec0.dll. No installer, no runtime required — just these two files.

Place both files on your PATH

Move both forage-win.exe and vec0.dll to the same folder on your system PATH — for example a personal C:\Users\YourName\bin\ folder you have added to PATH. The two files must stay in the same directory.

Tip: You can rename forage-win.exe to forage.exe so you can type forage in any terminal.

Open a terminal and initialise your project

Navigate to the root of a codebase you want to index, then run:

forage --init

Forage will scan the directory and build the initial knowledge graph. The web UI will open automatically at http://localhost:9988.

Connect your AI agent

Point Claude Code, Cursor, Windsurf, or any MCP-compatible agent at the MCP server:

http://localhost:9989/mcp

You can find your API key in the Forage web UI under Settings → API Key

Download and extract the archive

Click the button above to download forage-macos.tar.gz. Extracting it gives you two files: forage-macos and vec0.dylib. No installer, no Homebrew, no runtime required — just these two files.

Make it executable and move both files to your PATH

Open Terminal and run:

cd ~/Downloads
chmod +x forage-macos
sudo mv forage-macos /usr/local/bin/forage
sudo mv vec0.dylib /usr/local/bin/vec0.dylib

Both files must live in the same directory. If /usr/local/bin does not exist, create it first with sudo mkdir -p /usr/local/bin.

Allow the binary through Gatekeeper (first run only)

Because Forage is not yet distributed through the Mac App Store, macOS will block the first run. After seeing the warning, open System Settings → Privacy & Security, scroll down, and click Allow Anyway next to the Forage entry. Then run Forage again — this time click Open in the dialog.

Alternatively, right-click (or Control-click) the binary in Finder and choose Open to bypass Gatekeeper in one step.

Initialise your project

Navigate to the root of a codebase you want to index, then run:

forage --init

Forage will scan the directory and build the initial knowledge graph. The web UI will open automatically at http://localhost:9988.

Connect your AI agent

Point Claude Code, Cursor, Windsurf, or any MCP-compatible agent at the MCP server:

http://localhost:9989/mcp

You can find your API key in the Forage web UI under Settings → API Key

Download and extract the archive

Click the button above to download forage-linux.tar.gz. Extracting it gives you two files: forage-linux and vec0.so. No installer, no runtime required — runs on any x64 Linux distribution.

Make it executable and move both files to your PATH

cd ~/Downloads
chmod +x forage-linux
sudo mv forage-linux /usr/local/bin/forage
sudo mv vec0.so /usr/local/bin/vec0.so

Both files must live in the same directory.

Initialise your project

Navigate to the root of a codebase you want to index, then run:

forage --init

Forage will scan the directory and build the initial knowledge graph. The web UI will open at http://localhost:9988.

Connect your AI agent

Point Claude Code, Cursor, Windsurf, or any MCP-compatible agent at the MCP server:

http://localhost:9989/mcp

You can find your API key in the Forage web UI under Settings → API Key