tallyline 0.1.0__tar.gz

tallyline-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: pip install -e . pytest
+      - run: pytest -q

tallyline-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Release
+
+# Publishes to PyPI via trusted publishing (no API token stored in the repo).
+# - Pushing a tag like v0.2.0 releases that version. The first release is always made
+#   this way.
+# - A merge to main that changes prices.json releases the next patch version, but only
+#   once a first release exists; before that it does nothing.
+on:
+  push:
+    tags: ["v*"]
+    branches: [main]
+    paths: ["src/tallyline/prices.json"]
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Tag next patch version
+        id: version
+        if: github.ref_type == 'branch'
+        run: |
+          last=$(git describe --tags --abbrev=0 --match 'v*' 2>/dev/null || true)
+          if [ -z "$last" ]; then
+            echo "No release yet; push a tag like v0.1.0 to make the first one."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          IFS=. read -r major minor patch <<< "${last#v}"
+          next="v${major}.${minor}.$((patch + 1))"
+          git tag "$next"
+          git push origin "$next"
+      - uses: actions/setup-python@v5
+        if: steps.version.outputs.skip != 'true'
+        with:
+          python-version: "3.13"
+      - if: steps.version.outputs.skip != 'true'
+        run: pip install build pytest && pip install -e . && pytest -q
+      - if: steps.version.outputs.skip != 'true'
+        run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        if: steps.version.outputs.skip != 'true'

tallyline-0.1.0/.github/workflows/update-prices.yml

@@ -0,0 +1,37 @@
+name: Update prices
+
+# Checks Anthropic's pricing page daily and opens a pull request when the bundled
+# price table changes. Merging that PR triggers an automatic patch release.
+on:
+  schedule:
+    - cron: "17 3 * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python scripts/update_prices.py
+      # PRs opened with GITHUB_TOKEN don't trigger other workflows, so test here.
+      - run: pip install -e . pytest && pytest -q
+      - uses: peter-evans/create-pull-request@v7
+        with:
+          branch: update-prices
+          commit-message: Update model prices from Anthropic pricing page
+          title: Update model prices
+          body: |
+            Automated update of `src/tallyline/prices.json` from
+            https://platform.claude.com/docs/en/about-claude/pricing
+
+            Review the diff against the pricing page. Merging releases a new patch version.
+          add-paths: src/tallyline/prices.json

tallyline-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+build/
+*.egg-info/
+src/tallyline/_version.py
+.pytest_cache/

