code-meter 0.1.0__py3-none-any.whl

code_meter/ui/tables.py

@@ -0,0 +1,195 @@
+"""Rich table renderers for CLI commands including prompts and diff history."""
+
+from typing import Any, Dict, List, Optional
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+from code_meter.models.project import DailyStats, ModelStats, ProjectStats, SessionStats
+from code_meter.models.usage import SessionCodeChange, SessionPrompt
+
+
+def format_tokens(n: int) -> str:
+    """Format token count into readable human notation (e.g., 1.2M, 812K, 500)."""
+    if n >= 1_000_000:
+        return f"{n / 1_000_000:.2f}M"
+    if n >= 1_000:
+        return f"{n / 1_000:.1f}K"
+    return str(n)
+
+
+def format_cost(cost: Optional[float]) -> str:
+    """Format cost as USD currency or N/A."""
+    if cost is None:
+        return "[dim]N/A[/dim]"
+    return f"${cost:.2f}"
+
+
+def render_models_table(models: List[ModelStats], console: Optional[Console] = None) -> None:
+    c = console or Console()
+    table = Table(title="Usage by Model", header_style="bold magenta")
+    table.add_column("Model", style="cyan")
+    table.add_column("Requests", justify="right")
+    table.add_column("Input", justify="right")
+    table.add_column("Output", justify="right")
+    table.add_column("Cache Read", justify="right")
+    table.add_column("Cache Write", justify="right")
+    table.add_column("Total Tokens", justify="right", style="bold")
+    table.add_column("Estimated Cost", justify="right", style="bold green")
+
+    for m in models:
+        table.add_row(
+            m.model,
+            f"{m.request_count:,}",
+            format_tokens(m.input_tokens),
+            format_tokens(m.output_tokens),
+            format_tokens(m.cache_read_tokens),
+            format_tokens(m.cache_write_tokens),
+            format_tokens(m.total_tokens),
+            format_cost(m.estimated_cost_usd),
+        )
+    c.print(table)
+
+
+def render_projects_table(projects: List[ProjectStats], console: Optional[Console] = None) -> None:
+    c = console or Console()
+    table = Table(title="Usage by Project", header_style="bold blue")
+    table.add_column("Project", style="cyan")
+    table.add_column("Requests", justify="right")
+    table.add_column("Input", justify="right")
+    table.add_column("Output", justify="right")
+    table.add_column("Cache Read", justify="right")
+    table.add_column("Cache Write", justify="right")
+    table.add_column("Total Tokens", justify="right", style="bold")
+    table.add_column("Estimated Cost", justify="right", style="bold green")
+
+    for p in projects:
+        table.add_row(
+            p.project_name,
+            f"{p.request_count:,}",
+            format_tokens(p.input_tokens),
+            format_tokens(p.output_tokens),
+            format_tokens(p.cache_read_tokens),
+            format_tokens(p.cache_write_tokens),
+            format_tokens(p.total_tokens),
+            format_cost(p.estimated_cost_usd),
+        )
+    c.print(table)
+
+
+def render_sessions_table(sessions: List[SessionStats], console: Optional[Console] = None) -> None:
+    c = console or Console()
+    table = Table(title="Recent Sessions", header_style="bold yellow")
+    table.add_column("Session ID", style="dim")
+    table.add_column("Project", style="cyan")
+    table.add_column("Primary Model", style="magenta")
+    table.add_column("Requests", justify="right")
+    table.add_column("Total Tokens", justify="right", style="bold")
+    table.add_column("Estimated Cost", justify="right", style="bold green")
+
+    for s in sessions[:30]:
+        short_id = s.session_id[:8] if len(s.session_id) > 8 else s.session_id
+        table.add_row(
+            short_id,
+            s.project_name,
+            s.primary_model,
+            f"{s.request_count:,}",
+            format_tokens(s.total_tokens),
+            format_cost(s.estimated_cost_usd),
+        )
+    c.print(table)
+
+
+def render_daily_table(daily_stats: List[DailyStats], console: Optional[Console] = None) -> None:
+    c = console or Console()
+    table = Table(title="Daily Aggregation", header_style="bold green")
+    table.add_column("Date", style="cyan")
+    table.add_column("Requests", justify="right")
+    table.add_column("Input", justify="right")
+    table.add_column("Output", justify="right")
+    table.add_column("Cache Read", justify="right")
+    table.add_column("Cache Write", justify="right")
+    table.add_column("Total Tokens", justify="right", style="bold")
+    table.add_column("Estimated Cost", justify="right", style="bold green")
+
+    for d in daily_stats:
+        table.add_row(
+            d.date_str,
+            f"{d.request_count:,}",
+            format_tokens(d.input_tokens),
+            format_tokens(d.output_tokens),
+            format_tokens(d.cache_read_tokens),
+            format_tokens(d.cache_write_tokens),
+            format_tokens(d.total_tokens),
+            format_cost(d.estimated_cost_usd),
+        )
+    c.print(table)
+
+
+def render_prompts_table(prompts: List[SessionPrompt], console: Optional[Console] = None) -> None:
+    """Render list of user prompts asked per session."""
+    c = console or Console()
+    table = Table(title="Session Prompts History", header_style="bold cyan")
+    table.add_column("Timestamp", style="dim")
+    table.add_column("Session ID", style="yellow")
+    table.add_column("Project", style="blue")
+    table.add_column("User Prompt", style="white")
+
+    for p in prompts:
+        short_session = p.session_id[:8] if len(p.session_id) > 8 else p.session_id
+        short_prompt = p.prompt_text.replace("\n", " ")
+        if len(short_prompt) > 80:
+            short_prompt = short_prompt[:77] + "..."
+        ts_str = p.timestamp.strftime("%Y-%m-%d %H:%M")
+
+        table.add_row(
+            ts_str,
+            short_session,
+            p.project_id or "Unknown",
+            short_prompt,
+        )
+    c.print(table)
+
+
+def render_code_changes_table(changes: List[SessionCodeChange], console: Optional[Console] = None) -> None:
+    """Render code change / git diff history per session."""
+    c = console or Console()
+    table = Table(title="Code Changes & Diff Log", header_style="bold green")
+    table.add_column("Timestamp", style="dim")
+    table.add_column("Session ID", style="yellow")
+    table.add_column("Type", style="magenta")
+    table.add_column("File Path", style="cyan")
+    table.add_column("Diff / Change Summary", style="white")
+
+    for ch in changes:
+        short_session = ch.session_id[:8] if len(ch.session_id) > 8 else ch.session_id
+        short_diff = ch.diff_summary.replace("\n", " | ")
+        if len(short_diff) > 80:
+            short_diff = short_diff[:77] + "..."
+        ts_str = ch.timestamp.strftime("%Y-%m-%d %H:%M")
+
+        table.add_row(
+            ts_str,
+            short_session,
+            ch.change_type.upper(),
+            ch.file_path,
+            short_diff,
+        )
+    c.print(table)
+
+
+def render_status_panel(summary: Dict[str, Any], console: Optional[Console] = None) -> None:
+    c = console or Console()
+    db_size_mb = summary["db_size_bytes"] / (1024.0 * 1024.0)
+
+    content = f"""
+[bold cyan]Database Location:[/bold cyan] {summary['db_path']}
+[bold cyan]Database Size:[/bold cyan]     {db_size_mb:.2f} MB
+[bold cyan]Scanned Files:[/bold cyan]     {summary['scanned_files']:,}
+[bold cyan]Usage Events:[/bold cyan]      {summary['total_records']:,}
+[bold cyan]Saved Prompts:[/bold cyan]     {summary['total_prompts']:,}
+[bold cyan]Saved Code Edits:[/bold cyan]  {summary['total_code_changes']:,}
+[bold cyan]Unique Sessions:[/bold cyan]   {summary['unique_sessions']:,}
+[bold cyan]Unique Projects:[/bold cyan]   {summary['unique_projects']:,}
+"""
+    c.print(Panel(content.strip(), title="[bold green]Code Meter Status[/bold green]", expand=False))

