AgentValley icon

AgentValley

AgentValley 是一款免费开源的 macOS 应用,可在 MacBook 刘海中显示 Claude Code 会话和子代理,帮助开发者监控活动、发现等待输入的代理,并查看项目历史,无需切换终端窗口。

AgentValley

MacBook 刘海中的 Claude Code 活动

AgentValley 是一款免费开源的 macOS 应用,可将 Claude Code 活动显示在 MacBook 的刘海中。它会显示活跃会话、子代理、项目、模型、最新步骤以及需要用户关注的请求,让开发者无需在窗口之间切换,就能监控多个 Claude Code 终端。

应用会读取 Claude Code 工作时写入的文件,观察其进程,并检查项目的 Git 元数据,以识别关联的应用和分支。它还提供可选的控制功能、历史记录、使用情况视图、声音、终端状态栏自定义和 PDF 导出。AgentValley 专为带刘海的 Mac 上的 Claude Code 设计,而不是通用的多代理仪表板。

功能

基于刘海的代理概览

在刘海面板中查看活跃的 Claude Code 会话及其子代理,每个会话按项目分组,工作树计作项目。

实时会话详情

查看每一行的任务、模型、最新步骤以及目前已完成的步骤。当代理停止活动时,应用会报告其处于静默状态,而不是虚构进度百分比。

需要关注的提醒

当代理需要回答或获得权限时,收到红色通知计数;打开请求后,还可选择跳转到相关的 Terminal、iTerm2 或 Ghostty 标签页。Cursor 也被列为配套字体支持的终端环境。

权限控制

使用可选插件将“允许一次”和“拒绝”控件添加到刘海中。另一个可选钩子可以在用户离开且携带配对手机时,在一轮操作结束时等待;是否批准始终由用户选择。

历史记录与 PDF 导出

打开按日、周或月查看时长和项目会话的视图,然后导出涵盖所有项目或指定项目的工作说明 PDF。网站称这些信息会保留在 Mac 上。

限额与令牌使用情况

可选显示 Claude 的限额和令牌使用情况,包括距离重置的时间和近期使用量图表。计划限额默认关闭,启用后需要应用从钥匙串读取 Claude Code 登录信息,并将其发送至 api.anthropic.com。

使用场景

  • 监控并行编码会话

    在其他应用中工作时,让多个 Claude Code 会话保持可见,然后从刘海查看项目、模型和最新步骤,无需反复切换终端窗口。

  • 处理受阻任务

    当部署、Shell 命令或其他代理请求等待权限时及时发现,阅读提示,并在需要更多上下文时直接跳转到相关终端标签页。

  • 跟踪委派工作

    通过查看父会话下方的 Explore 或其他子代理行,并检查各自的模型和步骤,跟进委派给子代理的较大型任务。

  • 查看项目活动

    按日期或项目查看时长和会话,然后根据记录的活动为项目、团队或客户创建工作说明 PDF。

  • 查看使用情况和限额

    可选地在应用中显示 Claude 计划限额和令牌使用情况,同时注意启用计划限额视图需要访问钥匙串,并向 api.anthropic.com 发出请求。

Pros and Cons

Pros

  • 免费且开源。
  • 按项目将父会话和子代理集中显示。
  • 提供关注提醒,并支持从刘海直接进行可选的权限响应。
  • 包含本地历史记录视图和工作说明 PDF 导出。
  • 支持 Terminal、iTerm2 和 Ghostty,以跳转到会话标签页;配套字体也说明支持 Cursor。

Cons

  • 需要 macOS 15 或更高版本,以及带刘海的 MacBook。
  • 该产品专用于 Claude Code;收集到的网站内容未说明支持其他编码代理或提供商。
  • 包括计划限额、刘海响应和终端自定义在内的部分功能,需要明确启用或安装可选组件。

FAQ

如何安装 AgentValley?

AgentValley 是一款面向 Claude Code 的免费开源 Mac 应用。请从网站下载已签名的 macOS 应用,或使用 Homebrew 通过 `brew install --cask morsechimwai/tap/agent-valley` 安装。需要 macOS 15 或更高版本,以及带刘海的 MacBook。

AgentValley 监控哪些内容?

AgentValley 会读取 Claude Code 所需的文件和进程,以显示会话、子代理、项目、分支、模型和最新步骤。它还可以检查项目的 Git 仓库,以识别与会话关联的应用和分支。

AgentValley 如何显示 Claude Code 的工作?

面板按项目归类显示会话,子代理列在其父会话下方。每一行可以显示任务、模型、最新步骤以及目前已完成的步骤;AgentValley 不会通过猜测进度条来估算进度。

我可以从刘海中回应 Claude Code 的请求吗?

当 Claude Code 提出问题或请求权限时,刘海旁会出现红色计数。安装可选插件后,用户可以直接在刘海中选择“允许一次”或“拒绝”。AgentValley 不会自动回答提示。

AgentValley 提供使用历史或导出功能吗?

AgentValley 提供可选的按日、周或月查看历史记录的功能,包括时长和项目会话,并可为所有项目或单个项目导出工作说明 PDF。网站称,即使 Claude Code 清理了较早的文件,使用数据仍会保留在 Mac 上。

Quick Facts

类别
开发者工具
平台
macOS 15 或更高版本
主要工作流
监控 Claude Code 会话和子代理
界面
MacBook 刘海面板
许可模式
免费且开源
安装选项
Mac 下载或 Homebrew