CLD CTRL
RyanSeanPhillips/cldctrl
Painel de controle para Claude Code: sessões, uso e projetos em um só lugar
Ver no GitHubDashboard terminal para gerenciar sessões do Claude Code com monitoramento de uso, custos e projetos. Oferece visão centralizada de todas as conversas, rastreamento de tokens em tempo real, gestão de problemas GitHub e histórico de commits — sem necessidade de configuração inicial.
Instalação
npx convez-ai RyanSeanPhillips/cldctrl1 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
- Monitorar consumo de tokens e custos em sessões do Claude Code
- Gerenciar múltiplos projetos e retomar conversas anteriores rapidamente
- Acompanhar limites de taxa e uso em janelas móveis de 5h e 7 dias
- Visualizar problemas GitHub e iniciar correções com Claude Code
- Rastrear status Git, commits e mudanças não enviadas por projeto
Veredito

Ferramenta essencial para quem usa Claude Code em fluxo de trabalho profissional. O dashboard unifica sessões, custos e projetos de forma intuitiva, economizando tempo na navegação e oferecendo visibilidade real do consumo de API.
README
A tradução para o português deste README ainda está na fila.
CLD CTRL
A terminal dashboard and session manager for Claude Code. Track sessions, monitor token usage and costs, manage projects, and launch Claude Code — all from one place. Zero config: auto-discovers your existing Claude Code history.
Install
npm i -g cldctrl
Requires Node.js 18+ and Claude Code installed. Also works with npx cldctrl.
Features
Session Intelligence
See every conversation across every project with token counts, tool usage, cost estimates, and model info. Resume any session with one key.
Live Conversations
Watch active Claude Code sessions in real-time. See what tools are being used, token counts updating live, and which sessions are active vs idle.
Usage & Rate Limits
Rolling 5-hour and 7-day usage windows with live rate limit probing. Tier detection, overage monitoring, and per-session cost estimates. Calendar heatmap shows daily usage and commit patterns.
GitHub Issues
Open issues per project with author and labels. Press Enter on an issue to launch Claude Code with a "fix this issue" prompt.
File Browser
Browse project files with lazy-loaded directory tree. Respects .gitignore, shows file type icons, highlights CLAUDE.md files. Press Enter to open in VS Code.
Git Status & Commits
Branch, uncommitted changes, unpushed commits, and behind count shown inline for every project. Commit history with additions/deletions per file.
Session Detail
Drill into individual conversations to see token breakdown, tool usage, model info, MCP servers, and a full activity timeline.
Settings Editor
Edit all settings inline — budget, launch options, notifications, hotkey config. No need to edit JSON files.
More
- Zero config — Auto-discovers projects from your Claude Code history. No manual setup.
- Project launcher — Open file explorer, VS Code, and Claude Code in one action.
- Project scanner — Discover new projects across your filesystem.
- Slash commands — See which Claude Code commands are available and how often they're used.
- Cross-platform — Windows, macOS, and Linux with platform-specific terminal detection.
- Responsive — Adapts to narrow terminals with single-pane mode below 80 columns.
- Global hotkey — Ctrl+Up to launch from anywhere (configurable).
Usage
# Full TUI dashboard
cldctrl # or: cld, cc
# CLI commands
cldctrl list # List all projects with git status
cldctrl launch <name> # Launch Claude Code for a project
cldctrl stats # Show usage statistics
cldctrl issues # Show GitHub issues across projects
cldctrl add <path> # Add a project
cldctrl summarize # Generate AI summaries for sessions
cldctrl setup # Set up global hotkey
# Demo mode (synthetic data)
cldctrl --demo
Keyboard Shortcuts
Navigation
| Key | Action |
|---|---|
j / k | Navigate up / down |
g / G | Jump to top / bottom |
Ctrl+d / Ctrl+u | Half-page scroll |
Tab | Switch pane focus |
/ | Filter projects |
Esc | Back / close overlay |
? | Help overlay |
Actions
| Key | Action |
|---|---|
Enter | Launch / resume / open |
n | New Claude Code session |
c | Continue last session |
l | Live conversations view |
o | Open in file explorer |
p | Pin / unpin project |
h | Hide project |
r | Refresh projects |
S | Scan for new projects |
, | Settings editor |
Detail Pane
| Key | Action |
|---|---|
s | Sessions tab |
c | Commits tab |
i | Issues tab |
f | Files tab |
Left / Right | Cycle tabs |
How It Works
CLD CTRL reads Claude Code's session data from ~/.claude/projects to discover your projects and session history. It parses JSONL session files for token counts, tool usage, and model info. A background daemon polls for git status, GitHub issues, and usage data, caching results for instant startup.
Active sessions are detected via JSONL file modification times — no plugins or hooks required. Multiple simultaneous sessions per project are supported.
On first run, a welcome wizard checks your environment (Claude Code, git, gh) and auto-discovers all your projects. No configuration needed.
Requirements
- Node.js 18+
- Claude Code installed and in PATH
ghCLI (optional — for GitHub issue integration)- VS Code (optional — for project/file opening)
Configuration
Projects are auto-discovered from ~/.claude/projects and can also be configured manually. Config lives at ~/.config/cldctrl/config.json (or %APPDATA%\cldctrl\ on Windows). Use the built-in settings editor (, key) or edit directly:
{
"config_version": 4,
"projects": [
{ "name": "My Project", "path": "/path/to/project" }
],
"launch": { "explorer": true, "vscode": true, "claude": true },
"daily_budget_tokens": 1000000,
"notifications": {
"github_issues": { "enabled": true, "poll_interval_minutes": 5 },
"usage_stats": { "enabled": true }
}
}
Author
Ryan Phillips — @RyanSeanPhillips
License
AGPL-3.0 — you can use CLD CTRL freely, but if you modify and distribute it (or run it as a service), you must open-source your changes under the same license.
Copyright 2025-2026 Ryan Phillips. All rights reserved.