canvas

Canvas Command

Spawn and control interactive terminal displays (TUIs) in tmux split panes.

Usage

When the user invokes /canvas, help them spawn the appropriate canvas type based on their needs.

Workflow

Step 1: Determine Canvas Type

Ask what kind of canvas the user needs:

• Calendar - Display events or pick meeting times
• Document - View or edit markdown content
• Flight - Compare flights and select seats

Step 2: Gather Configuration

Based on the canvas type, collect the necessary configuration:

Calendar:

• Events to display (title, start/end times)
• For meeting picker: multiple calendars with busy times
• Slot granularity (15/30/60 minutes)

Document:

• Markdown content to display
• Document title
• Edit mode or display-only
• Optional diff highlighting

Flight:

• Flight options (airline, times, prices)
• Seatmap configuration
• Origin/destination airports

Step 3: Spawn Canvas

Use the CLI to spawn the canvas:

cd ${CLAUDE_PLUGIN_ROOT}
bun run src/cli.ts spawn [type] --scenario [scenario] --config '[json]'

Examples:

# Calendar display
bun run src/cli.ts spawn calendar --config '{"events": [...]}'

# Meeting picker
bun run src/cli.ts spawn calendar --scenario meeting-picker --config '{"calendars": [...]}'

# Document editor
bun run src/cli.ts spawn document --scenario edit --config '{"content": "# Title", "title": "Doc"}'

# Flight booking
bun run src/cli.ts spawn flight --config '{"flights": [...]}'

Step 4: Handle Results

Wait for user interaction and handle the result:

• Selected: User made a selection (time slot, text, flight+seat)
• Cancelled: User pressed Escape or quit
• Error: Something went wrong

Requirements

• Must be running inside a tmux session
• Terminal should support mouse input for interactive scenarios

Skills Reference

Read these skills for detailed configuration options:

• canvas - Overview and IPC communication
• calendar - Calendar events and meeting picker
• document - Markdown rendering and text selection
• flight - Flight comparison and seatmaps