에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
Claude Code plugin (MCP-based) that speaks status, summaries, and blocker questions out loud — so you can walk away from a long task and still know what's happening.
Let your coding agent talk: spoken summaries, progress and blocker questions for Claude Code, Cursor, Codex and any MCP agent. Free edge-tts, no API key.
Three agent-callable tools:
Default TTS backend is edge-tts — Microsoft's free online TTS endpoint. No API key, no signup, no model download, and the default voice zh-CN-XiaoxiaoNeural handles Chinese + English code-switching naturally. Falls back to your OS's built-in voice if the network is unreachable. Optional OpenAI / ElevenLabs backends are available if you want your own voice — keys are entered through a separate CLI so they never touch the Claude conversation.
You need uv (Astral's Python launcher) on PATH — that's it. uv provisions Python automatically, so you do not need to install Python 3.10+ yourself or manage virtualenvs.
# 1. Install uv (skip if you already have it)
curl -LsSf https://astral.sh/uv/install.sh | sh # macOS / Linux
# brew install uv # macOS via Homebrew
# irm https://astral.sh/uv/install.ps1 | iex # Windows PowerShell
Then in Claude Code:
/plugin marketplace add hwjustin/readless
/plugin install readless
/readless:setup
/readless:setup:
uv is on PATH (re-prompts if not) and pre-warms uvx --from readless-mcp readless so the first MCP startup is instant.~/.claude/CLAUDE.md (marker-bounded, idempotent) so the agent knows to call speak_summary at the end of every turn.After setup, fully restart Claude Code (not just a new chat — close the CLI / IDE host so the new PATH is picked up). /mcp should show readless ✓ Connected.
Why uv? The MCP SDK requires Python ≥3.10. macOS ships 3.9 system-wide, and asking users to install Homebrew Python or manage a venv was the #1 source of "it doesn't work."
uvdownloads a suitable Python on demand into its own cache (~/.cache/uv/), runsreadless-mcpfrom PyPI in isolation, and leaves the system Python untouched. This is the pattern recommended by the official MCP servers repo.
The default edge-tts backend is good enough for most people. If you want OpenAI or ElevenLabs voices, set the key in your own terminal — don't paste the key into Claude:
# OpenAI
uvx --from 'readless-mcp[openai]' readless-setkey openai # prompts for key, input hidden
# ElevenLabs
uvx --from 'readless-mcp[elevenlabs]' readless-setkey elevenlabs
readless-setkey uses getpass to read the key without echoing it, writes it to ~/.readless/config.yaml (chmod 600), and flips tts_provider for you. Use readless-setkey clear openai (or elevenlabs) to wipe a saved key.
Env vars OPENAI_API_KEY / ELEVENLABS_API_KEY always override the config file if you prefer shell-rc-managed secrets.
~/.readless/config.yaml is auto-created from defaults on first run. Common edits:
edge_voice: en-US-AriaNeural — pick a different edge-tts voice (edge-tts --list-voices to list)edge_rate: "+20%" — speed up the default voicetts_provider: system — force OS-native TTS (useful for fully offline machines)system_voice: Tingting — pick a macOS voice (say -v '?' to list)quiet_hours.start / end — opt-in night-silencing for speak_summary / speak_status (off by default; speak_blocker still plays even if enabled)tools.speak_status: false (etc.) — disable individual toolsstatus_throttle_seconds: 60 — limit speak_status rateSee config.example.yaml.
CLAUDE_EXAMPLE.md is the source of truth for "when should the agent call which tool." Edit your ~/.claude/CLAUDE.md block to make the agent more or less chatty — that's the lever, not the code.
All tool calls append to ~/.readless/log.jsonl:
{"ts": "2026-05-14T22:30:00+08:00", "kind": "summary", "headline": "Build passed, all 3 tests green", "details": ""}
Apache 2.0 — see LICENSE.
.claude-plugin/
plugin.json plugin metadata (name, version, description)
marketplace.json /plugin marketplace add metadata
.mcp.json MCP server declaration (uvx --from readless-mcp readless)
commands/
setup.md /readless:setup — ensure `uv` is installed + CLAUDE.md append
src/readless/
server.py FastMCP entry + tool definitions
tts.py edge / system / openai / elevenlabs backends
setkey.py readless-setkey CLI — secure API-key entry
config.py YAML loading + quiet-hours math (built-in YAML fallback)
throttle.py StatusThrottle (1 call/min default)
logger.py JSONL append-only log
CLAUDE_EXAMPLE.md agent instruction blocks (Chinese + English)
Let your coding agent talk: spoken summaries, progress and blocker questions for Claude Code, Cursor, Codex and any MCP agent. Free edge-tts, no API key.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Readless은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-27. Let your coding agent talk: spoken summaries, progress and blocker questions for Claude Code, Cursor, Codex and any MCP agent. Free edge-tts, no API key.
