Now in beta โ€” free to download

Download Forage.
Free for 30 days.

No installer, no runtime required. Extract the archive, keep the two files together, and you're running in under a minute.

W

Windows

Windows 10 or later ยท x64

Download forage-win.zip
1
Download and extract the archive

Click the button above to download forage-win.zip. Extract it to get files: forage.exe, rg-win.exe, squrl-updater.exe, and vec0.dll. No installer, no runtime required โ€” just these 4 files.

2
Place both files on your PATH

Move forage.exe, rg-win.exe, squrl-updater.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.

3
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.

4
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

L

Linux

Ubuntu 20.04+ ยท Debian ยท Fedora ยท Arch ยท any x64 distro

Download forage-linux.tar.gz
1
Download and extract the archive

Click the button above to download forage-linux.tar.gz. Extracting it gives you 4 files: forage-linux, rg-linux, squrl-updater, and vec0.so. No installer, no runtime required โ€” runs on any x64 Linux distribution.

2
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 squrl-updater /usr/local/bin/squrl-updater
sudo mv rg-linux /usr/local/bin/rg-linux
sudo mv vec0.so /usr/local/bin/vec0.so

All files must live in the same directory.

3
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.

4
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

System requirements
Architecture x64 (64-bit). ARM builds are on the roadmap.
Windows Windows 10 or later
Linux Any x64 distribution. The binary is statically linked with musl and has no shared-library dependencies.
Memory 512 MB minimum. 2 GB recommended for large codebases (>100k files).
Ports 9988 (web UI) and 9989 (MCP server) must be available. Both are configurable from Settings.
Internet Required at startup for license verification. Not required during normal operation (unless using a cloud inference provider).

Ready to go?
Here's what to do next.

1

Read the docs

The Getting Started guide walks you through your first workspace and connecting your AI coding agent.

Getting Started โ†’
2

Configure

Step-by-step config docs for connecting Forage to your stack.

Configuration โ†’
3

Register for free

Create a free account to start your trial and get your license key.

Create Account โ†’