GitHub リポジトリ · 投稿者 Haworthiasa

limit-line

Name: limit-line
Author: Haworthiasa

Claude Code 用モッドです。プロンプト上部に制限行（5 時間/週、コンテキスト、キャッシュヒット）を表示し、/usage-plus パネルと pytest や長いログ向けの Bash 出力ディスティラーを提供します。

Haworthiasa@Haworthiasa

Haworthiasa/limiter/tree/main/limit-line

翻訳済み

この mod について

limit-line は Claude Code 用モッド（≥ 2.1.287）です。プロンプト欄の上に制限バンド（5 時間、週、コンテキスト、キャッシュヒット、コンテキスト差分、ディスティラーの切り詰めレベル）、ターン詳細行、Session/Week/Month の 3 タブを持つ /usage-plus パネル、Bash 出力ディスティラーを備えています。長い出力（≥ 8000 文字）は Claude が読む前に ≤ 4000 文字へ短縮され、完全な版は <project>/.claude/distill/ に保存されます。pytest 専用のフィルター（シグネチャごとにエラーをまとめる）もあり、リストに一致する失敗コマンド（pytest、python train、docker logs、pip install、make/ninja/cargo/npm build）は実行前にラップされます。コマンド：/limits、/limits detail、/usage-plus、/distill on|off|stats|last。データは ~/.local/share/limit-line/ に保存されます。Claude Code の PATH には node ≥ 23.6 が必要です。コストは hooks/pricing.ts に基づく API-equiv であり、サブスクリプションプランで実際に支払う金額ではありません。

インストール

まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。

claude plugin marketplace add Haworthiasa/limiter
claude plugin install limit-line

原文 / README

limit-line

Mod cho Claude Code (≥ 2.1.287): dòng hạn mức phía trên ô prompt, bảng /usage-plus, và bộ chưng cất output Bash.

Tính năng

Band (phía trên prompt):

5h █░░░░░ 13% 2h19m | wk ██░░░░ 34% T2 10:00 | ctx ░░░░░░ 7% ▲+18k | cache 90% | dist -142k   [+]
turn 4 req · in 61k (cache 55k · write 4k · new 2k) · out 2.3k · ~$0.42 · opus · ctx ▃▄▆█

5h / wk: hạn mức 5 giờ và tuần, thời điểm reset, ! khi dự báo sẽ cạn trước khi reset. Có toast ở 80% và 95%.
ctx: mức đầy context; ▲+N / ▼-N: context đổi bao nhiêu trong turn vừa xong (đỏ nếu quá 10% cửa sổ).
cache N%: tỉ lệ cache hit của turn vừa xong (xanh ≥ 80, vàng 50–79, đỏ < 50).
dist -N: số ký tự distiller đã cắt trong phiên.
[+] / /limits detail: dòng chi tiết turn (số request, token theo loại, chi phí API-equiv, model, biểu đồ ctx). Lựa chọn được nhớ giữa các phiên.
Màn hình hẹp: bỏ dist, rồi ▲, rồi cache, rồi thu gọn thanh.

/usage-plus: pane ba tab, phím 1 Session, 2 Week, 3 Month, x đóng (cần focus pane: click hoặc ctrl+x tab). Token theo loại mỗi ngày, cache hit, tiền tiết kiệm nhờ cache, các lần cache bust kèm nguyên nhân (sau /compact, hết TTL, đổi model, không rõ), phân bổ theo model và project, lịch sử hạn mức và dự báo tuần, thống kê distiller. Mỗi lần mở sẽ chạy indexer (đọc tăng dần ~/.claude/projects).

Distiller (hook trên Bash): output dài (≥ 8000 ký tự) được rút gọn còn ≤ 4000 trước khi Claude đọc; bản đầy đủ luôn lưu ở <project>/.claude/distill/ (tự thêm vào .gitignore của repo git). Có bộ lọc riêng cho pytest (gom lỗi theo chữ ký, traceback đầu của mỗi nhóm), các log khác dùng bộ lọc chung (đầu, cuối và mọi dòng lỗi).

Lệnh thành công: output được thay sau khi chạy.
Lệnh thất bại: core không cho rút gọn sau khi chạy, nên các lệnh khớp danh sách (pytest, python *train*, docker logs, pip install, make/ninja/cargo/npm build) được bọc trước khi chạy: output đầy đủ ghi ra file, in bản rút gọn, giữ đúng mã thoát. Vì vậy quy tắc permission sẽ thấy lệnh đã bọc.

Lệnh

| Lệnh | Việc | |---|---| | /limits | Ẩn / hiện band | | /limits detail | Bật / tắt dòng chi tiết turn | | /usage-plus | Mở bảng usage (nếu trùng tên: /usage-x) | | /distill on / off | Bật / tắt distiller (nhớ giữa các phiên) | | /distill stats | Số lần, ký tự đã cắt theo loại, tỉ lệ đọc lại | | /distill last | Đường dẫn log đầy đủ của lần gần nhất |

Muốn xem output gốc của một lệnh: thêm NO_DISTILL=1 vào lệnh. Lệnh đọc file trong .claude/distill/ không bị chưng cất.

Dữ liệu

~/.local/share/limit-line/:

ledger/<ngày>.json        mỗi request trực tiếp (token, model, project; không có nội dung)
measure/<tháng>.json      các lần đọc hạn mức (thưa)
compact/<tháng>.json      các lần compact
distill/<tháng>.json      các lần chưng cất (kích thước, đường dẫn log)
index/state.json          vị trí đã đọc của từng file JSONL
index/days/<ngày>.json    tổng hợp theo ngày (giờ Asia/Bangkok)

