convez.ai
PluginProdutividadeIntermediário
Eyalm321

ClawdPanel

Eyalm321/clawdpanel

HUD desktop retro para Claude Code — monitor tokens, troque contas, dock multi-monitor

Ver no GitHub
InicialPluginScore · de 0 a 100

Um HUD desktop retro-estilizado para usuários de Claude Code que monitora consumo de tokens em tempo real, permite trocar entre múltiplas contas e oferece rádio Lo-Fi integrada. Funciona como barra nativa cross-platform (Windows, macOS, Linux) com dock multi-monitor e integração com bandeja do sistema.

Instalação

$npx convez-ai Eyalm321/clawdpanel

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v2.2.13
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar consumo de tokens em sessões longas de Claude Code
  • Gerenciar múltiplas contas Claude simultaneamente
  • Integrar produtividade com ambiente desktop native sem abas de navegador

Veredito

ClawdPanel é uma solução sólida para power users que rodamCode intensivamente — oferece monitoramento de tokens prático e multi-conta via HUD nativo leve (~6MB). A estética retro é funcional, mas a ferramenta depende fortemente do ecossistema Claude Code, limitando seu público a esse nicho específico.

README

A tradução para o português deste README ainda está na fila.


💡 Why ClawdPanel?

A permanent lightweight desktop HUD for Claude Code users — live token monitoring, multi-account switching, cross-monitor docking, retro terminal aesthetics, ambient Lo-Fi radio, zero-browser workflow.

Unlike browser dashboards or terminal-only tools, ClawdPanel lives directly in your desktop environment with native OS integrations: Windows AppBar reservation, macOS LaunchAgents, Linux _NET_WM_STRUT_PARTIAL, system-tray everywhere.

👤 Built for

  • Claude Code power users running long sessions
  • Teams juggling multiple Claude accounts
  • Terminal enthusiasts and retro / CRT-aesthetic fans
  • Anyone who prefers a HUD over an extra browser tab

🎬 Demo

Animated demos coming soon. For now, see the bar layout above and the themes section below.


🖥️ Core Features

  • Live token usage — weekly + hourly consumption, percentage, shaded progress bar, reset countdown
  • Multi-account — switch any number of Claude accounts (separate ~/.claude paths) via tray or Settings
  • Multi-monitor docking — pick the target monitor at any time; reserves screen space on Windows + Linux X11
  • Pin / auto-hide on hover — unpin to slide the bar off-screen; cursor at top edge slides it back
  • System tray — switch account, switch monitor, toggle start-on-login, manage accounts, quit
  • Start on login — native autostart on all three platforms
  • 5 retro themes — Claude, Fallout, Amber, Matrix, Dracula
  • Headless Claude FM — embedded Lo-Fi YouTube stream with custom volume control

🚀 Quick Start

Download from the Releases page:

PlatformFileNotes
Windows 10/11 x64ClawdPanel-*-windows-amd64-setup.exeNSIS installer. Requires WebView2 Runtime (pre-installed on Win11).
macOS 10.13+ (Intel + Apple Silicon)ClawdPanel-*-macos-universal.pkgDouble-click to install to /Applications.
Debian / Ubuntuclawdpanel_*_amd64.debsudo apt install ./clawdpanel_*_amd64.deb
Fedora / RHELclawdpanel-*.x86_64.rpmsudo dnf install ./clawdpanel-*.x86_64.rpm
Any Linux (portable)ClawdPanel-x86_64.AppImagechmod +x ClawdPanel-x86_64.AppImage && ./ClawdPanel-x86_64.AppImage

Installers wire up Claude Code's statuslineCommand automatically and clean it up on uninstall — no terminal commands needed. AppImage users get a one-time first-run prompt instead.

  • Windows → SmartScreen "Windows protected your PC" → More info → Run anyway
  • macOS → "ClawdPanel cannot be opened…" → System Settings → Privacy & Security → Open Anyway, or right-click the .app → Open
  • Linux .deb/.rpm → no warnings (root install)
  • AppImage → no warnings (user-mode)

