Forge (Gitpod MVP)

This repo is a minimal Forge v0 test bed using Gitpod as the shared session container.

What this gives you

• One shared container
• Shared VS Code-like editor + terminal
• A tiny Claude overseer script that reads context and writes output back to disk

Quick start

1. Create a Gitpod workspace from this repo.
2. In the Gitpod terminal:

pip install -r requirements.txt

3. Set your Claude API key (and optional model):

export ANTHROPIC_API_KEY="your_key_here"
export CLAUDE_MODEL="claude-3-5-sonnet-20241022"

4. Edit FORGE_CONTEXT.md with the current task.
5. Run the overseer:

python scripts/forge_agent.py

Claude writes the response to CLAUDE_OUTPUT.md.

Collaboration

Invite your collaborator in Gitpod, and you both attach to the same workspace.

Files

• FORGE_CONTEXT.md: shared task state
• CLAUDE_OUTPUT.md: Claude output
• scripts/forge_agent.py: minimal overseer
• .gitpod.yml: Gitpod setup