Xóa dữ liệu: rm -rf ~/.local/share/limit-line (indexer sẽ đọc lại từ đầu lần sau), và rm -rf <project>/.claude/distill. Đọc lại lịch sử từ đầu: node scripts/indexer.mjs --rebuild.

Giới hạn đã biết

Chi phí là API-equiv theo bảng giá trong hooks/pricing.ts (cập nhật 2026-09-25, cần xác nhận); với gói subscription đây không phải số tiền phải trả.
Usage trực tiếp không tách cache write 5m/1h: band và ledger tính như 1h; indexer dùng số tách trong JSONL.
Lời gọi advisor nằm trong usage.iterations của JSONL: indexer có tính, band và ledger trực tiếp thì không.
Dấu compact và subagent trong JSONL chưa được xác minh trên dữ liệu thật (chưa có phiên nào như vậy).
Ước tính "ngoài máy này" chỉ hiện khi có ít nhất 2 cửa sổ 5h đầy đủ trong ledger.
Distiller mới có bộ lọc pytest và chung; cuda, docker, train để sau.
Cần node ≥ 23.6 trong PATH của Claude Code (indexer và wrapper của distiller chạy file .ts trực tiếp).

Phát triển

claude plugin validate --strict .     # manifest + module
claude plugin test .                  # test của engine
node --test tests/indexer.node.mjs    # test của indexer
npx -p typescript@5 tsc -p .          # kiểu (sau khi Claude Code đã sinh .claude-plugin/types)
node scripts/build-fixtures.mjs       # sau khi thêm log vào tests/fixtures/<loại>/

作品情報

作者: Haworthiasa
用途: ダッシュボード・HUD
掲載日: 2026年10月5日
ソース更新日: 2026年10月2日
スター数: 0
権限の足跡: L2
回閲覧: 0

bash-distillerclaude-codecontext-monitorcost-trackinghookspluginpytestusage-dashboard

この作品を報告あなたの作品ですか？所有者確認へ

スポンサー

掲載は週 $10 から

権限の足跡 L2

権限の足跡

自動スキャンの結果です。インストール前にソースを確認してください。レベルは機能を示すもので、安全認証ではありません。

環境変数
ファイル読み取り
ファイル書き込み
コマンド実行
ツール呼び出しの介入

検出箇所を見る（23）

環境変数・行54 行limit-line/hooks/register.tsxconst home = await $.env.get('HOME')

ファイル読み取り・行63 行limit-line/hooks/register.tsxlist = JSON.parse(await $.fs.read(path)) as T[]

ファイル書き込み・行67 行limit-line/hooks/register.tsxawait $.fs.write(path, JSON.stringify([...list, ...items]))

ファイル読み取り・行72 行limit-line/hooks/register.tsxreturn JSON.parse(await $.fs.read(path)) as T

環境変数・行80 行limit-line/hooks/register.tsxconst home = await $.env.get('HOME')

コマンド実行・行87 行limit-line/hooks/register.tsx

const run = await $.process.run(['node', `${$.plugin.root}/scripts/indexer.mjs`, '--data', data], { timeoutMs: 120_000 })

コマンド実行・行63 行limit-line/hooks/band.tsreturn /opus|sonnet|haiku|fable|mythos/.exec(model)?.[0] ?? model

環境変数・行22 行limit-line/hooks/distiller.tsconst h = await $.env.get('HOME')

ファイル読み取り・行33 行limit-line/hooks/distiller.tsreturn JSON.parse(await $.fs.read(path)) as T

ファイル書き込み・行43 行limit-line/hooks/distiller.tsawait $.fs.write(path, JSON.stringify([...list, ...items]))

ファイル読み取り・行58 行limit-line/hooks/distiller.tstext = await $.fs.read(path)

ファイル書き込み・行63 行limit-line/hooks/distiller.tsawait $.fs.write(path, `${text}${text === '' || text.endsWith('\n') ? '' : '\n'}${IGNORE_LINE}\n`)

ファイル書き込み・行85 行limit-line/hooks/distiller.tsawait $.fs.write(file, JSON.stringify(list.map(x => (x.logPath === ev.logPath ? { ...x, reread: true } : x))))

ファイル読み取り・行92 行limit-line/hooks/distiller.ts? await $.fs.read(out.persistedOutputPath)

ファイル書き込み・行102 行limit-line/hooks/distiller.tsawait $.fs.write(logPath, raw)

ファイル書き込み・行105 行limit-line/hooks/distiller.tsawait $.fs.write(`${base}.part${i + 1}.log`, raw.slice(i * PART_CHARS, (i + 1) * PART_CHARS))

ツール呼び出しの介入・行118 行limit-line/hooks/distiller.tson('tool.call', { tool: 'Read' }, async ($, e, next) => {

ツール呼び出しの介入・行127 行limit-line/hooks/distiller.tson('tool.call', { tool: 'Bash' }, async ($, e, next) => {

ファイル書き込み・行148 行limit-line/hooks/distiller.tsawait $.fs.write(log, '')

コマンド実行・行155 行limit-line/hooks/distiller.tsconst m = ran.deny === undefined && ran.text !== undefined ? ANNOTATION.exec(ran.text) : null

コマンド実行・行42 行limit-line/hooks/distill/pytest.tsconst s = SECTION.exec(line)

コマンド実行・行49 行limit-line/hooks/distill/pytest.tsconst b = BLOCK.exec(line)

コマンド実行・行60 行limit-line/hooks/distill/pytest.ts.map(l => ENTRY.exec(l))

limit-line

この mod について

インストール

limit-line

Tính năng

Lệnh

Dữ liệu

Giới hạn đã biết

Phát triển

関連作品

ruflo-docs

token-optimizer

databricks-cli