学习精选 · AI 工具
Codex

OSC 7501:让 Claude Code 和 Codex 主动告诉终端“我在等你”

DEV Community2026-11-17约 4 分钟读完AI 整理查看原文

同时跑多个 AI 编程代理时,最难的不是启动,而是搞清哪个已经停下来等你。OSC 7501 是 Mitchell Hashimoto 提出的程序状态协议(0.4 版),让程序通过转义序列向终端报告自己处于空闲、工作中、被阻塞、完成或出错。Claude Code 和 Codex 已支持发送,iTerm2 和 kitty 已支持显示,你自己的脚本也能用。

今天就能做

  • 把 iTerm2 升到 3.7.5 或 kitty 升到 0.50.0,配合最新版 Claude Code 或 Codex,多标签跑代理时一眼看出哪个在等你
  • 给自己的长任务脚本加一个 osc_status 函数,用转义序列报告 working/done/error 状态
  • 跑在 tmux 里的代理暂时无法上报状态,重要会话尽量直接跑在支持的终端里

协议怎么工作

  • 程序用一条转义序列报告状态,格式类似 OSC 7501;state=working:app=make:msg=...,state 取值 idle、working、blocked、done、error 或 clear
  • blocked 时可用 kind 说明原因:permission(要权限)、question(要回答)或 auth(要认证),还能带 progress 进度百分比
  • msg 和 title 是 base64 编码的 UTF-8 文本,说明它在做什么或在等什么

几条防坑的设计规则

  • 每次报告整体替换上一次的状态
  • working 和 blocked 在进程退出或出现新 shell 提示符时自动消失,程序崩溃不会留下假的“工作中”;done 和 error 会保留到你看过为止
  • 报告内容视为不可信:终端拒绝文本里的控制字符,也不会把标题或消息回传给程序

哪些代理和终端已支持

  • 发送方:Claude Code(2.1.295,10 月 8 日起)、Codex(rust-v0.163.0,10 月 15 日起)、Grok Build 1.0.52、OpenCode 2(2.2.0 起);Gemini CLI 还没有,有 open issue
  • 显示方:iTerm2 3.7.5 和 kitty 0.50.0 已上线;Ghostty、WezTerm、Windows Terminal、Alacritty、VS Code 终端和 Warp 还不支持
  • 不支持的终端会直接忽略这条序列,无害;社区有追踪页 Are we OSC 7501 yet? 持续更新

在自己的脚本里也能用

  • 长构建、测试或部署脚本可以复用同一协议:用 printf '\033]7501;state=working:app=deploy:msg=...\033\\' 报告状态
  • 等待输入时带上 kind=question,终端就能区分“提问”和“要密码”
  • 结束时发 state=clear 清除自己设置的所有状态

目前的限制

  • tmux 等多路复用器可能拦住序列,规范未覆盖 tmux,Herdr 里跑在 tmux 中的代理就无法上报状态
  • 程序不发报告就没有状态显示,Gemini CLI 目前就是这种情况
  • 还是 0.4 版提案,细节可能继续变化

作者自家产品的视角

  • 作者做的 Moontors 桌面应用直接从代理协议读取会话状态,不依赖终端,因此连 Gemini CLI 的会话也能知道在等什么
  • 顶部一个计数显示所有等待你的会话,点一下跳到下一个;每张卡片显示它在问什么问题或等哪个计划批准
  • 会话开始等待、出错或完成时发桌面通知,手机 App 上也能看到同样的等待和完成计数并直接回复

原文:OSC 7501: your coding agent can now tell your terminal it needs you

来源:DEV Community · 2026-11-17

查看原文

本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论