forge-tool

# forge-tool

Build single or multi-tool CmdForge pipelines from natural language descriptions, writing config.yaml and README to ~/.cmdforge/ with proper step composition and ToolStep wiring. Generates READMEs, checks scrutiny, and auto-fixes honesty warnings using forge-readme, forge-check, and forge-fix tool steps.

## Installation

This is a CmdForge tool. Install it using:

```bash
cmdforge install forge-tool
```

## Usage

Pipe your tool description into `forge-tool` with the required `--name` flag:

```bash
echo "A tool that summarizes text files and extracts key points" | forge-tool --name text-summarizer

echo "Create a code reviewer that checks Python files for PEP8 compliance and suggests improvements" | forge-tool --name py-reviewer --category Developer

echo "Build a multi-step translator that detects language, translates to English, and formats output as JSON" | forge-tool --name smart-translate --default-provider claude-opus --force true
```

## Arguments

| Flag | Default | Description |
|------|---------|-------------|
| `--name` | *(required)* | Primary tool name (required) |
| `--category` | Other | Tool category |
| `--default-provider` | claude-sonnet | AI provider for generated prompt steps |
| `--force` | false | Overwrite existing tool directories (true/false) |

## How It Works

1. **prepare_request** - Prepares the tool creation request with user input and arguments
2. **design_tool** - Uses Claude to design the complete tool structure, including steps, arguments, and configuration
3. **parse_and_install** - Parses the AI-generated design and writes config.yaml to ~/.cmdforge/, creating the tool directory structure
4. **post_process** - Runs forge-readme to generate documentation, forge-check to validate the tool, and forge-fix to automatically resolve any honesty warnings

The tool handles the complete lifecycle of CmdForge tool creation, from natural language description to a fully functional, documented, and validated CLI command.

## Dependencies

- **forge-readme** - Generates README documentation for created tools
- **forge-check** - Validates tool configuration and checks for issues
- **forge-fix** - Automatically fixes honesty warnings and validation issues