ForgeWeave

Agent orchestration framework — project scaffolding, template distribution, and AGENTS.md global rules.

pip install forgeweave or uv add forgeweave

Quick Start

# Initialize a ForgeWeave project
forge init --tui opencode ./my-project
cd my-project

# Check your setup
forge doctor

Architecture

ForgeWeave is a scaffolding tool — Templates + Rules + Skills. No server.

forge init    → Copies TUI-specific templates into your project
              → Configures MCP servers (Playwright, Headroom, Firecrawl, etc.)
              → Generates AGENTS.md with dynamic MCP availability markers
forge doctor  → Verifies environment prerequisites

What forge init generates

Supported TUIs

• OpenCode — .opencode/ directory, JSON config
• Claude Code — .claude/ directory, JSON settings
• Gemini CLI — .gemini/ directory, JSON settings
• Qwen Code — .qwen/ directory, extension JSON

Design

• Determinism — Same input always produces the same output
• Template-driven — All scaffolding comes from versioned templates
• No hidden state — All I/O is declared and logged
• Adapters are boundaries — Business logic never leaks into TUI formats

License

MIT