code_meter/watcher.py

@@ -0,0 +1,56 @@
+"""File watcher for watch mode (`code-meter watch`)."""
+
+import logging
+import time
+from pathlib import Path
+from typing import Callable, Optional
+
+from rich.console import Console
+
+try:
+    from watchdog.events import FileSystemEventHandler
+    from watchdog.observers import Observer
+    HAS_WATCHDOG = True
+except ImportError:
+    HAS_WATCHDOG = False
+
+logger = logging.getLogger(__name__)
+
+
+def run_watch_loop(
+    target_dir: Path,
+    on_change_callback: Callable[[], None],
+    refresh_seconds: int = 2,
+    console: Optional[Console] = None,
+) -> None:
+    """Monitor target_dir and trigger on_change_callback whenever session jsonl files update."""
+    c = console or Console()
+    c.print(f"[bold green]Watching directory:[/bold green] {target_dir}")
+    c.print("[dim]Press Ctrl+C to stop watch mode.[/dim]\n")
+
+    on_change_callback()
+
+    if HAS_WATCHDOG and target_dir.exists():
+        class JSONLHandler(FileSystemEventHandler):
+            def on_any_event(self, event):
+                if not event.is_directory and event.src_path.endswith(".jsonl"):
+                    on_change_callback()
+
+        observer = Observer()
+        observer.schedule(JSONLHandler(), str(target_dir), recursive=True)
+        observer.start()
+        try:
+            while True:
+                time.sleep(refresh_seconds)
+        except KeyboardInterrupt:
+            observer.stop()
+            c.print("\n[yellow]Watch mode stopped.[/yellow]")
+        observer.join()
+    else:
+        c.print("[yellow]Using fallback polling mode...[/yellow]")
+        try:
+            while True:
+                time.sleep(refresh_seconds)
+                on_change_callback()
+        except KeyboardInterrupt:
+            c.print("\n[yellow]Watch mode stopped.[/yellow]")

