vinzdg/codenotch

Codenotch – 一个用于 AI 编程助手使用限制的微型屏幕监视器

它是什么

• 一个 macOS（以及通过 Rust/Tauri 移植的 Windows 版本）实用工具，以一个小型“凹口”形式固定在屏幕任意边缘。凹口中的每个环代表一个编程助手提供商（Claude、Cursor、Codex、Ollama 等），并显示该提供商的配额已消耗多少、配额何时重置，以及助手当前是忙碌、完成还是等待您。

为什么您可能需要它

• 如果您经常使用多个具有每日/每周令牌限制的 AI 编程工具，Codenotch 让您一目了然，避免意外超出配额。
• 它还会在限制超过 80% 或达到 100% 时提醒您。
• 界面不显眼：一个细长的药丸形状，悬停时展开，可选择始终显示或菜单栏模式。

主要功能（根据 README 描述）

• 提供商支持 – 从数十种服务读取使用数据，包括云服务（Claude、DeepSeek、Antigravity、OpenCode、GitHub Copilot 等）和本地运行时（Ollama、LM Studio、oMLX）。大多数提供商重用各自 CLI 或桌面应用已存储的凭据；少数（DeepSeek、MiniMax、QianwenAI）需要通过嵌入式 WebView 显式登录。
• 实时状态 – 会话忙碌时环旋转，阻塞时呈琥珀色脉冲，并显示包含当前限制窗口、重置时间和会话状态的工具提示。
• 多账户处理 – 检测单独的配置目录（例如 ~/.claude-work），并为每个账户创建单独的环。
• 手机伴侣 – iOS/Android 应用可通过本地网络 QR 码配对镜像相同的使用百分比。
• 自定义端点 – 您可以添加任意 OpenAI 兼容、Anthropic 或 Gemini 端点，并手动输入使用数据。
• 速度与思考指标 – 对于本地模型（Ollama、LM Studio、oMLX），您可以启用每秒令牌数和“思考”时间的测量，而无需向 Codenotch 发送任何提示。
• 高度可配置的界面 – 选择边缘位置、大小、颜色、始终显示或仅悬停显示、Dock/菜单栏可见性，以及菜单栏摘要中显示的提供商。
• 提醒 – 当提供商的使用率超过 80% 或达到 100% 时，macOS 通知会触发一次，并具有每个提供商的静音控制。
• 更新 – macOS 提供签名、公证的版本；Windows 安装程序（未签名）用于 Tauri 移植；main 分支提供预览构建。

安装

• macOS – 从发布页面下载最新的 Codenotch.dmg。应用已签名并公证；拖到应用程序后，您可能需要清除隔离标志（xattr -dr com.apple.quarantine /Applications/Codenotch.app）。
• Windows – 下载 Codenotch-Setup.exe；安装程序无需管理员权限即可运行，并在需要时获取 WebView2。
• 从源代码 – README 指向构建部分（此处未复制）以编译 Swift macOS 应用或 Rust/Tauri Windows 版本。

底层工作原理

• 对于云提供商，它查询官方 CLI 或桌面应用使用的相同使用端点，重用机器上已有的 OAuth 令牌、API 密钥或钥匙串条目。
• 对于本地运行时，它发现正在运行的服务器，读取状态套接字或日志文件（~/.lmstudio/server-logs、~/.omlx/logs/server.log），并提取令牌计数和速度指标。任何提示或响应数据都不会传输到 Codenotch。
• 手机应用通过同一网络本地通信；配对使用一次性 QR 码，五分钟后过期。

许可证

• MIT（如 README 中的徽章所示）。

谁可能使用它

• 需要管理多个 AI 编程助手并保持在配额限制内的开发者。
• 希望为助手等待用户输入时提供共享视觉提示的团队。
• 任何更喜欢轻量级、始终可见的状态栏而不是打开每个提供商仪表板的人。

---

以上所有信息均直接取自项目 README；未推断任何额外功能。