agent-speak
A CLI tool that provides voice announcement notifications for AI agents.
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: agent-speak. It is used for: A CLI tool that provides voice announcement notifications for AI agents. Full Skill content: https://321skill.com/skills/agent-speak/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
Agent Speak is a command-line tool designed specifically for AI agents and automated workflows. It enables programs or agents to "speak" by calling ElevenLabs' text-to-speech service, broadcasting important notifications such as task completion or error alerts. If the ElevenLabs service is unavailable, it automatically falls back to the system's built-in say command on macOS, ensuring basic functionality remains intact.
Usage is highly flexible: you can run it temporarily via npx or install it globally. Once you set up your ElevenLabs API key, you can use simple commands to have your agent announce any text message. The tool also supports automatic voice assignment based on the working directory, making it easy to distinguish between multiple concurrently running agents.
This tool is particularly suited for agent developers, DevOps engineers, and anyone looking to add voice feedback to their automation scripts. It brings life to otherwise dry command-line output, enhancing the human-computer interaction experience and efficiency.
It is recommended for scenarios requiring non-intrusive notifications, such as when long-running tasks complete. Note that frequent or extensive use of the ElevenLabs service may incur costs; for simple local alerts, you can rely on its free fallback option.
Key Features
Its core differentiator lies in being designed specifically for AI agent workflows, offering automatic voice selection based on the working directory to effectively distinguish between different agents' voices. Additionally, it features a built-in, cross-platform voice fallback solution, ensuring basic functionality remains available even when advanced TTS services are not configured.
Limitations
Not suitable for scenarios requiring high-quality, customized speech synthesis or processing large volumes of text-to-speech tasks.
FAQ
How can I use it quickly without installation?
Simply run the command `npx agent-speak@latest "your message"` to use it directly.
Can it work on macOS without setting an API key?
Yes, on macOS, the system will automatically use the built-in `say` command for voice announcements.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/agent-speak/raw/index.md to read the original Skill definition (Markdown format) for agent-speak, and install it according to the instructions.
Raw Markdown URL for AI: /skills/agent-speak/raw/index.md