convez.ai
AgenteUtilidadesIntermediário
rambocode

KeepVibe

rambocode/keep-vibe

Previne sleep do Mac e monitora uso de tokens Claude em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent 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-vibe

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
v0.2.0
Issues abertas
0
Contribuidores
2

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 菜单栏工具,提供两大核心功能:

  1. 保持唤醒:通过 IOKit 电源断言防止 Mac 休眠,支持标准模式(阻止系统空闲休眠)和合盖模式(接通电源时合盖不休眠),可设置永久或定时(1/2/4 小时)。
  2. AI 用量统计:扫描本地日志,统计 Claude Code(~/.claude/projects/)和 Codex(~/.codex/sessions/)的 token 用量与费用,按今日 / 本周 / 本月维度展示,并显示 Claude 的 5 小时滑动窗口进度。

截图

KeepVibe 界面截图

构建

swift build -c release

打包(本地)

./scripts/build-macos-app.sh

脚本会生成:

  • dist/KeepVibe-macos.zip
  • dist/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/LaunchAgents plist)
  • 平台要求:macOS 14+,Swift 6
Ver o original no GitHub

Bom para

Relacionados