终端面板功能

Claude Panel是一个持久的TUI,位于Claude Code终端旁边,由Claude自动更新内容,显示代码片段、图表、下一步骤或情绪表情符号。

  • by alex-radaev
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 alex-radaev/claude-panel

使用说明

Claude Panel

Claude Code gets its own screen — it decides what you need to see

Main screen (Claude's content) → Status dashboard → Ambient screensaver


Claude Panel是一个持久的TUI,位于您的Claude Code终端旁边。Claude用它认为重要的东西自动更新面板——它刚刚写的代码、图表、下一步,或者情绪表情符号。结构化的仪表板跟踪当前任务、更改的文件和关键决策,并在每次响应后刷新。当你在任务之间时,环境终端屏幕保护程序会保持这种氛围。

三个屏幕

屏幕 管理者 显示内容
主 克劳德 克劳德认为现在有用的东西——代码片段、解释、图表、进度清单、情绪表情符号。完全的创意控制。
状态 克劳德 (AI策展人) 结构化仪表板:当前任务、文件更改、决策。每次响应后自动更新。
环境 你 您选择的终端屏幕保护程序。在没有其他需要你注意的时候玩。

克劳德管理内容,你管理屏幕保护程序。 主屏幕和状态屏幕会自动更新——克劳德会阅读对话,决定哪些内容值得固定在屏幕上,并将其写入。不需要手动命令。

环境屏幕保护程序

该软件包附带了12个内置的终端动画。使用箭头键导航或 panel(show="ambient").

aurora

tokyo-drift

也可用: neon-dreams | neon-street | space-flight | rain-city | city-lights | matrix | noir | banquet | dvd-bounce | synthwave

所有屏幕保护程序都与该软件包捆绑在一起——它们可以在新安装时开箱即用。

自定义屏幕保护图案

放下一个 .py 归档 ~/.claude-panel/screensavers/ 并且它立即可用。用户屏幕保护程序会覆盖同名的捆绑屏幕保护程序,因此您可以在不接触包装的情况下自定义任何内置屏幕保护程序。

# List available screensavers
panel(screensaver="rain-city")

# Or ask Claude to create one
# "make me a screensaver with falling snow"

屏幕保护程序是绘制到Rich画布上的普通Python脚本。 创建自己的需要大约10行。

安装

# As a Claude Code plugin (recommended)
claude plugin marketplace add alex-radaev/claude-panel
claude plugin install claude-panel@claude-panel
Manual installation
git clone https://github.com/alex-radaev/claude-panel
cd claude-panel
uv sync

然后添加到MCP配置中(~/.claude/settings.json 或 .mcp.json).

用法

面板 自动打开 当您启动Claude Code会话时,iTerm2(macOS)或Windows终端(WSL)拆分窗格将随查看器一起启动。不需要手动命令。

要禁用自动打开,请设置 "auto_open": false 在 ~/.claude-panel/config.json.

您也可以手动打开它:

# From Claude Code
panel_open()

# Manual
uv run claude-panel

一旦奔跑,克劳德就会接管。主屏幕和状态屏幕会自行更新。您可以切换视图:

panel(show="ambient")              # switch to screensaver
panel(show="main")                 # switch to main canvas
panel(show="status")               # switch to status dashboard
panel(screensaver="tokyo-drift")   # change screensaver
关键 行动
q 退出查看器
<- -> 循环屏幕
c 透明面板

iTerm2提示: 面板窗格可能看起来已褪色,因为默认情况下iTerm2会使非活动的拆分窗格变暗。要修复: 设置>外观>调光 并取消选中 调暗非活动拆分窗格.

运作原理

 Claude Code session              iTerm2 Split Pane
┌──────────────────────┐         ┌──────────────────┐
│                      │         │                  │
│  Main Claude         │         │  Textual TUI     │
│  + Background agents │         │  Viewer          │
│  + Stop hook curator │         │                  │
│                      │         │                  │
└──────────┬───────────┘         └────────┬─────────┘
           │  WRITES                      │ POLLS
           └──────►  per-session   ◄──────┘
                     state.json
            ~/.claude-panel/sessions/<id>/
  1. 克劳德回应 --人工智能策展人(Haiku)运行着一个停止钩子。它读取对话,决定发生了什么变化,并更新 状态屏幕.
  2. 克劳德培养了一个背景特工 --更新 主屏幕 无论什么内容值得展示。零谈话噪音。
  3. 观众投票 状态文件每300ms一次,并立即重新渲染。

会话隔离: 每个Claude Code会话都有自己的状态。运行多个会话——它们不会干扰。查看器跟踪任何活动的会话。

审核通知

该面板可以直接在主屏幕上显示等待您审核的GitHub PR。共享背景轮询器检查 gh search prs --review-requested=@me 每2分钟,结果就会显示一个可点击的列表,其中包含在浏览器中打开的链接。

  • 自动显示 当您有待处理的评论时
  • 自动关闭 当您批准、评论或请求更改时
  • 一位民意调查者 在所有并发会话之间共享(没有重复的API调用)
  • 可点击链接 --单击PR标题以在浏览器中打开它
  • 按GitHub组织筛选 review_notifications.org 在配置中
  • 完全禁用 "review_notifications": false

配置

~/.claude-panel/config.json:

{
  "auto_open": true,
  "model": "claude-haiku-4-5-20251001",
  "favorite_screensaver": "tokyo-drift",
  "update_every_n": 1,
  "curator_personality": "playful",
  "review_notifications": {
    "enabled": true,
    "poll_interval_seconds": 120,
    "org": "my-org"
  }
}
选项 值 描述
auto_open true, false 会话开始时自动打开面板(默认值: true)
model 任意Claude型号ID 状态管理员的型号(默认:Haiku)
favorite_screensaver 屏幕保护程序名称 默认环境屏幕保护程序
update_every_n 数字 每N个响应更新一次状态(1=每次)
curator_personality "playful", "professional" 策展人语气-顽皮添加幽默和表情符号组合,专业简洁而真实
review_notifications 对象或 false GitHub审核请求通知(默认:启用)
review_notifications.enabled true, false 打开/关闭审核通知
review_notifications.poll_interval_seconds 数字 多久在GitHub上查看一次新评论(默认值: 120)
review_notifications.org GitHub组织名称 仅显示来自该组织的评论(所有组织省略)

贡献

欢迎投稿,尤其是新的屏保。看 贡献.md 完整的指南,包括一个屏幕保护程序模板,让你用大约10行Python开始。

许可证

麻省理工学院