tallyline-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nhinata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tallyline-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.5
+Name: tallyline
+Version: 0.1.0
+Summary: Claude Code status line that tallies your token usage and API-equivalent cost by day, month and year
+Project-URL: Repository, https://github.com/nhinata/tallyline
+Author: nhinata
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude-code,cost,statusline,tokens,usage
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# tallyline
+
+A Claude Code status line that **tallies your token usage and API-equivalent cost by day, month and year**, across every session.
+
+![tallyline status line on a Max plan](https://raw.githubusercontent.com/nhinata/tallyline/main/assets/screenshot.png)
+
+```
+Pro/Max plan:  [Opus 5.5] │ ctx 12% │ Oct 22.1M tok (≈$14.92) │ 5h 23%  7d 41%
+API billing:   [Opus 5.5] │ ctx 12%  6.6M tok (≈$3.85) │ Oct 22.1M tok (≈$14.92)
+```
+
+Segments widen in scope from left to right: this session (cyan), all sessions on this machine (yellow), your whole account (magenta).
+
+[日本語版 README](README.ja.md)
+
+## Why
+
+Claude Code's status line only knows about the current session. tallyline keeps a running ledger of every session on your machine, so you can answer "how much have I used this month?" at a glance. On a Pro/Max plan, the API-equivalent cost tells you what your usage would have cost on the pay-as-you-go API.
+
+- **Fast**: after the first scan it parses only newly appended transcript bytes. A render takes about 25 ms.
+- **Local only**: apart from a once-a-day update check that asks PyPI for the latest version number, tallyline makes no network requests. It never sends your conversations or usage data anywhere. Turn the check off with `tallyline config update-check off` or `NO_UPDATE_NOTIFIER=1`.
+- **No dependencies**: it uses only the Python standard library (Python 3.9+).
+- **Accurate**: it removes duplicate transcript lines written while a response streams. Without that, a naive sum roughly doubles your usage.
+
+## Install
+
+```bash
+pipx install tallyline      # or: uv tool install tallyline
+tallyline init              # adds the statusLine entry to ~/.claude/settings.json
+```
+
+Restart Claude Code. `init` backs up `settings.json` to `settings.json.bak`. It refuses to replace an existing status line unless you pass `--force`.
+
+## What it shows
+
+| Segment | Scope | Meaning |
+|---|---|---|
+| `[Opus 5.5]` | — | Current model |
+| `ctx 12%` | this session | How full the context window is right now. It drops after `/clear` or `/compact` |
+| `5h 23%  7d 41%` | your account | Pro/Max only: usage of your 5-hour and 7-day rate limits, counted across all devices and apps. A window that has reset shows `0%` |
+| `6.6M tok (≈$3.85)` | this session | API billing only: tokens used so far in this session, subagents included |
+| `Oct 22.1M tok (≈$14.92)` | all sessions on this machine | Total for the period (`today`, the month, or the year) |
+
+A `*` after the period, as in `2026*`, means tallyline's records start partway through that period, so the total is incomplete. This is normal right after installing: Claude Code keeps only recent transcripts (see Caveats).
+
+tallyline picks between rate limits and session usage automatically. Claude Code sends rate limits only to Pro/Max subscribers, and for them the per-session cost has little meaning.
+
+Claude Code sends rate limits only after a session's first response, so tallyline remembers the latest values seen in any session. A new session shows them right away, and every session shows the newest value seen on this machine. Usage on claude.ai or other devices appears after your next response, so treat the figures as "at least".
+
+Every turn re-reads the whole context, so cumulative tokens grow much faster than `ctx`. Most of them are cache reads.
+
+Token totals include input, output, cache writes and cache reads. Cache reads are cheap, so the `≈$` cost is the better gauge of how heavily you are using Claude. The cost is an API-equivalent estimate at list prices.
+
+## Configuration
+
+```bash
+tallyline config range month   # today | month | year | all
+tallyline config cost off      # hide cost figures
+tallyline config color off     # plain text (NO_COLOR is honored too)
+tallyline config update-check off  # no daily version check (or set NO_UPDATE_NOTIFIER=1)
+tallyline config               # show current settings
+```
+
+Settings live in `~/.config/tallyline/config.json`. The cache lives in `~/.cache/tallyline/usage.db`. `tallyline rebuild` re-scans every transcript. It keeps the history of transcripts that Claude Code has already deleted.
+
+### Prices
+
+Prices come from a table bundled with each release, generated from [Anthropic's pricing page](https://platform.claude.com/docs/en/about-claude/pricing). A scheduled GitHub Actions job checks that page daily and opens a pull request when prices change. Costs are computed when the status line renders, so a price update also applies to past usage.
+
+If a model is missing from the table, its cost shows as `+?`. To fill in a price without waiting for a release, add it to `config.json`. Prices are USD per million tokens:
+
+```json
+{
+  "prices": {
+    "claude-new-model": {
+      "input": 3, "cache_write_5m": 3.75, "cache_write_1h": 6,
+      "cache_read": 0.3, "output": 15
+    }
+  }
+}
+```
+
+Fast mode requests are multiplied by each model's `fast_multiplier`.
+
+## Caveats
+
+- The cost is an estimate at list prices, not a bill. On Pro/Max plans you pay your plan price.
+- tallyline only sees what Claude Code writes to transcripts. Some background requests are never recorded there, so totals can come out lower than `/cost`. In one auto mode session, tallyline counted about 15% less than `/cost` (likely the permission checks auto mode runs). Tokens and cost come from the same transcripts, so the two always match each other.
+- Claude Code deletes old transcripts after `cleanupPeriodDays` (30 by default). tallyline keeps whatever it has already ingested, but it can't count transcripts that were deleted before you installed it.
+- Transcript files are an internal Claude Code format and may change.
+- If you switch between several Claude accounts on one machine, their rate limit records can mix.
+- Not affiliated with or endorsed by Anthropic.
+
+## Updating
+
+When a newer release is out, the status line ends with `↑ 0.2.0`. Run:
+
+```bash
+pipx upgrade tallyline      # or: uv tool upgrade tallyline
+```
+
+New releases also carry the latest model prices.
+
+## Uninstall
+
+```bash
+tallyline uninstall && pipx uninstall tallyline
+```
+
+## License
+
+MIT

tallyline-0.1.0/README.ja.md

@@ -0,0 +1,110 @@
+# tallyline
+
+Claude Code の**全セッションのトークン使用量と API 換算の金額を、日・月・年ごとに集計して表示する**ステータスラインです。
+
+![Max プランでの tallyline の表示](https://raw.githubusercontent.com/nhinata/tallyline/main/assets/screenshot.png)
+
+```
+Pro / Max プラン：  [Opus 5.5] │ ctx 12% │ Oct 22.1M tok (≈$14.92) │ 5h 23%  7d 41%
+API 従量課金：      [Opus 5.5] │ ctx 12%  6.6M tok (≈$3.85) │ Oct 22.1M tok (≈$14.92)
+```
+
+左から右へ、範囲が広がる順に並んでいます。このセッション（水色）、このマシンの全セッション（黄色）、アカウント全体（紫）です。
+
+## 特徴
+
+Claude Code 標準のステータスラインに渡されるのは、今のセッションの情報だけです。tallyline はこのマシンの全セッションを記録し続けるので、「今月どれだけ使ったか」をひと目で確認できます。Pro / Max プランの人は、API 換算の金額を見れば、従量課金の API だったらいくらかかっていたかが分かります。
+
+- **速い**：最初の1回以降は、ログに新しく追記された分だけを読みます。表示にかかる時間は約 25ms です。
+- **ローカルで完結**：1日1回の更新確認（PyPI に最新版の番号を問い合わせるだけ）を除いて、外部とは一切通信しません。会話の内容や使用量などのデータを送ることはありません。更新確認は `tallyline config update-check off` か、環境変数 `NO_UPDATE_NOTIFIER=1` で止められます。
+- **依存なし**：Python 3.9 以上の標準機能だけで動きます。
+- **正確**：応答の途中経過として重複して記録された行を除外します。単純に合計すると、使用量が約2倍に膨らみます。
+
+## インストール
+
+```bash
+pipx install tallyline      # または: uv tool install tallyline
+tallyline init              # ~/.claude/settings.json に statusLine を追加
+```
+
+追加したら Claude Code を再起動してください。`init` は実行前に `settings.json.bak` としてバックアップを作ります。すでに別のステータスラインが設定されている場合は置き換えません。置き換えたいときは `--force` を付けてください。
+
+## 表示内容
+
+| 表示 | 範囲 | 意味 |
+|---|---|---|
+| `[Opus 5.5]` | — | 使用中のモデル |
+| `ctx 12%` | このセッション | 今この瞬間のコンテキスト（会話）の埋まり具合。`/clear` や `/compact` で下がる |
+| `5h 23%  7d 41%` | アカウント全体 | Pro / Max プランのみ：5時間・7日間の利用上限に対する使用率（すべての端末・アプリでの利用を含む）。リセットされた枠は `0%` と表示 |
+| `6.6M tok (≈$3.85)` | このセッション | API 従量課金のみ：このセッションで使った累計トークン数（サブエージェント分を含む） |
+| `Oct 22.1M tok (≈$14.92)` | このマシンの全セッション | 期間（`today`・当月・当年）内の合計 |
+
+`2026*` のように期間の後ろに `*` が付いている場合は、記録がその期間の途中からしかなく、合計が不完全であることを表します。インストール直後はこの状態になるのが普通です。Claude Code は最近のログしか残していないためです（「注意事項」を参照）。
+
+利用上限とセッションの使用量のどちらを出すかは、自動で切り替わります。Claude Code は利用上限の情報を Pro / Max の利用者にだけ渡します。また、定額プランではセッション単位の金額にあまり意味がありません。
+
+Claude Code が利用上限の情報を渡すのは、各セッションで最初の応答を受け取った後です。そのため tallyline は、どのセッションで受け取った値も、最新のものを記録しておきます。これにより、新しいセッションでもすぐに利用上限が表示され、どのセッションでもこのマシンで受け取った最新の値が表示されます。claude.ai や他の端末での利用は次の応答で反映されるので、表示は「少なくともこの値」と考えてください。
+
+Claude は返答のたびにコンテキスト全体を読み直すため、累計トークン数は `ctx` よりずっと速く増えます。その大部分はキャッシュ読み込みです。
+
+トークン数は、入力・出力・キャッシュ作成・キャッシュ読み込みの合計です。キャッシュ読み込みは単価が安いため、どれだけ使い込んでいるかは `≈$` の金額の方が実態に近く表れます。この金額は、定価で計算した API 換算の推定値です。
+
+## 設定
+
+```bash
+tallyline config range month   # today / month / year / all
+tallyline config cost off      # 金額を非表示にする
+tallyline config color off     # 色なしで表示（環境変数 NO_COLOR にも対応）
+tallyline config update-check off  # 1日1回の更新確認を止める（環境変数 NO_UPDATE_NOTIFIER=1 でも可）
+tallyline config               # 現在の設定を表示
+```
+
+設定は `~/.config/tallyline/config.json` に、集計の記録は `~/.cache/tallyline/usage.db` に保存されます。`tallyline rebuild` を実行すると、全ログを読み直します。Claude Code がすでに削除したログの分の記録は、消えずに残ります。
+
+### 単価
+
+単価は、[Anthropic の公式料金ページ](https://platform.claude.com/docs/en/about-claude/pricing)から生成した単価表を、各リリースに同梱しています。GitHub Actions が毎日このページを確認し、料金が変わっていればプルリクエストを自動で作ります。金額は表示のたびに計算するので、単価表が更新されると過去の使用分にも新しい単価が反映されます。
+
+単価表にないモデルの金額は `+?` と表示されます。リリースを待たずに単価を追加したい場合は、`config.json` に書き足してください（単位は 100万トークンあたりの米ドル）。
+
+```json
+{
+  "prices": {
+    "claude-new-model": {
+      "input": 3, "cache_write_5m": 3.75, "cache_write_1h": 6,
+      "cache_read": 0.3, "output": 15
+    }
+  }
+}
+```
+
+Fast モードで処理されたリクエストは、モデルごとの `fast_multiplier` を掛けて計算します。
+
+## 注意事項
+
+- 表示される金額は定価での推定で、実際の請求額ではありません。Pro / Max プランで実際に支払うのはプランの料金です。
+- tallyline が数えられるのは、Claude Code がログに書き出した分だけです。裏側で行われるやり取りの一部はログに記録されないため、合計が `/cost` より少なく出ることがあります。自動モードのセッションで比べたところ、`/cost` より約15%少なくなりました（自動モードの許可判定が原因とみられます）。トークン数と金額は同じログから計算しているので、この2つは常に食い違いません。
+- Claude Code は古いログを `cleanupPeriodDays`（初期設定は30日）で削除します。tallyline は一度取り込んだ分を保持し続けますが、インストール前に削除されたログの分は集計できません。
+- ログファイルは Claude Code の内部形式なので、将来変わる可能性があります。
+- 1台のマシンで複数の Claude アカウントを切り替えて使うと、アカウント間で利用上限の記録が混ざることがあります。
+- Anthropic の公式ツールではありません。
+
+## 更新
+
+新しい版が出ると、ステータスラインの末尾に `↑ 0.2.0` のように表示されます。次のコマンドで更新してください。
+
+```bash
+pipx upgrade tallyline      # または: uv tool upgrade tallyline
+```
+
+新しい版には、最新のモデル単価も含まれています。
+
+## アンインストール
+
+```bash
+tallyline uninstall && pipx uninstall tallyline
+```
+
+## ライセンス
+
+MIT

tallyline-0.1.0/README.md

@@ -0,0 +1,112 @@
+# tallyline
+
+A Claude Code status line that **tallies your token usage and API-equivalent cost by day, month and year**, across every session.
+
+![tallyline status line on a Max plan](https://raw.githubusercontent.com/nhinata/tallyline/main/assets/screenshot.png)
+
+```
+Pro/Max plan:  [Opus 5.5] │ ctx 12% │ Oct 22.1M tok (≈$14.92) │ 5h 23%  7d 41%
+API billing:   [Opus 5.5] │ ctx 12%  6.6M tok (≈$3.85) │ Oct 22.1M tok (≈$14.92)
+```
+
+Segments widen in scope from left to right: this session (cyan), all sessions on this machine (yellow), your whole account (magenta).
+
+[日本語版 README](README.ja.md)
+
+## Why
+
+Claude Code's status line only knows about the current session. tallyline keeps a running ledger of every session on your machine, so you can answer "how much have I used this month?" at a glance. On a Pro/Max plan, the API-equivalent cost tells you what your usage would have cost on the pay-as-you-go API.
+
+- **Fast**: after the first scan it parses only newly appended transcript bytes. A render takes about 25 ms.
+- **Local only**: apart from a once-a-day update check that asks PyPI for the latest version number, tallyline makes no network requests. It never sends your conversations or usage data anywhere. Turn the check off with `tallyline config update-check off` or `NO_UPDATE_NOTIFIER=1`.
+- **No dependencies**: it uses only the Python standard library (Python 3.9+).
+- **Accurate**: it removes duplicate transcript lines written while a response streams. Without that, a naive sum roughly doubles your usage.
+
+## Install
+
+```bash
+pipx install tallyline      # or: uv tool install tallyline
+tallyline init              # adds the statusLine entry to ~/.claude/settings.json
+```
+
+Restart Claude Code. `init` backs up `settings.json` to `settings.json.bak`. It refuses to replace an existing status line unless you pass `--force`.
+
+## What it shows
+
+| Segment | Scope | Meaning |
+|---|---|---|
+| `[Opus 5.5]` | — | Current model |
+| `ctx 12%` | this session | How full the context window is right now. It drops after `/clear` or `/compact` |
+| `5h 23%  7d 41%` | your account | Pro/Max only: usage of your 5-hour and 7-day rate limits, counted across all devices and apps. A window that has reset shows `0%` |
+| `6.6M tok (≈$3.85)` | this session | API billing only: tokens used so far in this session, subagents included |
+| `Oct 22.1M tok (≈$14.92)` | all sessions on this machine | Total for the period (`today`, the month, or the year) |
+
+A `*` after the period, as in `2026*`, means tallyline's records start partway through that period, so the total is incomplete. This is normal right after installing: Claude Code keeps only recent transcripts (see Caveats).
+
+tallyline picks between rate limits and session usage automatically. Claude Code sends rate limits only to Pro/Max subscribers, and for them the per-session cost has little meaning.
+
+Claude Code sends rate limits only after a session's first response, so tallyline remembers the latest values seen in any session. A new session shows them right away, and every session shows the newest value seen on this machine. Usage on claude.ai or other devices appears after your next response, so treat the figures as "at least".
+
+Every turn re-reads the whole context, so cumulative tokens grow much faster than `ctx`. Most of them are cache reads.
+
+Token totals include input, output, cache writes and cache reads. Cache reads are cheap, so the `≈$` cost is the better gauge of how heavily you are using Claude. The cost is an API-equivalent estimate at list prices.
+
+## Configuration
+
+```bash
+tallyline config range month   # today | month | year | all
+tallyline config cost off      # hide cost figures
+tallyline config color off     # plain text (NO_COLOR is honored too)
+tallyline config update-check off  # no daily version check (or set NO_UPDATE_NOTIFIER=1)
+tallyline config               # show current settings
+```
+
+Settings live in `~/.config/tallyline/config.json`. The cache lives in `~/.cache/tallyline/usage.db`. `tallyline rebuild` re-scans every transcript. It keeps the history of transcripts that Claude Code has already deleted.
+
+### Prices
+
+Prices come from a table bundled with each release, generated from [Anthropic's pricing page](https://platform.claude.com/docs/en/about-claude/pricing). A scheduled GitHub Actions job checks that page daily and opens a pull request when prices change. Costs are computed when the status line renders, so a price update also applies to past usage.
+
+If a model is missing from the table, its cost shows as `+?`. To fill in a price without waiting for a release, add it to `config.json`. Prices are USD per million tokens:
+
+```json
+{
+  "prices": {
+    "claude-new-model": {
+      "input": 3, "cache_write_5m": 3.75, "cache_write_1h": 6,
+      "cache_read": 0.3, "output": 15
+    }
+  }
+}
+```
+
+Fast mode requests are multiplied by each model's `fast_multiplier`.
+
+## Caveats
+
+- The cost is an estimate at list prices, not a bill. On Pro/Max plans you pay your plan price.
+- tallyline only sees what Claude Code writes to transcripts. Some background requests are never recorded there, so totals can come out lower than `/cost`. In one auto mode session, tallyline counted about 15% less than `/cost` (likely the permission checks auto mode runs). Tokens and cost come from the same transcripts, so the two always match each other.
+- Claude Code deletes old transcripts after `cleanupPeriodDays` (30 by default). tallyline keeps whatever it has already ingested, but it can't count transcripts that were deleted before you installed it.
+- Transcript files are an internal Claude Code format and may change.
+- If you switch between several Claude accounts on one machine, their rate limit records can mix.
+- Not affiliated with or endorsed by Anthropic.
+
+## Updating
+
+When a newer release is out, the status line ends with `↑ 0.2.0`. Run:
+
+```bash
+pipx upgrade tallyline      # or: uv tool upgrade tallyline
+```
+
+New releases also carry the latest model prices.
+
+## Uninstall
+
+```bash
+tallyline uninstall && pipx uninstall tallyline
+```
+
+## License
+
+MIT

tallyline-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tallyline"
+dynamic = ["version"]
+description = "Claude Code status line that tallies your token usage and API-equivalent cost by day, month and year"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "nhinata" }]
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+dependencies = []
+keywords = ["claude-code", "statusline", "tokens", "usage", "cost"]
+classifiers = [
+  "Environment :: Console",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Topic :: Utilities",
+]
+
+[project.urls]
+Repository = "https://github.com/nhinata/tallyline"
+
+[project.scripts]
+tallyline = "tallyline.cli:main"
+
+[tool.hatch.version]
+source = "vcs"
+fallback-version = "0.0.0"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/tallyline/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tallyline"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

tallyline-0.1.0/scripts/update_prices.py

@@ -0,0 +1,30 @@
+"""Regenerate src/tallyline/prices.json from Anthropic's official pricing page.
+
+Run by the update-prices GitHub Actions workflow; exits non-zero if parsing fails
+so a broken page layout never ships an empty table.
+"""
+import json
+import sys
+import urllib.request
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
+from tallyline.pricing import parse_pricing_page  # noqa: E402
+
+SOURCE = "https://platform.claude.com/docs/en/about-claude/pricing.md"
+OUT = Path(__file__).resolve().parents[1] / "src" / "tallyline" / "prices.json"
+
+
+def main():
+    req = urllib.request.Request(SOURCE, headers={"User-Agent": "tallyline-price-updater"})
+    with urllib.request.urlopen(req, timeout=30) as r:
+        markdown = r.read().decode("utf-8")
+    models = parse_pricing_page(markdown)
+    data = {"source": SOURCE, "unit": "USD per million tokens",
+            "models": dict(sorted(models.items()))}
+    OUT.write_text(json.dumps(data, indent=2) + "\n", encoding="utf-8")
+    print(f"wrote {len(models)} models to {OUT}")
+
+
+if __name__ == "__main__":
+    main()

tallyline-0.1.0/src/tallyline/__init__.py

@@ -0,0 +1,4 @@
+try:
+    from ._version import __version__
+except ImportError:  # running from a source checkout without an install
+    __version__ = "0.0.0.dev0"

tallyline-0.1.0/src/tallyline/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

tallyline-0.1.0/src/tallyline/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = None