code-meter 0.1.0__tar.gz

code_meter-0.1.0/LICENSE

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

code_meter-0.1.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: code-meter
+Version: 0.1.0
+Summary: Local AI coding token usage tracker and cost estimator for Claude Code and future agents.
+Author-email: Dhanush Nayak <dhanushnayak.ram@mail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/dhanushnayak/code-meter
+Project-URL: Repository, https://github.com/dhanushnayak/code-meter
+Project-URL: Bug Tracker, https://github.com/dhanushnayak/code-meter/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: watchdog>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# code-meter
+
+> **Local AI Coding Token Usage Tracker, Prompt Log & Cost Estimator**
+
+`code-meter` (also available via `claude-meter`, `codex-meter`, `antigravity-meter`, and `agy-meter` aliases) is a production-quality local CLI application designed to track local usage for **Claude Code**, **OpenAI Codex**, and **Google Antigravity**, including tokens (input, output, cache-read, cache-write), session prompts, and code change history over time.
+
+It features an extensible multi-provider architecture so all AI coding agents operate seamlessly within unified analytics and SQLite storage.
+
+---
+
+## 🔒 Privacy First
+
+* **100% Local**: Operates completely offline using your local filesystem.
+* **No Gateway / Telemetry**: `code-meter` is NOT an API gateway, proxy, or interceptor.
+* **Zero Uploads**: No prompts, assistant responses, source code files, or conversation texts are uploaded anywhere. Only local token metrics, session prompts, and diff logs are saved to SQLite.
+* **No API Key Required**: Analyzes existing local session logs generated by Claude Code (`~/.claude`), OpenAI Codex (`~/.codex`), and Google Antigravity (`~/.gemini/antigravity-ide`).
+
+---
+
+## 📦 Installation
+
+### From PyPI (Standard Installation)
+
+```bash
+pip install code-meter
+```
+
+### Local / Development (Editable Mode)
+
+```bash
+git clone https://github.com/dhanushnayak/code-meter.git
+cd code-meter
+pip install -e .
+```
+
+---
+
+## 🚀 Basic Usage
+
+Simply run:
+
+```bash
+code-meter
+```
+
+Or use one of the provider aliases (`claude-meter`, `codex-meter`, `antigravity-meter`, `agy-meter`).
+
+This launches the interactive Rich terminal dashboard displaying key metrics, model breakdowns, project breakdowns, today's usage, and token burn rates.
+
+---
+
+## 🛠️ CLI Commands
+
+| Command | Description |
+| :--- | :--- |
+| `code-meter` | Open interactive Rich terminal dashboard |
+| `code-meter scan` | Force an incremental scan of local usage directories |
+| `code-meter today` | Summary of token usage and cost for today |
+| `code-meter week` | Summary of token usage and cost for the past 7 days |
+| `code-meter month` | Summary of token usage and cost for the past 30 days |
+| `code-meter status` | View system status (scanned files, records, prompts, code edits, DB size) |
+| `code-meter prompts` | View log of user prompts asked per session over time |
+| `code-meter history` | View log of code edits, file writes, and snapshots recorded per session |
+| `code-meter diffs` | View formatted code diff summaries saved in SQLite |
+| `code-meter report` | Detailed aggregated report with optional filters |
+| `code-meter models` | Usage and cost breakdown by model |
+| `code-meter projects` | Usage and cost breakdown by working project directory |
+| `code-meter sessions` | Usage and cost breakdown by session ID |
+| `code-meter export` | Export usage records to CSV or JSON format |
+| `code-meter config` | Display active configuration settings and file paths |
+| `code-meter watch` | Live file watcher mode for real-time dashboard updates |
+
+---
+
+## 🔍 Filters & Examples
+
+Combine filters on reporting, prompts, and history commands:
+
+```bash
+# Filter report by provider, project, model, and timeframe
+code-meter report --provider codex --model gpt-4o --days 30
+code-meter report --provider antigravity --model gemini-2.5-flash
+
+# View prompts for a specific session or project
+code-meter prompts --project rag-agent --limit 20
+
+# View code changes and diffs for a file or session
+code-meter history --file src/main.py
+code-meter diffs --session abc12345
+
+# Export usage stats to CSV or JSON
+code-meter export --format csv --days 7 --output usage_report.csv
+```
+
+---
+
+## ⚙️ Configuration
+
+Configuration is stored in `~/.config/code-meter/config.toml` (or Windows `%APPDATA%/code-meter/config.toml`).
+
+```toml
+[general]
+database = "~/.local/share/code-meter/usage.db"
+
+[claude_code]
+directory = "~/.claude"
+
+[codex]
+directory = "~/.codex"
+
+[antigravity]
+directory = "~/.gemini/antigravity-ide"
+
+[ui]
+refresh_seconds = 2
+
+[pricing]
+currency = "USD"
+```
+
+Environment variables take precedence:
+* `CODE_METER_DB`
+* `CODE_METER_CLAUDE_DIR`
+* `CODE_METER_CODEX_DIR`
+* `CODE_METER_ANTIGRAVITY_DIR`
+* `CODE_METER_REFRESH`
+
+---
+
+## 🧩 Architecture
+
+```text
+Claude Code (~/.claude)  Codex (~/.codex)  Antigravity (~/.gemini/antigravity-ide)
+         │                       │                       │
+         ▼                       ▼                       ▼
+ClaudeCodeProvider        CodexProvider          AntigravityProvider
+         │                       │                       │
+         └───────────────────────┼───────────────────────┘
+                                 ▼
+         UsageRecord / SessionPrompt / SessionCodeChange (Pydantic models)
+                                 │
+                                 ▼
+            Database Repository & Incremental Scanner (SQLite)
+                                 │
+                                 ▼
+              Pricing Engine (Multi-Provider Model Pricing Tables)
+                                 │
+                                 ▼
+             Analytics Engine (Token counts, Costs, Aggregations)
+                                 │
+                                 ▼
+             Terminal UI & Typer CLI Commands
+```
+            │
+            ▼
+UsageRecord / SessionPrompt / SessionCodeChange (Pydantic models)
+            │
+            ▼
+  Database Repository & Incremental Scanner (SQLite)
+            │
+            ▼
+    Pricing Engine (Model Pricing Tables)
+            │
+            ▼
+   Analytics Engine (Token counts, Costs, Aggregations)
+            │
+            ▼
+ Terminal UI & Typer CLI Commands
+```
+
+---
+
+## 🧪 Running Tests
+
+```bash
+pytest -v
+```
+
+---
+
+## 📜 License
+
+Distributed under the **MIT License**. See [LICENSE](LICENSE) for details.

code_meter-0.1.0/README.md

@@ -0,0 +1,183 @@
+# code-meter
+
+> **Local AI Coding Token Usage Tracker, Prompt Log & Cost Estimator**
+
+`code-meter` (also available via `claude-meter`, `codex-meter`, `antigravity-meter`, and `agy-meter` aliases) is a production-quality local CLI application designed to track local usage for **Claude Code**, **OpenAI Codex**, and **Google Antigravity**, including tokens (input, output, cache-read, cache-write), session prompts, and code change history over time.
+
+It features an extensible multi-provider architecture so all AI coding agents operate seamlessly within unified analytics and SQLite storage.
+
+---
+
+## 🔒 Privacy First
+
+* **100% Local**: Operates completely offline using your local filesystem.
+* **No Gateway / Telemetry**: `code-meter` is NOT an API gateway, proxy, or interceptor.
+* **Zero Uploads**: No prompts, assistant responses, source code files, or conversation texts are uploaded anywhere. Only local token metrics, session prompts, and diff logs are saved to SQLite.
+* **No API Key Required**: Analyzes existing local session logs generated by Claude Code (`~/.claude`), OpenAI Codex (`~/.codex`), and Google Antigravity (`~/.gemini/antigravity-ide`).
+
+---
+
+## 📦 Installation
+
+### From PyPI (Standard Installation)
+
+```bash
+pip install code-meter
+```
+
+### Local / Development (Editable Mode)
+
+```bash
+git clone https://github.com/dhanushnayak/code-meter.git
+cd code-meter
+pip install -e .
+```
+
+---
+
+## 🚀 Basic Usage
+
+Simply run:
+
+```bash
+code-meter
+```
+
+Or use one of the provider aliases (`claude-meter`, `codex-meter`, `antigravity-meter`, `agy-meter`).
+
+This launches the interactive Rich terminal dashboard displaying key metrics, model breakdowns, project breakdowns, today's usage, and token burn rates.
+
+---
+
+## 🛠️ CLI Commands
+
+| Command | Description |
+| :--- | :--- |
+| `code-meter` | Open interactive Rich terminal dashboard |
+| `code-meter scan` | Force an incremental scan of local usage directories |
+| `code-meter today` | Summary of token usage and cost for today |
+| `code-meter week` | Summary of token usage and cost for the past 7 days |
+| `code-meter month` | Summary of token usage and cost for the past 30 days |
+| `code-meter status` | View system status (scanned files, records, prompts, code edits, DB size) |
+| `code-meter prompts` | View log of user prompts asked per session over time |
+| `code-meter history` | View log of code edits, file writes, and snapshots recorded per session |
+| `code-meter diffs` | View formatted code diff summaries saved in SQLite |
+| `code-meter report` | Detailed aggregated report with optional filters |
+| `code-meter models` | Usage and cost breakdown by model |
+| `code-meter projects` | Usage and cost breakdown by working project directory |
+| `code-meter sessions` | Usage and cost breakdown by session ID |
+| `code-meter export` | Export usage records to CSV or JSON format |
+| `code-meter config` | Display active configuration settings and file paths |
+| `code-meter watch` | Live file watcher mode for real-time dashboard updates |
+
+---
+
+## 🔍 Filters & Examples
+
+Combine filters on reporting, prompts, and history commands:
+
+```bash
+# Filter report by provider, project, model, and timeframe
+code-meter report --provider codex --model gpt-4o --days 30
+code-meter report --provider antigravity --model gemini-2.5-flash
+
+# View prompts for a specific session or project
+code-meter prompts --project rag-agent --limit 20
+
+# View code changes and diffs for a file or session
+code-meter history --file src/main.py
+code-meter diffs --session abc12345
+
+# Export usage stats to CSV or JSON
+code-meter export --format csv --days 7 --output usage_report.csv
+```
+
+---
+
+## ⚙️ Configuration
+
+Configuration is stored in `~/.config/code-meter/config.toml` (or Windows `%APPDATA%/code-meter/config.toml`).
+
+```toml
+[general]
+database = "~/.local/share/code-meter/usage.db"
+
+[claude_code]
+directory = "~/.claude"
+
+[codex]
+directory = "~/.codex"
+
+[antigravity]
+directory = "~/.gemini/antigravity-ide"
+
+[ui]
+refresh_seconds = 2
+
+[pricing]
+currency = "USD"
+```
+
+Environment variables take precedence:
+* `CODE_METER_DB`
+* `CODE_METER_CLAUDE_DIR`
+* `CODE_METER_CODEX_DIR`
+* `CODE_METER_ANTIGRAVITY_DIR`
+* `CODE_METER_REFRESH`
+
+---
+
+## 🧩 Architecture
+
+```text
+Claude Code (~/.claude)  Codex (~/.codex)  Antigravity (~/.gemini/antigravity-ide)
+         │                       │                       │
+         ▼                       ▼                       ▼
+ClaudeCodeProvider        CodexProvider          AntigravityProvider
+         │                       │                       │
+         └───────────────────────┼───────────────────────┘
+                                 ▼
+         UsageRecord / SessionPrompt / SessionCodeChange (Pydantic models)
+                                 │
+                                 ▼
+            Database Repository & Incremental Scanner (SQLite)
+                                 │
+                                 ▼
+              Pricing Engine (Multi-Provider Model Pricing Tables)
+                                 │
+                                 ▼
+             Analytics Engine (Token counts, Costs, Aggregations)
+                                 │
+                                 ▼
+             Terminal UI & Typer CLI Commands
+```
+            │
+            ▼
+UsageRecord / SessionPrompt / SessionCodeChange (Pydantic models)
+            │
+            ▼
+  Database Repository & Incremental Scanner (SQLite)
+            │
+            ▼
+    Pricing Engine (Model Pricing Tables)
+            │
+            ▼
+   Analytics Engine (Token counts, Costs, Aggregations)
+            │
+            ▼
+ Terminal UI & Typer CLI Commands
+```
+
+---
+
+## 🧪 Running Tests
+
+```bash
+pytest -v
+```
+
+---
+
+## 📜 License
+
+Distributed under the **MIT License**. See [LICENSE](LICENSE) for details.

code_meter-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "code-meter"
+version = "0.1.0"
+description = "Local AI coding token usage tracker and cost estimator for Claude Code and future agents."
+readme = "README.md"
+authors = [{ name = "Dhanush Nayak", email = "dhanushnayak.ram@mail.com" }]
+license = { text = "MIT" }
+requires-python = ">=3.11"
+dependencies = [
+    "typer[all]>=0.9.0",
+    "rich>=13.0.0",
+    "pydantic>=2.0.0",
+    "tomli-w>=1.0.0",
+    "watchdog>=3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/dhanushnayak/code-meter"
+Repository = "https://github.com/dhanushnayak/code-meter"
+"Bug Tracker" = "https://github.com/dhanushnayak/code-meter/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "mypy>=1.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+code-meter = "code_meter.cli:app"
+claude-meter = "code_meter.cli:app"
+codex-meter = "code_meter.cli:app"
+antigravity-meter = "code_meter.cli:app"
+agy-meter = "code_meter.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

code_meter-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

code_meter-0.1.0/setup.py

@@ -0,0 +1,6 @@
+"""Setup configuration script for building and publishing code-meter to PyPI."""
+
+from setuptools import setup
+
+if __name__ == "__main__":
+    setup()

code_meter-0.1.0/src/code_meter/__init__.py

@@ -0,0 +1,3 @@
+"""code-meter: Local AI coding token usage tracker and cost estimator."""
+
+__version__ = "0.1.0"

code_meter-0.1.0/src/code_meter/analytics/__init__.py

@@ -0,0 +1,7 @@
+"""Analytics engine package."""
+
+from code_meter.analytics.tokens import TokenAnalytics
+from code_meter.analytics.costs import CostAnalytics
+from code_meter.analytics.reports import ReportGenerator
+
+__all__ = ["TokenAnalytics", "CostAnalytics", "ReportGenerator"]

code_meter-0.1.0/src/code_meter/analytics/costs.py

@@ -0,0 +1,43 @@
+"""Cost analytics computations."""
+
+from typing import List, Optional, Tuple
+from code_meter.models.usage import UsageRecord
+from code_meter.pricing.engine import PricingEngine
+
+
+class CostAnalytics:
+    """Calculates cumulative and per-record estimated costs."""
+
+    @staticmethod
+    def compute_record_costs(
+        records: List[UsageRecord],
+        pricing_engine: PricingEngine,
+    ) -> Tuple[List[Optional[float]], Optional[float], int]:
+        """
+        Compute cost for each record.
+        Returns (costs_list, total_cost_usd, unpriced_count).
+        """
+        costs: List[Optional[float]] = []
+        total_cost: float = 0.0
+        has_any_priced = False
+        unpriced_count = 0
+
+        for r in records:
+            c = pricing_engine.calculate_cost(
+                provider=r.provider,
+                model=r.model,
+                input_tokens=r.input_tokens,
+                output_tokens=r.output_tokens,
+                cache_read_tokens=r.cache_read_tokens,
+                cache_write_tokens=r.cache_write_tokens,
+                timestamp=r.timestamp,
+            )
+            costs.append(c)
+            if c is not None:
+                total_cost += c
+                has_any_priced = True
+            else:
+                unpriced_count += 1
+
+        final_total = round(total_cost, 4) if has_any_priced else None
+        return costs, final_total, unpriced_count