No installer, no runtime required. Extract the archive, keep the two files together, and you're running in under a minute.
Windows 10 or later ยท x64
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.
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.
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.
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
Ubuntu 20.04+ ยท Debian ยท Fedora ยท Arch ยท any x64 distro
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.
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.
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.
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
| 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). |
Next steps
The Getting Started guide walks you through your first workspace and connecting your AI coding agent.
Getting Started โCreate a free account to start your trial and get your license key.
Create Account โ