METRICC

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 41 Open GitHub ↗

A Clean, Lightweight, Design Focused Status Bar for Claude Code

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# METRICC
### A Clean, Lightweight, Design-Focused Status Bar for Claude Code
---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-layout-red-500-regular.png) Choose Inline or Stacked
Two layout modes. Same data. Pick whichever fits your workflow.

**Stacked** — labels on top, values below (default)

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/hero.png)

**Horizontal** — labels and values on one line, half the height

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/layout-horizontal.png)

---
## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-question-violet-500-regular.png) Why This Exists

I'm a graphic designer with 20+ years of experience and a partner named ADHD.

This is the only Claude Code status bar (that I am aware of) that was created from a "design first" perspective.

With a focus on color, spacing, and a great user experience, I spent more time than I would like to admit fine tuning everything.

- **Is it perfect? NO!**
    - ###### ADHD rarely let's me be satisfied or think something I have done is perfect.

- **Will it get better?**
    - ###### Eh. Maybe? We'll see if I get bored of it or not.

In the meantime, I hope you enjoy...

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-box-arrow-down-lime-500-regular.png) Requirements

- ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-check-slate-500-regular.png) Node.js 18+ (you already have this if Claude Code is installed)
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-check-slate-500-regular.png) Claude Code with an active login
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-x-slate-500-regular.png) No npm packages
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-x-slate-500-regular.png) No tracking or telemetry

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-paint-brush-teal-500-regular.png) Color-Coded Thresholds

Values change color as they approach limits:

| | Rate Limits | Context Window | Cost |
|---|---|---|---|
| **Green** | 0–59% | 0–69% | < $0.25 |
| **Amber** | 60–79% | 70–84% | $0.25–$1.00 |
| **Red** | 80%+ | 85%+ | $1.00+ |

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-article-cyan-500-regular.png) Segments Up Close

**Rate Limits** — 5h and 7d rolling windows with reset countdowns

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/seg-rate-new.png)

**Context** — how full the current conversation window is

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/seg-context-new.png)

**Changes** — lines added (green) and removed (red) this session

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/seg-changes.png)

**Model & Version** — green dot = latest, yellow dot = update available

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/seg-model-version.png)

**Cost** — color-coded by spend

**Agents** — auto-appears when active, shows model + task per agent

![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/seg-agents.png)

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-list-checks-orange-500-regular.png) Choose From 16 Stats

###### Rate Limits
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-percent-slate-500-regular.png) 5-hour usage %
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-percent-slate-500-regular.png) 7-day usage %
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-clock-countdown-slate-500-regular-flip-horizontal.png) 5-hour reset countdown
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-clock-countdown-slate-500-regular-flip-horizontal.png) 7-day reset countdown

###### Context & Tokens
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-percent-slate-500-regular.png) Context window used
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-code-slate-500-regular.png) Input tokens
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-code-slate-500-regular.png) Output tokens
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-percent-slate-500-regular.png) Cache hit rate

###### Session Info
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-timer-slate-500-regular.png) Session duration
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-timer-slate-500-regular.png) API response time
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-git-diff-slate-500-regular.png) Lines added / removed
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-folder-slate-500-regular.png) Working directory
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-currency-dollar-slate-500-regular.png) Session cost (USD)

###### Model & Version
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-cpu-slate-500-regular.png) Current model
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-flag-banner-slate-500-regular.png) Claude Code version

###### Auto (appear when active)
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-robot-slate-500-regular.png) Running agents + tree view
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-check-square-slate-500-regular.png) Todo progress

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-rocket-launch-indigo-500-regular.png) Install

Pick whichever method you're most comfortable with. All three get you the same result.

<details>
<summary>![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-magic-wand-emerald-500-regular.png) Easy — Let Claude Do It</summary>

&nbsp;

Copy the repo URL below and paste it into Claude Code with the prompt:

```
https://github.com/professionalcrastinationco/METRICC

Install the METRICC statusline from this repo.
```

Claude will download the script, update your settings, and restart — no manual steps needed.

</details>

<details>
<summary>![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-download-simple-sky-500-regular.png) Manual — Download & Configure</summary>

&nbsp;

#### Step 1 — Download the script

Go to the [raw script file](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/metricc-cc-statusbar.mjs) and save it to your Claude config folder:

