Claude Canvas

A TUI toolkit that gives Claude Code its own display. Spawn interactive terminal interfaces for calendars, documents, flight tracking, weather, system monitoring, and more.

Requirements

• Bun — runtime for canvas tools
• One of:
  • iTerm2 — split panes (recommended for macOS)
  • tmux — split panes (cross-platform)
  • Apple Terminal — new window mode (auto-positioned)
  • Git Bash — new window mode via mintty (Windows)
  • Windows Terminal — split panes (Windows)

Quick Start

# Clone the repo
git clone https://github.com/BEARLY-HODLING/claude-canvas.git
cd claude-canvas

# Install dependencies
bun install
cd canvas && bun install && cd ..

# Check your terminal environment
bun run canvas/src/cli.ts env

# Spawn a canvas
bun run canvas/src/cli.ts spawn calendar
bun run canvas/src/cli.ts spawn tracker
bun run canvas/src/cli.ts spawn weather
bun run canvas/src/cli.ts spawn system

Canvas Types

Global Keybindings (v0.6)

Flight Tracker (tracker)

Real-time flight tracking using the free OpenSky Network API.

bun run canvas/src/cli.ts spawn tracker

Features

• Search flights by callsign (e.g., UAL123, BAW456)
• Search flights by route (origin → destination airports)
• Live position tracking with auto-refresh (5-60 second intervals)
• ASCII world map with filled continents showing flight positions
• Watchlist to track multiple flights simultaneously
• Status change alerts via IPC

Controls

Map Legend

Weather Canvas (weather)

Weather conditions and forecasts using the free Open-Meteo API (no API key required).

bun run canvas/src/cli.ts spawn weather

Features

• Current conditions: temperature, feels like, humidity, wind, precipitation
• 7-day forecast with high/low temps and rain probability
• Weather icons using WMO codes (☀️ ☁️ 🌧️ ⛈️ ❄️)
• City search via geocoding
• Location watchlist for quick switching

Controls

System Monitor (system)

Real-time system resource monitoring.

bun run canvas/src/cli.ts spawn system

Features

• CPU usage with 40-point sparkline history
• Memory usage with progress bars
• Disk usage for all mounted volumes
• Top processes sorted by CPU usage
• Alert thresholds for CPU (80%), memory (90%), disk (95%)
• Pause/resume monitoring

Controls

Calendar Canvas (calendar)

Weekly calendar view with meeting time picker.

# Basic calendar
bun run canvas/src/cli.ts spawn calendar

# With events
bun run canvas/src/cli.ts spawn calendar --config '{"events":[{"title":"Meeting","start":"2025-01-07T10:00","end":"2025-01-07T11:00","color":"blue"}]}'

# Meeting picker mode
bun run canvas/src/cli.ts spawn calendar --scenario meeting-picker

Controls

Document Canvas (document)

Markdown viewer and editor.

bun run canvas/src/cli.ts spawn document --config '{"content":"# Hello World\n\nThis is markdown."}'

Terminal Support

The canvas automatically detects your terminal and uses the appropriate method.

How It Works

iTerm2 / tmux / Windows Terminal: Creates a side-by-side split pane

┌─────────────────────┬─────────────────────┐
│ Claude Code         │ Canvas              │
│ (your terminal)     │ (tracker/weather/…) │
└─────────────────────┴─────────────────────┘

Apple Terminal / Git Bash: Opens a new window (no native split support)

┌─────────────────────┐  ┌─────────────────────┐
│ Your Terminal       │  │ Canvas Window       │
│ (Claude Code)       │  │ (mintty on Windows) │
└─────────────────────┘  └─────────────────────┘
      Left half               Right half

Session Reuse

Canvas tracks open panes/windows and reuses them for subsequent spawns instead of creating new ones.

APIs Used

*Rate limited for unauthenticated requests

Claude Code Plugin Installation

# Add marketplace
/plugin marketplace add BEARLY-HODLING/claude-canvas

# Install plugin
/plugin install canvas@claude-canvas

Development

# Run CLI directly
bun run canvas/src/cli.ts [command]

# Show canvas in current terminal (for testing)
bun run canvas/src/cli.ts show tracker

# Check terminal detection
bun run canvas/src/cli.ts env

# Run tests
cd canvas && bun test

Acknowledgments

This project builds upon excellent prior work:

• BEARLY-HODLING/claude-canvas — Added iTerm2/Apple Terminal support and real-time data canvases (flight tracker, weather, system monitor)
• dvdsgl/claude-canvas — Original claude-canvas concept and implementation

Windows/Git Bash Support

All code and documentation for porting claude-canvas to Windows/Git Bash was generated by Claude Code powered by Claude Opus 4.5. This includes:

• TCP socket IPC (replacing Unix sockets)
• Terminal detection and spawning via mintty
• Bidirectional path conversion (Windows ↔ Unix)
• Comprehensive porting documentation

License

MIT