# CC Status Board — Smart Status Bar for Claude Code

> Add a context meter, AI asset discovery, and session info to your Claude Code status bar. Scans 300+ installed assets (skills, agents, MCP, plugins) and surfaces the most relevant ones as you type. Zero token cost, 100% local.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
git clone https://github.com/henu-wang/cc-status-board.git
cd cc-status-board
node install.js
```

Restart Claude Code. Done.

---

## Intro

CC Status Board is a smart status bar extension for Claude Code with 3 features: a color-coded context window meter, AI asset discovery that surfaces relevant installed tools as you type, and model/directory info. It scans all your installed assets — skills, agents, commands, plugins, and MCP servers — and uses intent classification + TF-IDF scoring to match them to your conversation context. Zero token consumption, runs 100% locally.

Best for: Claude Code users with multiple installed skills, MCP servers, and plugins who want to rediscover and better utilize their AI tools. Works with: Claude Code (CLI, desktop, IDE extensions). Setup time: under 1 minute.

---

## Features

### Context Meter

See how much of your context window you've used at a glance:

```
█░░░░░░░░░  8%    ← Fresh
████░░░░░░ 40%    ← Getting going
███████░░░ 65%    ← Consider wrapping up
██████████ 95%    ← Autocompact incoming
```

Color-coded: green → yellow → orange → blinking red.

### AI Asset Discovery

As you type, the status bar shows the most relevant installed AI assets:

```
You type: "help me do SEO"
Status:   ... │ 💡 /marketing:seo-audit  /backlink-builder

You type: "debug this API error"
Status:   ... │ 💡 /gsd-debug  Agent("gsd-debugger")

You type: "做个数据库查询"
Status:   ... │ 💡 /data:write-query  /data:sql-queries
```

Scans all asset types:
- Skills (`~/.claude/skills/`)
- Agents (`~/.claude/agents/`)
- Commands (`~/.claude/commands/`)
- Plugins (Claude Code built-in)
- MCP Servers (`.mcp.json`)

Smart matching — not just keyword search:
- 35+ intent categories with Chinese + English aliases
- TF-IDF weighting (rare keywords matter more)
- Specificity bonus (specialist tools rank above generalists)
- Diversity filter (max 2 per namespace)

### How It Works

```
You type a message
        │
        ▼
UserPromptSubmit hook
 → Tokenize (CJK bigrams + Latin words)
 → Detect intents (35+ categories)
 → Score assets (TF-IDF + specificity)
 → Write top 3 to temp bridge file
        │
        ▼
Statusline reads bridge file
 → Display: model │ dir │ context% │ 💡 assets
```

Zero token consumption. Everything runs as local Node.js processes.

---

### FAQ

**Q: What is CC Status Board?**
A: A smart status bar extension for Claude Code that shows context usage, model info, and intelligently suggests relevant installed AI assets based on your conversation. Open source, MIT licensed.

**Q: Does it consume tokens?**
A: No. Zero token consumption. All matching runs 100% locally as Node.js processes.

**Q: How do I install CC Status Board?**
A: Clone the repo and run `node install.js`, or use `npx cc-status-board`. Restart Claude Code after installation.

**Q: What assets does it scan?**
A: Skills, agents, commands, Claude Code plugins, and MCP servers — typically 200-400 assets for active users.

---

## Source & Thanks

> Created by [William Wang](https://github.com/henu-wang). Licensed under MIT.
>
> [cc-status-board](https://github.com/henu-wang/cc-status-board)

Built to solve the "I installed 300 tools but forgot what I have" problem.

---
Source: https://tokrepo.com/en/workflows/e7e9ac68-7ad5-4ae9-9e76-d2a338dc0990
Author: henuwangkai