Source Code

Masonry CLI

The masonry CLI provides AI-powered image and video generation capabilities.

When to use this skill

Use this skill when the user wants to:

Generate images from text prompts
Generate videos from text prompts
Check status of generation jobs
Download generated media
List available AI models
View generation history

Installation

If the masonry command is not available, install it:

curl -sSL https://media.masonry.so/cli/install.sh | sh

Quick Commands

# Generate image
masonry image "your prompt here" --aspect 16:9

# Generate video
masonry video "your prompt here" --duration 4

# Check job status
masonry job status <job-id>

# Download result
masonry job download <job-id> -o ./output.png

# List available models
masonry models list --type image
masonry models list --type video

Detailed Workflows

Image Generation

# Basic generation
masonry image "a sunset over mountains, photorealistic"

# With options
masonry image "cyberpunk cityscape" --aspect 16:9 --model imagen-3.0-generate-002

# Available flags
#   --aspect, -a     Aspect ratio (16:9, 9:16, 1:1)
#   --dimension, -d  Exact size (1920x1080)
#   --model, -m      Model key
#   --output, -o     Output path
#   --negative-prompt What to avoid
#   --seed           Reproducibility seed

Video Generation

# Basic generation
masonry video "ocean waves crashing on rocks"

# With options
masonry video "drone shot of forest" --duration 6 --aspect 16:9

# Available flags
#   --duration       Length in seconds (4, 6, 8)
#   --aspect, -a     Aspect ratio (16:9, 9:16)
#   --model, -m      Model key
#   --image, -i      First frame image
#   --no-audio       Disable audio generation

Job Management

# List recent jobs
masonry job list

# Check specific job
masonry job status <job-id>

# Wait for completion and download
masonry job wait <job-id> --download -o ./result.png

# View local history
masonry history list
masonry history pending --sync

Model Discovery

# List all models
masonry models list

# Filter by type
masonry models list --type video

# Get model parameters
masonry models params veo-3.1-fast-generate-preview

Response Format

All commands return JSON:

{
  "success": true,
  "job_id": "abc-123",
  "status": "pending",
  "check_after_seconds": 10,
  "check_command": "masonry job status abc-123"
}

Authentication

If commands fail with auth errors:

masonry login

Enhanced Project Skills

For project-specific skills with detailed workflows, run:

masonry skill install

This installs additional skills to .claude/skills/:

masonry-generate - Detailed generation workflow
masonry-models - Model exploration
masonry-jobs - Job management

masonry-generate-image-and-video