Metadata-Version: 2.4
Name: forgeweave
Version: 1.0.0
Summary: Framework-agnostic agent orchestration layer — 12 forge.* MCP tools
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: mcp,agent,orchestration,research,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp<1.0,>=0.4
Requires-Dist: pydantic<3.0,>=2.0
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: beautifulsoup4<5.0,>=4.12
Requires-Dist: trafilatura<2.0,>=1.6
Requires-Dist: aiohttp<4.0,>=3.9
Requires-Dist: chromadb<1.0,>=0.5
Requires-Dist: diskcache<6.0,>=5.6
Requires-Dist: markitdown<1.0,>=0.1
Requires-Dist: PyMuPDF<2.0,>=1.23
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

Framework-agnostic agent orchestration layer — **12 forge.\* MCP tools**.

`pip install forgeweave` or `uv add forgeweave`

## Quick Start

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

# Start the MCP server
forge mcp

# Check your setup
forge doctor
```

## Design

```
MCP = thin execution interface (12 forge.* tools)
Skills = logic layer (SKILL.md + scripts)
Agents = internal workers (never directly invoked)
Commands = triggers (/forge-* routes through registry)
```

**Expose capabilities. Hide orchestration.**

## The 12 Tools

| Tool | Purpose |
|---|---|
| `forge.init` | Initialize ForgeWeave in a project |
| `forge.execute_command` | Route /forge-* commands |
| `forge.execute_skill` | Execute a skill by name |
| `forge.create_agent` | Create agent definition file |
| `forge.research` | Full deep-research pipeline |
| `forge.search` | Lightweight web lookup |
| `forge.load_context` | Load project state snapshot |
| `forge.validate` | Validate outputs against rules |
| `forge.memory_read` | Read from persistent SQLite |
| `forge.memory_write` | Write to persistent SQLite |
| `forge.status` | Poll job status |
| `forge.capabilities` | List available tools and skills |

## Hooks

12 lifecycle hooks: pre/post command, pre/post skill, pre/post research,
research_iteration, research_complete, pre/post agent_create, pre/post file_write.

Hooks observe, validate, prepare, or finalize — they never contain business logic.

## License

MIT
