alexa-cli

name	alexa-cli
description	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.
metadata	{"author":"buddyh"}

Alexa CLI

Control Echo devices via the alexacli command.

Requirements

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

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

Commands

# 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:

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 — claim your Tome and manage your conversions.