# claudzmo

Control Anki Cozmo robot - movement, expressions, speech, and camera.

## Usage

```bash
~/bin/claudzmo <command> [options]
# or
/Users/matt/Projects/cozmo-mcp/claudzmo <command> [options]
```

## Commands

### Movement
- `claudzmo move --distance <mm> [--speed <mm/s>]` - Move forward (positive) or backward (negative)
- `claudzmo turn --angle <degrees> [--speed <mm/s>]` - Turn in place (positive=right, negative=left)
- `claudzmo head --angle <degrees>` - Set head angle (-25 to 44 degrees)
- `claudzmo lift --height <mm>` - Set lift height (0 to 66mm)

### Expression & Speech
- `claudzmo expression --name <name> [--duration <ms>]` - Display facial expression
  - Available: neutral, happiness, sadness, anger, surprise, disgust, fear, pleading, vulnerability, despair, guilt, amazement, excitement, confusion, skepticism
- `claudzmo speak --text "<text>" [--volume <0-65535>]` - Speak text (default volume: 65535)

### Sensors
- `claudzmo camera [--format jpeg|png]` - Get camera image (returns JSON with base64 image)
- `claudzmo status` - Get robot status (battery, firmware, etc.)

### Control
- `claudzmo stop` - Emergency stop all motors

## Examples

```bash
# Make Cozmo greet someone
claudzmo speak --text "Hello Matt!"
claudzmo expression --name happiness --duration 1500

# Move around
claudzmo move --distance 200 --speed 50
claudzmo turn --angle 90
claudzmo head --angle 30

# Take a photo
claudzmo camera --format jpeg

# Check status
claudzmo status
```

## Setup

Requires:
1. Cozmo robot powered on
2. Computer connected to Cozmo's WiFi network (Cozmo_XXXXX)
3. Python environment with pycozmo installed at `/Users/matt/Projects/cozmo-mcp/venv`

## Notes

- Commands connect/disconnect for each operation (ensures reliability)
- Audio uses macOS `say` command with Samantha voice
- Expressions animate smoothly at ~30fps
- Camera returns base64-encoded JPEG or PNG