| OS | Save to |
|---|---|
| **macOS / Linux** | `~/.claude/hud/metricc-cc-statusbar.mjs` |
| **Windows** | `C:\Users\YourName\.claude\hud\metricc-cc-statusbar.mjs` |

Create the `hud` folder if it doesn't exist.

#### Step 2 — Update settings

Open your `settings.json` file:

| OS | Location |
|---|---|
| **macOS / Linux** | `~/.claude/settings.json` |
| **Windows** | `C:\Users\YourName\.claude\settings.json` |

Add the following block (or merge it into your existing settings):

**macOS / Linux:**
```json
{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/hud/metricc-cc-statusbar.mjs",
    "padding": 0
  }
}
```

**Windows:**
```json
{
  "statusLine": {
    "type": "command",
    "command": "node C:\\Users\\YourName\\.claude\\hud\\metricc-cc-statusbar.mjs",
    "padding": 0
  }
}
```

#### Step 3 — Restart Claude Code

</details>

<details>
<summary>![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-terminal-violet-500-regular.png) Advanced — Terminal Commands</summary>

&nbsp;

#### macOS / Linux (Bash)

```bash
mkdir -p ~/.claude/hud
curl -o ~/.claude/hud/metricc-cc-statusbar.mjs \
  https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/metricc-cc-statusbar.mjs
```

Then add to `~/.claude/settings.json`:
```json
{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/hud/metricc-cc-statusbar.mjs",
    "padding": 0
  }
}
```

#### Windows (PowerShell)

```powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\hud"
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/metricc-cc-statusbar.mjs" `
  -OutFile "$env:USERPROFILE\.claude\hud\metricc-cc-statusbar.mjs"
```

Then add to `C:\Users\YourName\.claude\settings.json`:
```json
{
  "statusLine": {
    "type": "command",
    "command": "node C:\\Users\\YourName\\.claude\\hud\\metricc-cc-statusbar.mjs",
    "padding": 0
  }
}
```

#### After either — Restart Claude Code

</details>

> **Upgrading?** Re-run the download or let Claude re-install. Your config is preserved.

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-gear-six-sky-500-regular-config.png) Configuration

Edit `~/.claude/hud/config.jsonc` to toggle any stat on or off:

```jsonc
{
  "layout": "vertical",     // or "horizontal"

// ── Standard (on by default) ──
  "5h Usage": true,
  "7d Usage": true,
  "Context": true,
  "Model": true,
  "Version": true,

// ── Session (off by default) ──
  "Session": false,
  "Changes": false,
  "Directory": false,
  "Cost": false,

// ── Advanced (off by default) ──
  "Tokens": false,
  "Output Tokens": false,
  "Cache": false,
  "API Time": false,
  "5h Reset": false,
  "7d Reset": false
}
```

- ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-check-square-slate-500-regular.png) No restart required — changes apply on next render
 - ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-16px-check-square-slate-500-regular.png) Missing keys fall back to their section default

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-question-violet-500-regular.png) FAQ

**All I see is the labels, no values** — [#4](https://github.com/professionalcrastinationco/METRICC/issues/4)

You probably have more stats set to display than the width of your terminal window can support. We're working on making this more responsive. For now, the fix is to set some of the stats you can go without viewing to `false` in your `config.jsonc` file.

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-list-checks-orange-500-regular.png) Known Bugs

- **The first label color gets darker randomly** — [#3](https://github.com/professionalcrastinationco/METRICC/issues/3)

---

## ![](https://raw.githubusercontent.com/professionalcrastinationco/METRICC/main/docs/images/icon-20px-handshake-pink-500-regular.png) Acknowledgments

METRICC was inspired by the [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) framework.

Thanks to the following contributors who submitted PRs that helped shape improvements already included in METRICC:

- [@zachary95](https://github.com/zachary95) — human-friendly model names ([#6](https://github.com/professionalcrastinationco/METRICC/pull/6))
 - [@crimist](https://github.com/crimist) — API cost support ([#2](https://github.com/professionalcrastinationco/METRICC/pull/2))
 - [@DustyDiamond](https://github.com/DustyDiamond) — statusLine config fix ([#1](https://github.com/professionalcrastinationco/METRICC/pull/1))

## License

MIT

METRICC

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README