Design

# Design

Turn ideas into on-brand visuals instantly -- generate, edit, and upscale images without opening a design tool.

## When to Use
- User needs a social media graphic, blog hero image, or marketing banner
- User wants to edit an existing image (remove background, change text, adjust colors)
- User wants to upscale a low-resolution image to higher quality
- User needs on-brand visuals for a campaign or launch

## How It Connects
- **Branding** -- Brand colors, logos, and fonts are automatically applied to generated images. Set up branding first for consistent visuals.
- **Social Media** -- Generated images can be attached to social posts using the returned asset ID with the `--media` flag.
- **Blog** -- Use generated images as hero images or inline visuals in blog articles.
- **Newsletter** -- Generated images work in newsletter image blocks.
- **Video** -- For moving content, use the video skill instead. Design handles static images only.

## Quick Start

Generate an image:
```bash
clawpow design images create --prompt "A hero banner for our product launch" --json
```

## Commands

### Generate Image
```bash
clawpow design images create --prompt "Description of the image" --json
clawpow design images create --prompt "Description" --aspect-ratio 16:9 --json
clawpow design images create --prompt "Description" --no-branding --json
clawpow design images create --prompt "Description" --reference-images assetId1 assetId2 --json
```
Generate an image. Brand styling is applied automatically unless --no-branding is used.

**Options:**
- `--prompt <text>` (required) -- Text description of the desired image
- `--aspect-ratio <ratio>` -- Aspect ratio: 1:1, 16:9, 9:16, 4:5 (default: 1:1)
- `--reference-images <assetId...>` -- Asset IDs of reference images for style guidance
- `--template <templateId>` -- Optional template to use as style reference
- `--no-branding` -- Skip brand styling

**Returns:** `{"imageId": "...", "status": "generating"}`

### Edit Image
```bash
clawpow design images edit --prompt "Remove the background" --image <assetId> --json
clawpow design images edit --prompt "Change the text to say Hello World" --image <assetId> --json
clawpow design images edit --prompt "Make the colors warmer" --image <assetId> --no-branding --json
clawpow design images edit --prompt "Crop to landscape" --image <assetId> --aspect-ratio 16:9 --json
```
Edit an existing image using AI. Provide a source image asset ID and edit instructions. Brand styling is applied automatically unless --no-branding is used.

**Options:**
- `--prompt <text>` (required) -- Edit instructions describing the desired changes
- `--image <assetId>` (required) -- Asset ID of the source image to edit
- `--aspect-ratio <ratio>` -- Aspect ratio: 1:1, 16:9, 9:16, 4:5 (default: 1:1)
- `--no-branding` -- Skip brand styling

**Returns:** `{"imageId": "...", "status": "generating"}`

### Upscale Image
```bash
clawpow design images upscale --image <assetId> --json
```
Upscale an image to 4x resolution using AI super-resolution (fal.ai AuraSR v2). No prompt or branding options needed -- just provide the source image.

**Options:**
- `--image <assetId>` (required) -- Asset ID of the image to upscale

**Returns:** `{"imageId": "...", "status": "generating"}`

### List Images
```bash
clawpow design images list --json
clawpow design images list --status completed --json
clawpow design images list --aspect-ratio 16:9 --json
```
List generated images with optional filters.

**Options:**
- `--status <status>` -- Filter by status: pending, completed, failed
- `--aspect-ratio <ratio>` -- Filter by aspect ratio

**Returns:** Array of `{_id, prompt, aspectRatio, status, resultAssetId, _creationTime}`

## Templates

Browse curated and user-saved design templates. Templates provide a visual reference that guides the AI toward a specific style, layout, and composition.

### List Templates (free)

```bash
clawpow design templates list [--type <type>] [--source <system|user>] [--json]
```

Returns an array of template objects. Each includes `id`, `name`, `description`, `type`, `aspectRatio`, `source`, and `tags` — use these fields to pick the right template without needing to see the image.

### Get Template (free)

```bash
clawpow design templates get <templateId> [--json]
```

Returns full template detail including the asset ID and original prompt.

### Save Image as Template (free)

```bash
clawpow design templates save --image <imageId> --name <name> --type <type> [--description <desc>] [--tags <tag1,tag2>] [--json]
```

Save a completed image generation as a reusable template. The image must be in `ready` status.

### Remove Template (free)

```bash
clawpow design templates remove <templateId> [--json]
```

Delete a user-created template. System templates cannot be deleted.

### Using Templates with Image Generation

```bash
clawpow design images create --prompt "Launch announcement for our new product" --template <templateId>
```

When a template is provided, its image is used as a visual reference to guide the AI's output style, layout, and composition.

### Workflow

1. Browse templates: `design templates list --type social-post`
2. Pick a template by reading its `name` and `description`
3. Generate: `design images create --prompt "..." --template <templateId>`
4. Optionally save good results: `design templates save --image <imageId> --name "My Style" --type social-post`

## Output Format

All commands support `--json` for structured output. Without `--json`, output is human-readable.

## Important Notes

- Always use `--json` for machine-parseable output
- Image generation is a paid operation (consumes credits)
- Image listing is a free operation
- Generated images are stored as assets and can be used in social posts
- Supported aspect ratios: 1:1, 16:9, 9:16, 4:5