code_meter-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,33 @@
+code_meter/__init__.py,sha256=Bq3a_GNZ6q8KNm5Dxqai_J_vyRZIIYwPKgqyqMXS_3Q,97
+code_meter/cli.py,sha256=W2Y5syNWzZHPfO0SqjPKe6sew3q2iK7S95MaT9zJ5Yc,12042
+code_meter/config.py,sha256=wAYZzq4Jdhu6m9U7cH4jrOFBL31sF9OHIuCRfrlu9QI,3516
+code_meter/watcher.py,sha256=Jw5-8VE_zZS3XM55Insoqp0xhTrMLrwxq_oYGYbTk94,1762
+code_meter/analytics/__init__.py,sha256=gEEZzoGa-EPLHa3ILScj6Rhs4pxHQNYhd_dDdRTjToo,264
+code_meter/analytics/costs.py,sha256=LIvsr77h9PMO6n2rrhfwXzU23mkTMuxVCKw03S0vQC8,1408
+code_meter/analytics/reports.py,sha256=9rD1-Kj5doTmVa0PpDnq-q7PX0VYMZ5p3Q2ZGV_AbAQ,13547
+code_meter/analytics/tokens.py,sha256=KFU44DglTZcQ_cmzPwB12m03nu7FcONQml8aypJvXRU,2100
+code_meter/models/__init__.py,sha256=GMuYr3LD4uPdP7qfA_GQDgLeNj1WpgjFyi-Ng8MeA5w,324
+code_meter/models/project.py,sha256=WSa0hfRfdx6KmXc5_JWxr6CEpsP7DYzjhfOpiDMy8Tw,2346
+code_meter/models/usage.py,sha256=z2oDLfgLHvQYKNVjxlfT6nYujxusqJc-YndMCemHchc,1563
+code_meter/pricing/__init__.py,sha256=bCTHtuP-Zn8uYIY_zkF8bjxSGsMBBfS4pUrNklQzG6I,441
+code_meter/pricing/anthropic.py,sha256=AZPSIbE4LCrQ2oahHSBh3YOQ80eXyMqoSPso4J9rcr0,2676
+code_meter/pricing/engine.py,sha256=8UihgLSSTd3Jo3KLDDCt97HIne7DklMewGaFJRYrt1M,3987
+code_meter/pricing/google.py,sha256=3oqnhi1fZNPuGNNqpo0JA5Pl2iHB7uEbBZjOrLUO3Gg,2033
+code_meter/pricing/openai.py,sha256=1PTuBGJTGJ-SN4zCpuvtvkOQuV_x7RiqZeY-zJDxVr8,2237
+code_meter/providers/__init__.py,sha256=McVVgaiQkP6uZ7iocC8jXTvWF3IiKiE2GNNimEkJTPs,461
+code_meter/providers/antigravity.py,sha256=JaKFfzoqQv6WHyzoSBey0_8l3hdvKySwPgMwSakh-kA,14250
+code_meter/providers/base.py,sha256=Z8DpDdqjgIDak4yQyv23EGt5o0FcmH74r_fDPo8t9Tg,1413
+code_meter/providers/claude_code.py,sha256=cZ42yPpGgq0JRxErz7QWk-YCu4QiRBzKTiiXpYWJGTw,15106
+code_meter/providers/codex.py,sha256=3OWCtnCGCF_5U2yYJAKtzTci3rm1nXJbPsMCreCBIMs,14298
+code_meter/storage/__init__.py,sha256=hL5t8YA7FDUtVhTSVkkjSlKD1Vf3GXJQuIyCwlW-THg,222
+code_meter/storage/database.py,sha256=1db7k2HtcaUx55Bja5HZzcyfYdoLH3S4kJYbLuUt4UA,5858
+code_meter/storage/repository.py,sha256=cUxZYGhTt3FS3ViLAfjZ8Gy2tjz8DET8Vq_-Ib-K3b4,18229
+code_meter/ui/__init__.py,sha256=Aj3tppDbAgx95tbAVL26Epo9CeSPf3BxrReIl-D0fS0,447
+code_meter/ui/dashboard.py,sha256=TolFGtriUF31oVWwwjtI_Ekxup65JXOXCUow3JHeJCA,4164
+code_meter/ui/tables.py,sha256=sbWQ-vyxUWj3tK2ZKe7VQN228Sgb5xZQLg7UAwuLPmw,7686
+code_meter-0.1.0.dist-info/licenses/LICENSE,sha256=-NSD_0ce_j3dDtbi0bFZwI_H-FxN4Azs2rZYS7x-jsw,1085
+code_meter-0.1.0.dist-info/METADATA,sha256=LfMqIJgpPziJJ-HLEXG7oKztYMh98ackEZoRUZ_etCc,7066
+code_meter-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+code_meter-0.1.0.dist-info/entry_points.txt,sha256=CFYkJagPpqiZ3QhpMG7gM-v2a0QuMAdGefYB2l6uKMw,187
+code_meter-0.1.0.dist-info/top_level.txt,sha256=uQ4_CPWZF2It5bwBU8HV0EZCxmdCgevpHh5HWTdEktM,11
+code_meter-0.1.0.dist-info/RECORD,,

code_meter-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

code_meter-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+agy-meter = code_meter.cli:app
+antigravity-meter = code_meter.cli:app
+claude-meter = code_meter.cli:app
+code-meter = code_meter.cli:app
+codex-meter = code_meter.cli:app

code_meter-0.1.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+code_meter