Readless
- 4 repo stars
- Updated May 15, 2026
- hwjustin/readless
readless is a Claude Code MCP plugin marketplace that speaks agent status, summaries, and blocker questions aloud for developers who want audio feedback during long autonomous coding tasks.
About
readless is a Claude Code plugin marketplace from hwjustin/readless that adds text-to-speech feedback to coding agents via an MCP server launched with uvx --from readless-mcp readless. Three agent-callable tools drive the experience: speak_summary delivers up to 50 words at turn end, speak_status sends up to 10-word heartbeats throttled to one per minute during tasks over two minutes, and speak_blocker asks up to 20-word questions that bypass quiet hours and interrupt current speech. Default TTS uses edge-tts with zh-CN-XiaoxiaoNeural for Chinese and English code-switching without API keys, falling back to OS system voices offline. Install via /plugin marketplace add hwjustin/readless, then /readless:setup which verifies uv on PATH, pre-warms the MCP server, and appends marker-bounded instructions to ~/.claude/CLAUDE.md. Optional OpenAI or ElevenLabs backends use readless-setkey outside the Claude conversation. Configuration lives in ~/.readless/config.yaml with quiet hours, throttle seconds, and per-tool toggles. Reach for readless when running long unattended agent tasks and wanting spoken progress without constantly watching the terminal.
- Three MCP tools: speak_summary (≤50 words), speak_status (≤10 words), speak_blocker (≤20 words)
- Default edge-tts backend needs no API key; optional OpenAI/ElevenLabs via readless-setkey
- speak_status throttled to 1 call/min; speak_blocker bypasses quiet hours
- Install: /plugin marketplace add hwjustin/readless then /readless:setup with uv
- Logs all tool calls to ~/.readless/log.jsonl; config at ~/.readless/config.yaml
Readless by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin marketplace add hwjustin/readlessAdd your badge
Show developers this marketplace is listed on Skillselion. Paste this into your README.
| repo stars | ★ 4 |
|---|---|
| Last updated | May 15, 2026 |
| Repository | hwjustin/readless ↗ |
How do you get spoken updates from coding agents?
Install readless to have Claude Code agents speak 50-word summaries, 10-word status heartbeats, and 20-word blocker questions via edge-tts MCP tools.
Who is it for?
Developers running long Claude Code agent sessions who want hands-free audio updates on progress, completion, and blocking questions without watching the terminal.
Skip if: Teams in open offices needing silent agent workflows or developers who do not use Claude Code with MCP plugin support.
What you get
Connected readless MCP server, CLAUDE.md agent instructions, ~/.readless/config.yaml, and JSONL logs of spoken summaries and status messages.
- ~/.readless/config.yaml
- ~/.claude/CLAUDE.md instructions
- log.jsonl speech log
By the numbers
- Marketplace bundles 1 plugin with 3 agent-callable MCP tools
- speak_summary ≤50 words; speak_status ≤10 words; speak_blocker ≤20 words
- speak_status throttled to 1 call per 60 seconds by default
Plugins in this marketplace
1 plugin - install individually after you add the marketplace.
Recommended Marketplaces
How it compares
Use readless for spoken agent progress during long tasks; use terminal notifications when silent, lightweight alerts are sufficient.
FAQ
What MCP tools does Readless expose?
Readless exposes speak_summary for ≤50-word turn summaries, speak_status for ≤10-word mid-task heartbeats throttled to one per minute, and speak_blocker for ≤20-word questions that bypass quiet hours and interrupt speech.
Does Readless require an API key?
Readless defaults to edge-tts using Microsoft's free endpoint with no API key or signup; optional OpenAI or ElevenLabs backends are configured via Readless-setkey writing to ~/.Readless/config.yaml.
How do you install Readless in Claude Code?
Readless installs with /plugin marketplace add hwjustin/Readless, /plugin install Readless, and /Readless:setup which verifies uv, pre-warms uvx --from Readless-mcp Readless, and updates ~/.claude/CLAUDE.md before a full Claude Code restart.