---
title: "pace-line"
url: "https://claudemods.dev/zh-tw/builds/pace-line-1806ac"
source: "https://github.com/thaiquangquy/claude.me/tree/master/mods/pace-line"
source_type: "github"
repo: "https://github.com/thaiquangquy/claude.me/tree/master/mods/pace-line"
author: "thaiquangquy"
author_handle: "thaiquangquy"
stars: 0
category: "儀表板與 HUD"
categories: ["hud"]
tags: ["context-usage", "git-stats", "hooks", "rate-limit", "statusline"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add thaiquangquy/claude.me\nclaude plugin install pace-line@thaiquangquy-skills"
added: "2026-10-11T03:14:55.491Z"
updated: "2026-10-11T04:27:29Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# pace-line

適用於終端機與桌面的雙行狀態列：模型、努力度、上下文條、git 統計以及 5 小時/7 天速率限制配速

## Description

pace-line 是一個 Claude Code 外掛，在提示列上方顯示兩行狀態帶：session 模型與 effort、context 使用量長條、專案/分支/變更行數，以及 5 小時與 7 天速率限制的使用量、配速（超前或落後均勻消耗的程度）與重置時間。它透過 Claude Code hook API 在本機讀取資料，不進行任何網路呼叫或寫入檔案，唯一執行的程式是唯讀的 git 指令（用於取得分支與 diff 統計），並以 --no-optional-locks 避免影響索引。可透過 /config 或 claude plugin configure 設定 surfaces（both/desktop/terminal）與 showModel 選項，安裝方式為 /plugin install pace-line --marketplace thaiquangquy/claude.me。

## Install

```
claude plugin marketplace add thaiquangquy/claude.me
claude plugin install pace-line@thaiquangquy-skills
```

## Original README

# pace-line

Know how fast you are burning your Claude quota, without leaving the prompt.

```
Opus 5.5 (1M) medium |  claude.me (master) 2f +10 -3
████░░░░░░ 42% 1M    |  5h 35% ⇣15% 2h  7d 80% ⇡9% 2d
```

## 🌟 Highlights

- **Pace, not just usage**: the 5-hour and 7-day limits show how far ahead (`⇡`, red) or behind (`⇣`, green) an even burn you are, with the time to reset.
- **Terminal and desktop**: one band above the prompt in the terminal and the desktop Code tab; the `surfaces` option limits it to one of them.
- **Honest effort**: shows the effort the session actually sent with its last model request, never a guess from `settings.json`.
- **Git at a glance**: project, branch, and files changed with lines added and deleted.
- **No setup scripts**: a plugin of function hooks; no `jq`, no shell script, no `statusLine` setting.

## ℹ️ Overview

pace-line is a Claude Code mod that draws the same two lines as this repo's [`statusline.sh`](../../statusline.sh) as a band directly above the prompt.

| Part | Meaning |
|---|---|
| `Opus 5.5 (1M)` | Session model and the context window Claude Code reports |
| `medium` | Effort of the session's last model request; `–` before the first request, after a `/model` switch, or for a model without effort |
| `claude.me (master) 2f +10 -3` | Project, branch, files changed, lines added and deleted |
| `████░░░░░░ 42% 1M` | Context used: green below 70%, yellow from 70%, red from 90% |
| `5h 35% ⇣15% 2h` | 5-hour limit: used, pace, time to reset |
| `7d 80% ⇡9% 2d` | 7-day limit: used, pace, time to reset |

**Pace** is the used % minus the share of the window already elapsed. `⇡9%` means you are 9 points ahead of an even burn and will hit the limit before it resets; `⇣15%` means you have room to spare. Without rate-limit data (an API-key account) the band shows `5h --  7d --` and the session cost instead.

### 🔒 What it runs and sends

**Sends nothing.** pace-line makes no network calls and writes no files. Everything it shows comes from your own machine and stays there; the only output is the band it draws.

**Reads**, locally, through Claude Code's hook API:

| Call | What it reads | Why |
|---|---|---|
| `$.session.usage()` | Context use, rate-limit percentages and reset times, session cost | Context bar, 5h/7d pace |
| `$.session.model()` | Session model id | Model name, and to tie effort to the model |
| `$.session.root()` | Project directory path | Project name, the folder `git` runs in |
| `$.env.get('CLAUDE_CODE_AUTO_COMPACT_WINDOW')`, `$.env.get('HOME')` | Two environment variables | Context-window label; shorten the path to `~` |
| `turn.step` event | The effort level of each main-loop model request | Effort label |

**Runs one program: `git`**, through `$.process.run`, which starts a local program and reads its output. It is read-only (`--no-optional-locks` keeps it from touching the index), runs in the project directory, at most once every 5 seconds and after an edit tool. These are the only commands, word for word, with `<dir>` the project directory:

| Command | Why |
|---|---|
| `git -C <dir> --no-optional-locks rev-parse --git-dir` | Check the project is a git repo |
| `git -C <dir> --no-optional-locks branch --show-current` | Branch name |
| `git -C <dir> --no-optional-locks diff HEAD --numstat` | Files changed, lines added and deleted |

Outside a git repo, the git part of line 1 is left out.

### ✍️ Authors

- [thaiquangquy](https://github.com/thaiquangquy)

## 🚀 Usage

Once installed, the band appears above the prompt in every session. Configure it in `/config` (the `pace-line` rows); a change applies at once.

| Option | Values | Effect |
|---|---|---|
| `surfaces` | `both` (default), `desktop`, `terminal` | Where the band shows; `desktop` leaves the terminal to `statusline.sh` |
| `showModel` | `true` (default), `false` | `false` drops model, context window and effort from line 1 (the Claude UI already shows them) |

Or from a shell:

```bash
echo '{"surfaces":"desktop","showModel":"false"}' | claude plugin configure pace-line --values-stdin
```

Turn it off everywhere, and back on:

```bash
claude plugin disable pace-line
```

```bash
claude plugin enable pace-line
```

## ⬇️ Installation

From a terminal Claude Code session (the desktop Code tab cannot run this command):

```
/plugin install pace-line --marketplace thaiquangquy/claude.me
```

Answer `y` to add the marketplace, then pick the **user** scope so the band shows in every session, desktop included.

Update to a newer version, then run `/reload-plugins` in any open session:

```bash
claude plugin update pace-line
```

For development setup, see [DEVELOPMENT.md](DEVELOPMENT.md).

## 💭 Feedback and Contributing

Open an issue or a pull request on [thaiquangquy/claude.me](https://github.com/thaiquangquy/claude.me). See [DEVELOPMENT.md](DEVELOPMENT.md) for running and testing the mod locally.

pace-line is part of [claude.me](../../README.md).

## 📄 License

[MIT](../../LICENSE). See also the [privacy policy](PRIVACY.md) and [terms of service](TERMS.md).