Requires Go 1.25+, Node.js 18+, Wails v2 CLI (go install github.com/wailsapp/wails/v2/cmd/wails@latest). On Linux also: libgtk-3-dev, libwebkit2gtk-4.1-dev, libayatana-appindicator3-dev, pkg-config.

wails dev                                         # hot-reload dev mode
wails build -platform windows/amd64 -nsis         # Windows installer
wails build -platform darwin/universal            # macOS .app (then build/darwin/scripts for .pkg)
wails build -platform linux/amd64 -tags webkit2_41  # Linux binary (then nfpm/AppImage via build/linux/*)

🎨 Visual Design

Five distinct CRT-scanline-filtered themes, cycle on the fly:

ThemeVibe
🔸 CLAUDE (default)Flat CLI — signature terracotta orange (#d77757), lavender badges (#b1b9f9), white headers
🟢 FALLOUTPip-Boy green HUD, outlined progress brackets, glowing CRT scanlines
🟡 AMBERDEC VT100 / Fallout NV amber terminal — glowing values, dimmed labels
📟 MATRIXDigital rain — sharp green characters, blinking caret synced to warning status
😈 DRACULASleek dark mode — cyan labels, pastel pink progress

Typography & TUI glyphs

  • Developer-first font stack: prefers Cascadia Mono / Cascadia Code, then SF Mono, Menlo, Fira Code, JetBrains Mono, DejaVu Sans Mono, Inconsolata — uses whatever's installed.
  • Retro shaded meters: usage rendered with ░▒▓█ glyphs that change shade with warning tier; unused cells are faint terminal middle dots (·).

🛠️ Advanced Features

Pin / auto-hide

A pin icon to the right of THEME toggles:

  • Pinned (orange, tilted): docked, permanently visible — the default.
  • Unpinned (gray, upright): bar slides up off-screen; cursor at the top edge slides it back.

Go-side cursor polling at 80 ms — WebView2's mouseleave is unreliable on a 28 px window. A 200 ms grace period prevents accidental dismissal on cursor overshoot. The slide animates the OS window's Y position at ~60 fps (ease-out cubic) with a SetWindowRgn clip that masks any portion that would spill onto a monitor sitting above. (Windows only at v1; on macOS / Linux the toggle still affects docked-vs-floating state but the slide is a no-op.)

Multi-monitor docking

Pick the target monitor from the tray menu. On Windows, AppBar mode uses SHAppBarMessage to reserve screen space — maximized windows automatically tile below. On Linux X11 it sets _NET_WM_STRUT_PARTIAL for compatible compositors. On macOS and Linux Wayland the bar floats at the topmost window level without reserving space.

Claude FM (headless Lo-Fi radio)

Embedded YouTube audio stream — no browser windows needed.

  • 📻 Masked marquee: when playing, the label scrolls NOW PLAYING CLAUDE FM · horizontally behind a 75 px mask; reverts instantly on pause.
  • 🔊 0–200 % volume range: extended headroom mapped linearly to YouTube's 0–100.
  • 🎛️ Dual control: scroll-wheel adjusts in 5 % steps; clicking VOL cycles in 10 % steps.
  • 💾 State persistence: volume and theme saved to localStorage.

Smart status overrides

Dynamic and static OFFLINE indicators are translated globally into a lavender IDLE badge (#b1b9f9) to preserve your active CLI context.


🧭 Architecture

Anthropic  GET /api/oauth/usage        Claude Code (CLI)
   (direct, bypasses any proxy)               │
       │                                       │  statuslineCommand hook
       │  OAuth token from .credentials.json   ▼
       │                              ~/.claude/rate_limits.json   ←  written every prompt
       │                                       │  (fallback when the direct fetch is unavailable)
       └──────────────┬────────────────────────┘
                      │  poll (refreshSeconds), live source preferred
                      ▼
            ClawdPanel backend (Go)
                      │
                      │  Wails IPC (JSON bindings)
                      ▼
            WebView frontend (HTML/CSS/JS)
                      │
                      └── OS integrations: AppBar / NSWindow / X11 dock,
                                           system tray, autostart, monitors

ClawdPanel fetches usage directly from Anthropic (/api/oauth/usage, using the account's stored OAuth token), hardcoded to the real API host so it keeps updating even when Claude Code is pointed at a proxy (e.g. ANTHROPIC_BASE_URL, Headroom) that doesn't relay rate-limit data. The statusline-written rate_limits.json is used as a fallback when the direct fetch is unavailable (offline, expired token). Set CLAWDPANEL_DISABLE_LIVE_USAGE=1 to disable the direct fetch and use the file only.


⚙️ Configuration

Auto-created on first run:

PlatformPath
Windows%APPDATA%\ClawdPanel\config.json
macOS~/Library/Application Support/ClawdPanel/config.json
Linux$XDG_CONFIG_HOME/ClawdPanel/config.json (fallback ~/.config/ClawdPanel/config.json)
{
  "monitor": 0,
  "theme": "claude",
  "opacity": 0.92,
  "refreshSeconds": 15,
  "barHeight": 28,
  "appBarMode": true,
  "startWithWindows": false
}

Accounts are managed inside the app — open Manage accounts from the system tray to add, rename, switch between, or remove Claude account paths. No JSON editing required.

FieldDescription
barHeightPixel height of the bar
refreshSecondsRe-read interval for Claude data files
themeclaude, fallout, amber, matrix, dracula
appBarModeReserve screen space (Windows / Linux X11 only)

ClawdPanel reads ~/.claude/rate_limits.json, populated by Claude Code's statuslineCommand hook. Installers set this hook automatically and clear it on uninstall by editing ~/.claude/settings.json (only the statuslineCommand key — other keys are preserved).

If you built from source or are using the AppImage and want to configure manually:

claude config set statuslineCommand "node -e \"const fs=require('fs');const p=require('path');const os=require('os');const d=fs.readFileSync(0,'utf-8');if(d){const parsed=JSON.parse(d);fs.writeFileSync(p.join(os.homedir(),'.claude','rate_limits.json'),JSON.stringify({...parsed,captured_at:Date.now()}))}\""

Every Claude prompt then writes a tiny JSON payload to rate_limits.json, which ClawdPanel picks up instantly.


📁 Project Structure

clawdpanel/
├── main.go                          # Wails bootstrap + embed directives
├── app.go                           # App struct + Wails-exported bindings
├── icon_{windows,darwin,linux}.go   # Per-OS tray icon embedding
├── internal/
│   ├── config/
│   │   ├── config.go                # Config struct, Load/Save, cross-platform AppDataDir
│   │   └── startup_{windows,darwin,linux}.go  # autostart (registry / LaunchAgent / .desktop)
│   ├── claude/                      # Read Claude JSON files, compute BarData
│   ├── platform/                    # Per-OS window + monitor APIs
│   │   ├── window_{windows,darwin,linux}.go
│   │   └── monitor_{windows,darwin,linux}.go
│   └── tray/                        # System tray via fyne.io/systray
├── frontend/                        # Wails webview UI
└── build/
    ├── windows/installer/           # NSIS template + statusline PowerShell script
    ├── darwin/scripts/              # pkgbuild postinstall/preuninstall bash scripts
    └── linux/                       # nfpm.yaml, .desktop, AppDir, AppRun, postinstall.sh

⚠️ Known limitations (v1 cross-platform)

  • Linux Wayland: no portable protocol for "stay above other windows" or "reserve screen space". KWin honors _NET_WM_WINDOW_TYPE_DOCK; GNOME/Mutter mostly ignores it; wlroots compositors (Hyprland, Sway) vary. X11 sessions work correctly.
  • macOS docking: NSWindow at NSStatusWindowLevel floats above other windows but can't reserve screen space the way Windows AppBar does — accepted as macOS-native behavior.
  • macOS Gatekeeper (unsigned v1): see First-launch security warnings in Quick Start.
  • Settings merge safety: if ~/.claude/settings.json already exists but contains invalid JSON, the installer logs a warning and skips the modification rather than overwriting it.

📄 License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados