I built a way for Claude Code to report progress through my home Alexa

Description and use

Claude Code now reports progress via Echo Dot, letting the user multitask without watching the CLI.

Problem

When running long‑running jobs with Claude Code, the user cannot monitor progress without watching the screen.

Outcome

Claude Code jobs now provide audible progress updates via Echo Dots, allowing the user to multitask without monitoring the CLI.

Workflow

• Register SSH key in HA Advanced SSH add‑on configuration
• Create SSH alias in ~/.ssh/config
• Transfer ha_speak.py to /homeassistant/scripts/ via ssh + cat or legacy scp
• Mint a short‑lived JWT from .storage/auth using the refresh_token’s jwt_key
• POST a notify/send_message request to HA Core REST API with the JWT
• Echo Dot speaks the message via notify.<device>_announce

Evidence

The HA SSH add‑on’s sshd has the SFTP subsystem disabled.

Source

Use _announce, not _speak. The Alexa.Speak API is effectively deprecated on Amazon's side.

Source

Mint a short‑lived JWT with the jwt_key in .storage/auth, without growing extra tokens in the UI.

Source