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. Runs system commands to generate READMEs, check scrutiny, and auto-fix honesty warnings.

## Installation

This is a CmdForge tool. Install it via the CmdForge registry or place its configuration in `~/.cmdforge/forge-tool/`.

## Usage

forge-tool creates complete CmdForge tools from natural language descriptions. Pipe your tool description to forge-tool with the `--name` flag to generate a fully configured tool with proper step composition, README, and automated quality checks.

```bash
# Create a simple tool
echo "Extract email addresses from text" | forge-tool --name extract-emails

# Create a tool in a specific category
echo "Analyze code complexity and suggest refactorings" | forge-tool --name code-analyzer --category Developer

# Force overwrite an existing tool
echo "Convert JSON to YAML with validation" | forge-tool --name json2yaml --force true

# Use a different AI provider
echo "Summarize meeting notes into action items" | forge-tool --name meeting-summarizer --default-provider claude-opus
```

## Arguments

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

## How It Works

forge-tool uses a three-step pipeline to create complete CmdForge tools:

1. **prepare_request** (code): Prepares the tool creation request with metadata and user description
2. **design_tool** (prompt): Uses Claude to design the tool structure, including steps, arguments, and wiring
3. **parse_and_install** (code): Parses the AI-generated design, writes config.yaml and README to ~/.cmdforge/, and runs automated quality checks

After installation, forge-tool automatically:
- Generates a README using the `forge-readme` dependency
- Validates the tool with `forge-check` 
- Auto-fixes any honesty warnings with `forge-fix`
- Tests the tool configuration with `forge-test`
- Applies runtime fixes if needed with `forge-fix-runtime`

## Dependencies

This tool requires the following CmdForge tools to be installed:

- `forge-readme` - Generates tool documentation
- `forge-check` - Validates tool configuration
- `forge-fix` - Auto-fixes honesty warnings
- `forge-test` - Tests tool configuration
- `forge-fix-runtime` - Applies runtime fixes