# Tool Forge — Self-Creating Tools System

Agents detect when they need a tool that doesn't exist and write it on the fly.
RAG-backed tool discovery keeps context lean by only surfacing relevant tools.

## Architecture

```
Agent needs capability → search tool registry (RAG) → found? use it : create it → index new tool → execute
```

## Components

- **registry.py** — ChromaDB-backed tool registry with semantic search
- **forge.py** — Tool creation engine (generates Python tools from natural language specs)
- **runner.py** — Safe tool execution sandbox
- **cli.py** — CLI interface: `search`, `create`, `run`, `list`, `describe`

## Usage

```bash
# Search for an existing tool
python3 cli.py search "convert CSV to JSON"

# Create a new tool on the fly
python3 cli.py create "convert CSV to JSON" --desc "Takes a CSV file path, returns JSON array"

# Run a tool
python3 cli.py run csv_to_json --args '{"file_path": "data.csv"}'

# List all tools
python3 cli.py list

# Index existing tools from the tools/ directory
python3 cli.py index-existing
```

## For Agents

```python
from tool_forge import ToolForge

forge = ToolForge()
# Returns matching tools or creates one if none found
tool = forge.ensure_tool("convert CSV to JSON", auto_create=True)
result = tool.run(file_path="data.csv")
```