Clawd Buddy — Git skill for Claude Code
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
Related Skills
Claude Usage Band CLI
Usage band for Claude Code: rate limits, context, tokens, speed, cost, tools, git and memory above the prompt
Victor Statusline
Rich status lines for Claude Code and GitHub Copilot CLI — cost, quota, context and prompt-cache health at a g
Claude Code Statusline Ps
PowerShell 7 status line for Claude Code on Windows: context meter, cost, rate limits, git branch, mode badges
Barista
A modular statusline for Claude Code CLI - real-time context usage, rate limits, costs, git status, and 20+ cu
Context Repo
A git repo scoped to a subject instead of a codebase: runbooks, reference docs, inventories, and skills for on
Review Quick
Fast single-pass review for small diffs (<200 lines). Usage: /review-quick [path PR# staged]
Related Agents
Mod Builder
Creates and changes Claude Code mods — plugins of function hooks behind a pane, band, status line, slash comma
Lean Worker
Lean, cache-cheap worker for SIMPLE, bounded tasks — a single file create/edit, a small scripted step, a scope
Stats Analyzer
Analyzes ~/.claude/stats-cache.json and history.jsonl to produce a concise usage report with model token break