Metadata-Version: 2.4
Name: forgeweave
Version: 2.0.0
Summary: Agent orchestration framework — project scaffolding, template distribution, AGENTS.md rules
Author-email: ForgeWeave Core <team@forgeweave.dev>
License: MIT
Project-URL: Homepage, https://github.com/Razaib-khan/forgeweave
Project-URL: Documentation, https://github.com/Razaib-khan/forgeweave
Project-URL: Repository, https://github.com/Razaib-khan/forgeweave
Keywords: agent,orchestration,scaffolding,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: inquirerpy>=0.3
Provides-Extra: playwright
Requires-Dist: playwright>=1.40; extra == "playwright"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Dynamic: license-file

# ForgeWeave

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

`pip install forgeweave` or `uv add forgeweave`

## Quick Start

```bash
# 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

| Component | Description |
|---|---|
| **AGENTS.md** | Global behavioral rules for all coding agents, dynamically marking which MCP servers are available |
| **Skills** | 20+ domain-specific skill bundles (deep-research, playwright-mcp, skill-builder, etc.) |
| **Commands** | 8 predefined `/forge-*` commands (forge-start, forge-research, forge-search, etc.) |
| **Agents** | Worker definitions for autonomous sub-agents (research pipeline, code review, etc.) |
| **Hooks** | Lifecycle hooks for TUI-native orchestration |
| **MCP configs** | Pre-configured Playwright (mandatory), Headroom (mandatory), and optional servers (Firecrawl, GitHub, SQLite, Context7) |

### 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
