# Alexa CLI

> Control Amazon Echo/Alexa devices via the `alexacli` CLI. Use when the user asks to speak/announce on Echo devices, send voice commands to Alexa, control smart home devices, list Alexa devices, or trigger routines. Use when this capability is needed.

- Skill: `tomevault-io/alexa-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/alexa-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/alexa-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/alexa-cli

---


# Alexa CLI

Control Echo devices via the `alexacli` command.

## Requirements

Install from: https://github.com/buddyh/alexa-cli

```bash
brew install buddyh/tap/alexacli
# or
go install github.com/buddyh/alexa-cli/cmd/alexa@latest
```

## Commands

```bash
# List devices
alexacli devices

# Text-to-speech
alexacli speak "Hello" -d Kitchen             # Specific device
alexacli speak "Dinner is ready!" --announce  # ALL devices

# Voice commands (smart home, music, etc.)
alexacli command "turn off the lights" -d Kitchen
alexacli command "set thermostat to 72" -d Kitchen
alexacli command "play jazz" -d "Living Room"
alexacli command "set timer 10 minutes" -d Office

# Ask and get response back
alexacli ask "what's the temperature" -d Kitchen
alexacli ask "what's on my calendar" -d Kitchen

# History
alexacli history
alexacli history --limit 5

# Routines (WIP)
alexacli routine list
alexacli routine run "Good Night"

# Smart home direct control (WIP)
alexacli sh list
alexacli sh on "Kitchen Light"
alexacli sh off "All Lights"
```

## JSON Output

All commands support `--json`:

```bash
alexacli devices --json
alexacli ask "what time is it" -d Kitchen --json
```

## Notes

- Device names support partial, case-insensitive matching
- `command` is preferred for smart home - natural language is more flexible
- `ask` retrieves Alexa's actual response (useful for queries)
- Uses unofficial Amazon API (same as Alexa app)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/buddyh) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->