forge

Forge

Go CLI that executes a development plan file end-to-end, fire-and-forget.

forge run plans/auth.md

One command: creates a Jira issue, branches, runs Claude Code headless, opens a PR, handles code review feedback, and notifies via Slack.

Install

Homebrew (macOS/Linux)

brew tap shahar-caura/tap
brew install forge

Binary (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/shahar-caura/forge/master/install.sh | bash

From source

go install github.com/shahar-caura/forge/cmd/forge@latest

GitHub Release

gh release download --repo shahar-caura/forge --pattern '*darwin_arm64*'
tar xzf forge_*_darwin_arm64.tar.gz
sudo mv forge /usr/local/bin/

Prerequisites

• git and gh (GitHub CLI) — authenticated via gh auth login
• claude (Claude Code CLI) — requires an Anthropic subscription

Note: claude is a paid subscription tool. The test suite mocks it, so contributors can develop without it.

Quick Start

# Initialize config
forge init

# Write a plan
cat > plans/my-feature.md <<'EOF'
---
title: Add health check endpoint
---
Add a /healthz endpoint that returns 200 OK with a JSON body.
EOF

# Execute it
forge run plans/my-feature.md

# Check status
forge runs
forge status <run-id>

Commands

Configuration

All config lives in forge.yaml. Run forge init to generate it interactively.

Secrets go in .forge.env (project-local) and ~/.config/forge/env (global). See the project structure for details.

Development

git clone https://github.com/shahar-caura/forge.git
cd forge
make build    # Build binary
make test     # Run tests
make lint     # Run linter
make fmt      # Format code

See CONTRIBUTING.md for more details.

License

MIT