macOS Menu Bar Companion

代理在工作,
猫也在跑。

把 Codex、Claude Code、Gemini CLI 工作的样子搬到了菜单栏的猫上。
不必再切回终端反复确认。

免费 · macOS 14+ · 支持 Apple Silicon & Intel

Agent Cat 菜单栏弹窗
菜单栏上活的信号 不必另开终端。哪个代理在跑、跑得多忙,菜单栏一眼看到。
不会读你的代码 提示、响应、记录都不碰。只在本机读取 CPU 使用率与进程元数据。
已支持代理 OpenAI Codex、Anthropic Claude Code、Google Gemini CLI。全部以本地运行为准。

界面

简单,只留必要的

一个菜单栏弹窗里装下了代理列表、活动指标和设置。

主界面

谁在干活

正在运行的代理与活动状态一眼看尽。没人工作时,猫也跟着睡。

Agent Cat 菜单栏弹窗
Agent Cat 仪表盘
仪表盘

活动指标一目了然

CPU 使用率与进程状态合成活动分。分越高,猫越快。

Agent Cat 更新与快捷操作
控制

更新与快捷操作

更新提醒、刷新、仪表盘、主页、设置和退出都可以在同一个弹窗里完成。

动作

猫的速度,就是代理的速度

活动量不同,菜单栏的猫分三档。一颗图标,告诉你正在发生什么。

待机 睡觉

没有代理在跑,或全都安静时。猫也跟着睡。

轻负载

代理还在动,但很轻。多半在等响应或接命令。

高负载

活动量在上升。多半在写代码或处理重活。

怎么测的

CPU 使用率加上可运行进程数,合成活动分。分越高,猫的脚步越快。

数据从哪来

界面只使用本机 agentcatd 连接器的快照。只有用户同意后,匿名使用统计才会发送到 Agent Cat 服务器。

吉祥物

从猫到幻想吉祥物,都会动。

挑你喜欢的菜单栏吉祥物。运动逻辑相同,跟着活动量加速。

默认

默认跑者。会睡、会走、会跑。应用内可选择多种猫咪配色。

猎豹

更适合高活动量的快速跑者。菜单栏里也保持同样的速度感。

使用新的马匹精灵图。长时间活跃时会在菜单栏轻快奔跑。

撒钱枪

活动量越高,喷出的纸币越多。使用新的精灵图。

金毛寻回犬

静止、行走、奔跑、冲刺四个阶段的小狗精灵图。

吉娃娃

小巧、快速响应的四阶段小狗精灵图。

威尔士柯基

短腿快速的四阶段小狗精灵图。

博美犬

蓬松外形,在菜单栏里也清晰。

柴犬

跟随活动量行走、奔跑的小狗跑者。

小狐狸

适合高活动量的小狐狸跑者。

水獭

低姿态、顺滑移动的四阶段跑者。

小企鹅

显示静止、行走、奔跑和冲刺状态。

仓鼠

圆滚滚的活动量跑者。

刺猬

忙碌时像滚动一样快速运动。

小熊猫

柔和运动的四阶段精灵图。

小兔子

轻快弹跳感的活动状态展示。

小恐龙

绿色恐龙跟随代理活动量移动。

小龙

适合重任务状态的小幻想跑者。

史莱姆

柔软弹跳地显示实时活动。

蘑菇精灵

小森林风格的四阶段吉祥物。

云朵生物

用轻飘飘的形态显示活动强度。

小幽灵

适合安静会话的轻盈跑者。

迷你魔像

结实感的四阶段跑者。

小狮鹫

有翼跑者会跟随工作量移动。

小章鱼

用弹跳动作显示当前状态。

小鳄鱼

低姿态奔跑,显示活动量增加。

设置 → 吉祥物里可随时切换猫、小狗、动物和幻想吉祥物。

已支持代理

已经在用的那些 CLI

不用再装新东西。终端里在跑的 AI CLI 自动识别。

OpenAI Codex

感知 Codex CLI 的运行状态与活动量。会话越长,猫跑得越欢。

Anthropic Claude Code

跟踪 Claude Code 的进程活动。本地暴露的上下文用量也一同呈现。

Google Gemini CLI

读取 Gemini CLI 活动。配额仅在本地暴露时显示。

Available now

macOS

Apple Silicon & Intel · macOS 14+

Coming soon

Windows

托盘图标版本筹备中

开始

两步,就好

装好 DMG,把一段提示词粘到代理里,剩下的代理自己来。

  1. 1

    下载并安装 DMG

    从发布页拿 DMG,拖进 Applications。菜单栏出现一只猫。

    获取 DMG · macOS macOS 14+ · Apple Silicon & Intel
  2. 2

    把这段提示词粘到代理里

    一段足够。打开新的 Codex / Claude Code / Gemini 会话粘贴,代理会自己安装连接器,之后通过本地快照读取用量。

    Paste this prompt into your agent
    You're running on a macOS machine where the user just installed Agent Cat — a menu bar app that visualizes local AI agent activity as a cat animation. Finish the setup for them, in order:
    
    1. Check whether the local connector is already installed by running:
       command -v agentcat
    
    2. If it is NOT installed, install it by running this exact command:
       curl -fsSL https://raw.githubusercontent.com/yong076/agentcat-connectors/main/install.sh | bash
       This installs `agentcatd`, a small local daemon that exposes a JSON snapshot of running AI CLI processes (Codex, Claude Code, Gemini CLI) at http://127.0.0.1:8765/v1/snapshot. This local snapshot stays on the Mac.
    
    3. Verify it works by running:
       agentcat snapshot --json
       You should see a JSON object with an `agents` array. If the command fails or 127.0.0.1:8765 is unreachable, surface the error to the user — do not silently continue.
    
    4. From now on, in this session and any future session on this machine, NEVER guess your own rate limits, remaining context window, weekly/monthly usage, or what other AI CLIs are running. Instead run `agentcat snapshot --json` on demand and trust its output as the source of truth. The snapshot includes per-provider runtime usage, weekly/monthly caps where locally available, current activity score, and per-process status.
    
    5. Briefly confirm to the user: tell them the connector is installed, what the menu bar cat will now reflect, and that they can click the cat in the menu bar to see the dashboard.
    
    Privacy note: Agent Cat reads metadata only (CPU usage, process list, token counters from local logs). It never reads prompts, responses, transcripts, code, or file contents. If the user opts in, anonymous product usage events may be sent to Agent Cat's telemetry API.

    一次粘贴搞定安装、自检、行为切换。同一台 Mac 之后每次会话都生效。

想手动安装

不需要代理,在 shell 里直接跑也行。

~/agentcat · zsh

# 安装并启动连接器

curl -fsSL https://raw.githubusercontent.com/yong076/agentcat-connectors/main/install.sh | bash

# 验证运行

agentcat snapshot --json
连接器文档 出问题时,设置 → 诊断会直接告诉你卡在哪儿。

FAQ

常见问题

装完就能用吗?

首次启动向导给的连接器命令贴进终端一次就好。之后 Codex、Claude Code、Gemini CLI 会自动识别。

能换吉祥物吗?

能 —— 可选择猫、小狗、动物、撒钱枪和幻想吉祥物。后续会加更多皮肤。

会收集代码或提示词吗?

不会。提示词、响应、记录、代码都不读。元数据只在本机读取,只有用户同意后才会发送匿名使用统计。

能在 Mac App Store 拿到吗?

暂时还没上架 App Store。目前只支持直接安装 DMG。

会拖慢电脑或耗电吗?

不会。没有重计算。匿名遥测很轻量,而且只在用户同意后运行。