prabowosd

Clawd Buddy — Git skill for Claude Code

Git community

A small mascot and status band for the Claude Code prompt: usage, context, cache, directory and git.

How to install Clawd Buddy

This entry records only its repository, not the path inside it, so there is no exact command to give. Open prabowosd/clawd-buddy and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Clawd Buddy does

A small mascot and status band for the Claude Code prompt: usage, context, cache, directory and git.

Alternatives in Git

  • 40+ Claude Code Tips — Tips for getting the most out of Claude Code, including a custom status line script, cutting the system prompt 5.8k ★
  • Intel — On-demand intelligence fetch for a target — CVEs, disclosed reports, new features 3.8k ★
  • Git Status — Read the Files and run the Commands and summarize the current state of the git repository 3.4k ★

README

clawd-buddy

A small mascot and a two line status band above the Claude Code prompt.

The left side shows how much of your usage window is gone, how full the context is, how long the prompt cache stays warm, which directory you are in, and the git state of that directory. The right side is a small mascot that blinks while idle and waves while Claude works.

5h ━━────  3%   7d ━─────  7%   ctx 30%   cache 59:12
~/www/app   main ~1 ?2 ↑1 wt:app-topic

The mascot is drawn with half-block characters and 24-bit colour, so there are no images and nothing to download.

Install

Inside Claude Code:

/plugin marketplace add prabowosd/clawd-buddy
/plugin install clawd-buddy@clawd-buddy
/reload-plugins

To try it without installing, clone the repo and start Claude Code with:

claude --plugin-dir plugins/clawd-buddy

It was built and tested on Claude Code 2.1.289, on macOS, in a terminal. The band is only drawn by Claude Code on the terminal and desktop surfaces.

What it shows

Item Meaning
5h, 7d Rate limit usage for the 5 hour and 7 day windows, as a bar and a percentage. Green below 70%, amber from 70%, red from 90%. A dash means Claude Code has not reported a value yet.
ctx Share of the context window in use, coloured the same way.
cache Countdown of the prompt cache. It restarts after each response and turns amber in the last minute. cold means it has expired or nothing has been sent yet.
directory The session directory, with your home folder shortened to ~.
git Branch, then ✓ when clean. Otherwise +n staged, ~n modified, ?n untracked, ↑n ahead and ↓n behind. Inside a linked worktree the worktree name follows as wt:name.

The mascot has three moods: idle (blinks every couple of seconds), working (waves and shuffles its feet while a turn runs) and done (waves for three seconds after a turn finishes).

Behaviour worth knowing

  • The cache countdown assumes a 1 hour