Installation
CmdForge requires Python 3.8+ and works on Linux, macOS, and Windows.
Install with pip
The simplest way to install CmdForge:
pip install cmdforgeOr with pipx for isolated installation:
pipx install cmdforgeVerify Installation
cmdforge --version
cmdforge --helpConfigure a Provider
CmdForge needs at least one AI provider configured. The easiest is Claude CLI:
# Install Claude CLI (if you have an Anthropic API key)
pip install claude-cli
# Or use OpenAI
pip install openai
# Configure your provider
cmdforge configWrapper Scripts Location
CmdForge installs wrapper scripts to ~/.local/bin/. Make sure this is in your PATH:
# Add to ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"Development Installation
To contribute or modify CmdForge:
git clone https://gitea.brrd.tech/rob/CmdForge.git
cd CmdForge
pip install -e ".[dev]"