convez.ai
PluginProdutividadeIntermediário
RyanSeanPhillips

CLD CTRL

RyanSeanPhillips/cldctrl

Painel de controle para Claude Code: sessões, uso e projetos em um só lugar

Ver no GitHub
BomPluginScore · de 0 a 100

Dashboard 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/cldctrl

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
6
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
13
Contribuidores
1

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

KeyAction
j / kNavigate up / down
g / GJump to top / bottom
Ctrl+d / Ctrl+uHalf-page scroll
TabSwitch pane focus
/Filter projects
EscBack / close overlay
?Help overlay

Actions

KeyAction
EnterLaunch / resume / open
nNew Claude Code session
cContinue last session
lLive conversations view
oOpen in file explorer
pPin / unpin project
hHide project
rRefresh projects
SScan for new projects
,Settings editor

Detail Pane

KeyAction
sSessions tab
cCommits tab
iIssues tab
fFiles tab
Left / RightCycle 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
  • gh CLI (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.

Ver o original no GitHub

Bom para

Relacionados