e4d91aadf9
- Full Obsidian vault content - Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte) - Media stack documentation - Traefik HA setup - Automation scripts - Bachelor party planning
2.8 KiB
type, agent, source, scraped, content_hash
| type | agent | source | scraped | content_hash |
|---|---|---|---|---|
| agent-doc | ForgeCode | https://forgecode.dev/docs/ | 2026-04-28T21:02:33.702132+00:00 | 58b4bfb7 |
Installation & Setup
ForgeCode is a CLI-based coding harness — 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)
- 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. Log in to an AI provider
ForgeCode needs access to at least one AI model. Run:
:login
This walks you through selecting a provider and entering your API key.
If you already have a ChatGPT Plus or Claude subscription, select the corresponding provider (OpenAI or Anthropic) and use that subscription's API access instead of buying a separate key.
-
OpenRouter — one key, 300+ models from every major vendor
-
OpenAI — GPT Codex series
-
Anthropic — Claude Sonnet and Opus series
-
Proprietary: Claude Sonnet & Opus series, GPT Codex series
-
Open-source: GLM, Kimi, Minimax
After logging in, pick a model:
:model
Browse the list, type to filter, and press Enter. ForgeCode remembers your choice across sessions. You can change it anytime.
Step 4. Send your first prompt
With the Zsh plugin active and the LLM provider set up, type : followed by a space and your prompt:
: Hi! What is the time?
ForgeCode takes it from there.
Step 5. Explore available commands
To see all available ForgeCode commands, type : and press Tab (without space):
: # then press Tab WITHOUT space
This lists every command you can run directly from your shell.
Next Steps
Once you're set up, enable ForgeCode Services for enhanced codebase understanding, tool-call guardrails, and a semantic search engine — no API key required.