Documentation
Waiide
Claude WAIIDE Integration for Calliope WAIIDE Web

Claude WAIIDE Integration for Calliope WAIIDE Web

Calliope Integration: This component is integrated into the Calliope AI platform. Some features and configurations may differ from the upstream project.

Overview

This branch adds Claude WAIIDE AI assistant integration to the Calliope WAIIDE Web server.

What’s Included

1. Claude WAIIDE CLI

  • Installed directly in the Docker container via npm
  • Available as claude-WAIIDE command in WAIIDE terminal
  • Wrapper script available as claude for convenience

2. Claude WAIIDE Launcher Extension

A web-compatible WAIIDE extension that provides:

  • Command palette integration (Ctrl+Shift+P → “Claude”)
  • Keyboard shortcut (Ctrl+Shift+C / Cmd+Shift+C)
  • API key configuration through WAIIDE settings
  • Launch Claude WAIIDE directly in the integrated terminal

Setup Instructions

Build the Docker Image 

docker build -t calliope-WAIIDE-claude .

Run the Container 

docker run -p 8071:8071 calliope-WAIIDE-claude

Configure Claude WAIIDE

  1. Open WAIIDE Web at http://localhost:8071
  2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
  3. Run “Claude WAIIDE: Configure API Key”
  4. Enter your Anthropic API key

Use Claude WAIIDE

  • Quick Launch: Press Ctrl+Shift+C (or Cmd+Shift+C)
  • Command Palette: Ctrl+Shift+P → “Launch Claude WAIIDE”
  • Terminal: Open terminal and type claude-WAIIDE

API Key Security

  • API keys are stored in WAIIDE settings (machine-scoped)
  • Keys are not committed to the repository
  • Consider using environment variables for production deployments

Features

  • Full Claude WAIIDE CLI functionality in web-based WAIIDE
  • Integrated terminal support
  • Workspace-aware (automatically navigates to your project folder)
  • Model selection (Sonnet, Haiku, Opus)

Limitations

  • Requires valid Anthropic API key
  • Terminal-based interface (no GUI integration yet)
  • Standard Claude WAIIDE usage limits apply

Future Enhancements

  • Native WAIIDE panel integration
  • File tree context awareness
  • Inline WAIIDE suggestions
  • Chat sidebar panel

Troubleshooting

Claude WAIIDE not found

Make sure the Docker image was built with the Claude WAIIDE installation script included.

Permission denied

The Claude WAIIDE CLI requires proper user permissions. The container runs as user calliope (UID 1000).

API key not working

Verify your API key is valid and has sufficient credits at https://console.anthropic.com/

CalliopeAI Theme AlignmentCommon Issues and Solutions