Skip to content
Documentation
Getting started
Configuration
Capabilities
Control
Reference

Installation

Install the CLI, and what the install script actually does.

Requirements

  • macOS or Linux. Windows works under WSL2; native Windows is not supported.
  • Python 3.11+. If you have none, uv fetches a suitable interpreter.
  • git, for the install and for Forge's git tools afterwards.
  • An Anthropic API key, or any Anthropic-compatible gateway you already use.

Install script

$ curl -fsSL https://forge.tusharumbarkar.space/install.sh | sh

The script is a single POSIX sh file. It:

  • Stops on anything that is not macOS or Linux.
  • Checks for git, and installs uv if you do not already have it.
  • Installs Forge as an isolated tool, leaving your system Python untouched.
  • Runs forge --version to confirm the install, and tells you if the binary is not yet on your PATH.

To read it before running it:

$ curl -fsSL https://forge.tusharumbarkar.space/install.sh -o install.sh$ less install.sh$ sh install.sh

Forge treats curl | sh as a destructive pattern and will stop and ask before running one on your behalf. The same caution applies to the one above.

With uv

If you already have uv, this is the whole install.

$ uv tool install git+https://github.com/codesensei-tushar/forge

From source

For working on Forge itself.

$ git clone https://github.com/codesensei-tushar/forge$ cd forge$ uv sync$ uv run forge --version

pip and pipx

The distribution name forge-code is reserved in pyproject.toml but no wheel has been published yet, so pip install forge-code will not work today. Use the install script or uv until it does.

Verifying

$ forge --version$ forge config

forge config prints the resolved configuration with secrets redacted - the fastest way to confirm which model, workspace, approval mode, and sandbox you are about to run with.

If forge is not found

The binary lives in uv's tool bin directory. Add it to your shell profile with uv tool update-shell, then open a new shell.

Uninstalling

$ uv tool uninstall forge

The tool is registered under the name of its source, so a git install uninstalls as forge rather than forge-code. uv tool list shows what you have.