artifact-ai

# artifact-ai

Generate or modify artifacts (diagrams, 3D models, code) using AI

## Installation

This is a CmdForge tool. Install it from the CmdForge registry or create it locally:

```bash
cmdforge install artifact-ai
```

## Usage

Use `artifact-ai` via Unix pipes to generate or modify artifacts in various formats:

```bash
# Generate a new diagram
echo "Create a sequence diagram showing user authentication flow" | artifact-ai --format mermaid

# Modify existing artifact
cat diagram.puml | artifact-ai --format plantuml --instruction "Add error handling paths"

# Create a 3D model
echo "Design a simple desk lamp" | artifact-ai --format openscad

# Generate code
echo "Create a React component for a login form" | artifact-ai --format code
```

## Arguments

| Flag | Variable | Description |
|------|----------|-------------|
| `--format` | `format` | Artifact format: plantuml, mermaid, openscad, svg, excalidraw, code |
| `--instruction` | `instruction` | Natural language instruction for generating or modifying the artifact |

## How It Works

The tool runs a 3-step pipeline:

1. **Prepare prompt** (code step): Constructs the AI prompt based on format, instruction, and input
2. **Generate artifact** (AI prompt step): Calls Gemini Flash to create or modify the artifact
3. **Extract result** (code step): Processes AI output and returns the artifact content

Input can be provided via stdin (for modifications) or purely through the `--instruction` argument (for new artifacts).

## Dependencies

None