KeepVibe
rambocode/keep-vibe
Previne sleep do Mac e monitora uso de tokens Claude em tempo real
Ver no GitHubAgent macOS em Swift que impede hibernação do Mac e fornece estatísticas detalhadas de uso de tokens Claude Code e Codex. Funciona como utilitário de menu de barra com monitoramento de status do sistema e análise de consumo de API em múltiplas dimensões temporais.
Instalação
npx convez-ai rambocode/keep-vibe1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter Mac acordado durante sessões prolongadas de desenvolvimento com Claude Code
- Rastrear consumo de tokens e custos de API Claude por dia/semana/mês
- Monitorar progresso da janela deslizante de 5 horas do Claude
- Coletar métricas de uso de ferramentas de IA para análise e otimização
Veredito

Ferramenta prática nativa para usuários macOS que trabalham intensivamente com Claude Code. Combina funcionalidade de produtividade (prevent sleep) com observabilidade técnica (token tracking), bem implementada em Swift com interface SwiftUI limpa.
README
A tradução para o português deste README ainda está na fila.
KeepVibe
macOS 菜单栏工具,提供两大核心功能:
- 保持唤醒:通过 IOKit 电源断言防止 Mac 休眠,支持标准模式(阻止系统空闲休眠)和合盖模式(接通电源时合盖不休眠),可设置永久或定时(1/2/4 小时)。
- AI 用量统计:扫描本地日志,统计 Claude Code(
~/.claude/projects/)和 Codex(~/.codex/sessions/)的 token 用量与费用,按今日 / 本周 / 本月维度展示,并显示 Claude 的 5 小时滑动窗口进度。
截图

构建
swift build -c release
打包(本地)
./scripts/build-macos-app.sh
脚本会生成:
dist/KeepVibe-macos.zipdist/KeepVibe-macos.dmg
运行
.build/release/KeepVibe
App 以菜单栏形式运行,不占用 Dock 位置(NSApp.setActivationPolicy(.accessory))。
常见问题:KeepVibe.app 已损坏
如果启动提示“KeepVibe.app 已损坏,无法打开。你应该将它移到废纸篓。”,通常是 macOS 的 Gatekeeper 额外属性导致。
可按下面步骤处理(先以常见安装路径 /Applications/KeepVibe.app 为例):
# 2) 挂载后,清理 .app 的 quarantine 属性(推荐)
xattr -dr com.apple.quarantine /Applications/KeepVibe.app
处理后再执行:
open /Applications/KeepVibe.app
如果问题仍在,可先确认签名链路(仅用于本地自测验证):
codesign --verify --deep --strict --verbose=4 /Applications/KeepVibe.app
spctl --assess --type execute --verbose=4 /Applications/KeepVibe.app
如果你是从 dmg/zip 下载并解压到其他目录,可把 /Applications/KeepVibe.app 替换为实际路径。
清理后再次打开即可。
另外建议优先下载带签名/公证的正式发布包(workflow 会在标签构建时对发布产物签名)。
功能点
- 菜单栏图标点击展开弹窗(SwiftUI + NSPopover)
- 防睡模式切换:standard / clamshell
- 定时防睡:到期自动停止
- 系统状态面板:CPU 占用、内存使用、电池电量、系统运行时间
- Claude Code 用量:今日/本周/本月 token 及费用,5 小时窗口进度条
- Codex 用量:今日/本周/本月 token 及近似费用
- 开机自动启动(写入
~/Library/LaunchAgentsplist) - 平台要求:macOS 14+,Swift 6