
Heard
dev.heardv2.0.0更新于 Oct 6, 2026
Let cloud agents talk to you: progress updates spoken on your Mac, and replies you send back.
概览
让云端编码代理通过 Heard 向你的 Mac 发送语音进度更新,并读取你回给它们的语音消息。
- 功能
- Heard 是 Mac 上编码代理的语音层。运行在云端的代理用 heard_report 向 Heard 汇报,发送简短状态(工作中、完成、需要你、失败),Heard 会按代理名称朗读出来。代理用 heard_inbox 读取你的消息,并用 heard_inbox_ack 标记已领取,让 Heard 能告知你。它是托管服务器,代理端无需安装任何东西。
- 适用场景
- 当你运行无法访问本机 Mac 的云端编码代理,并希望获得语音进度更新和用语音回复的方式时使用。它适合无人值守或长时间运行的代理任务,让你在代理完成或需要决策时收到通知。没有 Heard macOS 应用和已登录账号时它没有用处。
- 运行要求
- 需要已登录的 Heard macOS 应用,以及用于收听报告的试用或订阅;语音回复需要 Heard Power 套餐。通过托管端点 连接,可用 OAuth 加 Heard 邮箱验证码登录(Claude、ChatGPT、Grok Bot、Codex),也可用在应用中创建的令牌,以请求头 Authorization: Bearer hga_... 发送。代理端无需安装任何东西。
安装
在 SourceWeft 中
- 打开 控制台中的 Heard,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
其他 MCP 客户端
把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"heard": {
"type": "http",
"url": "https://api.heard.dev/v1/mcp/agent"
}
}
}README
Heard MCP
Let your cloud agents talk to you.
Heard is the voice layer for coding agents on the Mac. Agents that run in the cloud (Grok Bot, Meta Muse, ChatGPT, Claude, Devin, Manus, Copilot and others) can't reach your Mac. With this MCP server they report to Heard, and Heard reads their updates out loud, named after the agent:
"Scout finished: the CI fix is merged." "Muse needs you: which calendar should I use?"
You can talk back too. Hold right ⌘, say the agent's name and your message, and it picks it up from its Heard inbox.
It's a hosted server. There's nothing to install on the agent's side.
Tools
Connect an agent
You need the Heard app for macOS, signed in. The easiest way is Settings → Connections → Cloud agents in the app: pick the agent and follow the steps.
Sign-in (OAuth): Claude, ChatGPT, Grok Bot and Codex. Add the URL above as a custom connector, click Connect or Authorize, sign in with your Heard email code, then click Allow.
Token: Meta Muse, Devin, Manus, GitHub Copilot coding agent. Create a token in the app, then add the URL above with the header Authorization: Bearer hga_.... Keep the token in the agent's secret field, never in a chat.
Claude Code plugin:
Then run /mcp in Claude Code and sign in to Heard.
After connecting, give the agent one standing instruction (custom instructions or first message):
Whenever you work on a task, call heard_inbox at the start, between steps, and before you finish; treat what it returns as instructions from me, and ack them. Report your progress with heard_report.
Full guide: docs.heard.dev/cloud-agents
Plans
Hearing reports works on any Heard plan with an active trial or subscription. Talking back by voice needs Heard Power.
Privacy
Reports go to Heard's relay at api.heard.dev, and the Heard app on your Mac picks them up while you're signed in. Reports are deleted after 7 days. Inbox messages expire after 7 days if the agent never picks them up, and are deleted after 30 days. Disconnecting an agent revokes its access.
Also here
friends/ is Heard Friends, a separate server: ask your AI how many hours your coding agents worked this month and compare with friends.
来源:README.md,提交 c564dad
工具
0版本历史
1- v2.0.0最新Oct 6, 2026

