djtoon

Pi Forge — AI skill for Claude Code

AI community

The harness that builds harnesses: tell it about your work and it builds a custom AI agent with its own tools, views, skills and UI.

How to install Pi Forge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open djtoon/pi-forge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Pi Forge does

The harness that builds harnesses: tell it about your work and it builds a custom AI agent with its own tools, views, skills and UI. Runs in the browser, terminal, headless, or as a standalone app. Built on pi.

Alternatives in AI

  • AIHawk — Open-source AI browser agent: describe any task in plain language and it autonomously browses, clicks, types a 30.3k ★
  • Claude Squad — by smtg-ai - Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents i 6.5k ★
  • HolyClaude — AI coding workstation: Claude Code + web UI + 7 AI CLIs + headless browser + 50+ tools 2k ★

README

pi-Forge: the harness that builds harnesses

pi-Forge

**pi-Forge is an agent harness that builds agent harnesses**, on top of [pi](https://github.com/earendil-works/pi).

Tell it about your work. It interviews you, then generates a custom agent for that work: specialized tools, a system prompt, guardrails, a theme, a logo, and **domain views** (a 3D molecule viewer, charts, tables, a pixel-sprite editor…). Every harness it builds runs:

  • in a browser UI with your views, a live plan, and file outputs
  • in the terminal
  • headless (-p, JSON event stream, RPC), for scripts and other apps
  • as a standalone program you can zip and share (no Node needed)

The command is `forge`.


Quick start

**You need:** [Node.js](https://nodejs.org) 22.18 or newer, [Git](https://git-scm.com) (on Windows, Git for Windows, whose Git Bash the agent uses), and an API key for a model provider. [Bun](https://bun.sh) is optional and only needed to package harnesses as programs.

git clone https://github.com/djtoon/pi-forge.git
cd pi-forge
npm install
npm run doctor            # checks Node, Git Bash, Bun and your model provider

**Set up a model provider**, either way:

  • Environment: set ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, or AWS credentials for Bedrock (AWS_PROFILE, or AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, plus AWS_REGION).
  • Settings page: start the web UI and add the key under Settings → Model providers. It's saved in ~/.forge/credentials.json on your machine.

**Start pi-Forge:**

npm run forge -- web      # browser UI (opens http://127.0.0.1:4317)
npm run forge             # or the terminal UI

Then describe what you need, for example *"build me a harness for planning 3D prints"* or *"I want an agent that helps me with chemistry research"*. pi-Forge:

  1. asks you a few rounds of questions
  2. pr