Skip to content

limitchecker 0.1.0

Choose a tag to compare

View all tags
@mirute02 mirute02 released this 20 Sep 09:53
· 21 commits to main since this release
v0.1.0
591aed6

Claude Code の残量を Android のホーム画面と通知領域で把握するための最初のリリースです。

できること

  • 二重ドーナツのウィジェット。外側が5時間枠、中央が週次枠、中心にリセットまでの時間
  • 通知センターへの常設。ステータスバーには残量の形か数字を出せる
  • ウィジェットは 1×1 まで縮小可能。幅に応じて表示する要素が減る
  • 配色3種、ステータスバー表示4種、背景3種（不透明・半透明・透過）から選択

特徴: 認証情報を持ちません

このアプリは Claude のアカウントにログインしません。API キーも要求しません。
残量は、すでにログイン済みの Claude Code が statusLine に渡す値を使います。

アプリが保持する秘密は、自分で立てた hub のトークン1つだけです。
そのトークンも Android Keystore の鍵で暗号化して保存します。

要求する権限は INTERNET / ACCESS_NETWORK_STATE / POST_NOTIFICATIONS の3つ
（後者2つは WorkManager が追加する3つを除く）。位置情報、ストレージ、連絡先、
アクセシビリティ、電池最適化の除外は要求しません。

使うには hub が必要です

このアプリ単体では動きません。作業マシン（Mac / Linux）で hub を動かす必要があります。

git clone https://github.com/mirute02/limitchecker.git
cd limitchecker
./deploy/install-hub.sh

詳しい手順はアプリ内の「hub の準備手順を表示」か、README を参照してください。

制約

  • 残量は Claude Code が動いているときにしか更新されません。 10分を超えると薄く、
    1時間を超えるとグレーになって「未更新」と表示します。仕様です
  • モデル別の週次枠は取得できません。 statusLine が返すのは5時間枠と週次枠のみです
  • Codex は未対応です。 Codex CLI には、認証情報を読まずに残量を取る経路が
    現時点で存在しないことを実機で確認したため、方針を曲げずに保留としています

インストール

limitchecker-0.1.0.apk をダウンロードして開いてください。提供元不明のアプリの
許可が必要です。SHA-256 は limitchecker-0.1.0.apk.sha256 にあります。

自分でビルドすることもできます（README 参照）。その場合は署名が異なるため、
このリリース版とは共存できません。

Assets 4
Loading