Installation & Setup
ForgeCode is a CLI-based coding agent — think Claude Code, but with first-class support for many AI providers. It works equally well with cloud models, open-weight models, and models running locally.
Prerequisites
- A Nerd Font installed and enabled in your terminal (for example, FiraCode Nerd Font)
- Oh My Zsh installed and configured
Installation
Step 1. Install the ForgeCode binary
curl -fsSL https://forgecode.dev/cli | sh
This works on macOS, Linux, Android, and Windows via WSL or Git Bash.
Verify the installation:
forge --help
Step 2. Configure the Zsh plugin
ForgeCode integrates with Zsh to let you send prompts directly from your shell prompt. Run the setup wizard:
forge zsh setup
Follow the interactive prompts. Once complete, you must restart your terminal for the plugin to take effect. Open a new terminal window, or reload the current session:
exec zsh
The Zsh plugin will not be active until you restart your terminal. If the : prompt trigger isn't working, this is the most common cause.
If you're still having trouble, run the diagnostics command:
forge zsh doctor
This checks your environment and reports any configuration issues with the Zsh plugin.
Step 3. Send your first prompt
With the Zsh plugin active, type : followed by a space and your prompt:
: Hi! What is the time?
ForgeCode takes it from there.
Step 4. Explore available commands
To see all available ForgeCode commands, type : and press Tab:
: # then press Tab without space
This lists every command you can run directly from your shell.