toknt 0.1.0__tar.gz

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

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-14, macos-15, ubuntu-latest]
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install
+        run: uv sync --frozen
+      - name: Tests
+        run: uv run pytest
+      - name: Lint
+        run: uv run ruff check .
+      - name: The package builds and installs
+        run: |
+          uv build --out-dir dist
+          uv tool install --force dist/*.whl
+          toknt --version
+          toknt --help > /dev/null

toknt-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/toknt
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Build
+        run: uv build --out-dir dist
+      - name: Check the distributions
+        run: uvx twine check dist/*
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true

toknt-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+dist/
+build/
+*.egg-info/
+.DS_Store

toknt-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

toknt-0.1.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to `toknt` are recorded here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
+[semantic versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-10-23
+
+The first public release: local-first token, cost and tool analytics for AI
+coding harnesses.
+
+### Added
+
+- **Interactive TUI** — contribution graph of tokens per day, per-model
+  series with a token-share donut, cache-hit-rate bars that mirror the model
+  table, tool outcomes, session rankings, and live 3h/5h/1d windows that
+  rescan in the background.
+- **Logarithmic token charts** — token counts plot on a log axis, so a
+  5M-token model stays visible next to a 250M one. tok/s stays linear.
+- **True image charts** — anti-aliased PNG output over the kitty, iTerm2 and
+  sixel protocols, with a Braille-cell fallback everywhere else.
+- **21 harness sources** — OpenCode, Codex CLI, Claude Code, Cline, pi, Grok
+  Build, Gemini CLI and more, normalized into a canonical model.
+- **Strict token semantics** — incomplete counts are never completed by
+  guessing, and reported costs stay separate from estimated ones.
+- **Commands** — `overview`, `scan`, `usage`, `models`, `tools`, `sessions`,
+  `export`, `doctor`, `graphics`.
+- **Derived tok/s** — mean generation rate per model, derived from message
+  gaps with the sources' own reporting schemes.
+- `toknt doctor` for source discovery, coverage and data-quality issues.
+
+[0.1.0]: https://github.com/BitPeppr/toknt/releases/tag/v0.1.0

toknt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martin Chen
+
+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.