code-meter 0.2.0__tar.gz → 0.4.0__tar.gz

{code_meter-0.2.0 → code_meter-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-meter
-Version: 0.2.0
+Version: 0.4.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
@@ -71,18 +71,52 @@ This launches the interactive Rich terminal dashboard displaying key metrics, mo
 
 ---
 
+## 🖥️ Interactive Rich Terminal UI
+
+`code-meter` includes a full-featured, responsive **Rich Terminal User Interface** that presents live token metrics, USD costs, user queries, and model outputs in real-time.
+
+```text
++--------------------------------------------------------------------+
+|                             CODE METER                             |
+|                              Overview                              |
++--------------------------------------------------------------------+
++--------------------------- Key Metrics ----------------------------+
+| Requests:                                                        3 |
+| Input Tokens:                                                 1.5K |
+| Output Tokens:                                                 400 |
+| Cache Read:                                                    300 |
+| Total Tokens:                                                 2.2K |
+| Estimated Cost:                                              $0.02 |
++--------------------------------------------------------------------+
+| BY MODEL            | Tokens   | Cost                              |
+| gemini-2.5-flash    | 2.20K    | $0.02                             |
++--------------------------------------------------------------------+
+| RECENT USER QUERIES / PROMPTS                                      |
+| 09-01 12:00 | antigravity | Build an interactive dashboard UI     |
++--------------------------------------------------------------------+
+| RECENT OUTPUTS & CODE EDITS                                       |
+| 09-01 12:01 | WRITE_FILE  | src/main.py | + print('Hello')        |
++--------------------------------------------------------------------+
+```
+
+---
+
 ## 🛠️ CLI Commands
 
 | Command | Description |
 | :--- | :--- |
-| `code-meter` | Open interactive Rich terminal dashboard |
+| `code-meter` | Open main interactive Rich terminal dashboard UI |
+| `code-meter ui` | Launch live Web Dashboard on **http://localhost:5005** (auto-opens browser) |
+| `code-meter ui --terminal` | Launch live interactive Rich terminal UI |
+| `code-meter watch` | Live watch mode (auto-refreshes UI as AI agents write logs) |
+| `code-meter update-pricing` | Fetch latest real-time token pricing for 2,800+ models |
 | `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 prompts` | View log of user prompts and queries asked over time |
+| `code-meter history` | View log of code modifications, file writes, and assistant actions |
 | `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 |
@@ -90,7 +124,6 @@ This launches the interactive Rich terminal dashboard displaying key metrics, mo
 | `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 |
 
 ---
 
@@ -99,6 +132,9 @@ This launches the interactive Rich terminal dashboard displaying key metrics, mo
 Combine filters on reporting, prompts, and history commands:
 
 ```bash
+# Update real-time token costs for 2,800+ models
+code-meter update-pricing
+
 # 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
@@ -165,29 +201,13 @@ ClaudeCodeProvider        CodexProvider          AntigravityProvider
             Database Repository & Incremental Scanner (SQLite)
                                  │
                                  ▼
-              Pricing Engine (Multi-Provider Model Pricing Tables)
+           Pricing Engine (Auto Daily Sync & Live Model Pricing)
                                  │
                                  ▼
              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
+          Rich Terminal UI & Interactive Dashboard Commands
 ```
 
 ---

{code_meter-0.2.0 → code_meter-0.4.0}/README.md

@@ -49,18 +49,52 @@ This launches the interactive Rich terminal dashboard displaying key metrics, mo
 
 ---
 
+## 🖥️ Interactive Rich Terminal UI
+
+`code-meter` includes a full-featured, responsive **Rich Terminal User Interface** that presents live token metrics, USD costs, user queries, and model outputs in real-time.
+
+```text
++--------------------------------------------------------------------+
+|                             CODE METER                             |
+|                              Overview                              |
++--------------------------------------------------------------------+
++--------------------------- Key Metrics ----------------------------+
+| Requests:                                                        3 |
+| Input Tokens:                                                 1.5K |
+| Output Tokens:                                                 400 |
+| Cache Read:                                                    300 |
+| Total Tokens:                                                 2.2K |
+| Estimated Cost:                                              $0.02 |
++--------------------------------------------------------------------+
+| BY MODEL            | Tokens   | Cost                              |
+| gemini-2.5-flash    | 2.20K    | $0.02                             |
++--------------------------------------------------------------------+
+| RECENT USER QUERIES / PROMPTS                                      |
+| 09-01 12:00 | antigravity | Build an interactive dashboard UI     |
++--------------------------------------------------------------------+
+| RECENT OUTPUTS & CODE EDITS                                       |
+| 09-01 12:01 | WRITE_FILE  | src/main.py | + print('Hello')        |
++--------------------------------------------------------------------+
+```
+
+---
+
 ## 🛠️ CLI Commands
 
 | Command | Description |
 | :--- | :--- |
-| `code-meter` | Open interactive Rich terminal dashboard |
+| `code-meter` | Open main interactive Rich terminal dashboard UI |
+| `code-meter ui` | Launch live Web Dashboard on **http://localhost:5005** (auto-opens browser) |
+| `code-meter ui --terminal` | Launch live interactive Rich terminal UI |
+| `code-meter watch` | Live watch mode (auto-refreshes UI as AI agents write logs) |
+| `code-meter update-pricing` | Fetch latest real-time token pricing for 2,800+ models |
 | `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 prompts` | View log of user prompts and queries asked over time |
+| `code-meter history` | View log of code modifications, file writes, and assistant actions |
 | `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 |
@@ -68,7 +102,6 @@ This launches the interactive Rich terminal dashboard displaying key metrics, mo
 | `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 |
 
 ---
 
@@ -77,6 +110,9 @@ This launches the interactive Rich terminal dashboard displaying key metrics, mo
 Combine filters on reporting, prompts, and history commands:
 
 ```bash
+# Update real-time token costs for 2,800+ models
+code-meter update-pricing
+
 # 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
@@ -143,29 +179,13 @@ ClaudeCodeProvider        CodexProvider          AntigravityProvider
             Database Repository & Incremental Scanner (SQLite)
                                  │
                                  ▼
-              Pricing Engine (Multi-Provider Model Pricing Tables)
+           Pricing Engine (Auto Daily Sync & Live Model Pricing)
                                  │
                                  ▼
              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
+          Rich Terminal UI & Interactive Dashboard Commands
 ```
 
 ---

{code_meter-0.2.0 → code_meter-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-meter"
-version = "0.2.0"
+version = "0.4.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" }]

{code_meter-0.2.0 → code_meter-0.4.0}/src/code_meter/cli.py

@@ -88,10 +88,49 @@ def _perform_scan(quiet: bool = False) -> int:
     return total_new_records
 
 
+def _launch_live_ui() -> None:
+    """Launch the live watch mode dashboard UI monitoring all active AI provider directories."""
+    config, repo, pricing_engine, providers, report_gen = _get_services()
+
+    def update_and_render():
+        _perform_scan(quiet=True)
+        records = repo.query_usage_events()
+        prompts = repo.query_prompts(limit=10)
+        code_changes = repo.query_code_changes(limit=10)
+        summary = report_gen.generate_summary(records, filter_date_str=datetime.now(timezone.utc).strftime("%Y-%m-%d"))
+        console.clear()
+        render_dashboard(
+            summary=summary,
+            prompts=prompts,
+            code_changes=code_changes,
+            title_suffix="Live Watch Dashboard",
+            console=console,
+        )
+
+    target_dirs = [
+        config.get_claude_dir(),
+        config.get_codex_dir(),
+        config.get_antigravity_dir(),
+    ]
+    run_watch_loop(
+        target_dir=target_dirs,
+        on_change_callback=update_and_render,
+        refresh_seconds=config.get_refresh_seconds(),
+        console=console,
+    )
+
+
 @app.callback()
-def main_callback(ctx: typer.Context):
+def main_callback(
+    ctx: typer.Context,
+    watch: bool = typer.Option(False, "--watch", "-w", help="Launch live watch UI mode"),
+):
     """Default action when running `code-meter` without subcommands."""
     if ctx.invoked_subcommand is None:
+        if watch:
+            _launch_live_ui()
+            return
+
         _perform_scan(quiet=True)
         config, repo, pricing_engine, providers, report_gen = _get_services()
 
@@ -383,33 +422,36 @@ def update_pricing_cmd():
         console.print("[yellow]Could not update pricing or offline using fallback pricing.[/yellow]")
 
 
+@app.command("ui")
+@app.command("dashboard")
+@app.command("web")
+def ui_cmd(
+    port: int = typer.Option(5005, "--port", "-p", help="Port number for local dashboard server"),
+    host: str = typer.Option("127.0.0.1", "--host", "-h", help="Host address for dashboard server"),
+    terminal: bool = typer.Option(False, "--terminal", "-t", help="Launch Rich terminal UI instead of Web UI"),
+    no_browser: bool = typer.Option(False, "--no-browser", help="Do not open web browser automatically"),
+):
+    """Launch local web dashboard UI on http://localhost:5005 (or terminal UI with --terminal)."""
+    if terminal:
+        _launch_live_ui()
+    else:
+        from code_meter.ui.web.server import start_web_server
+        config, repo, pricing_engine, _, report_gen = _get_services()
+        start_web_server(
+            host=host,
+            port=port,
+            open_browser=not no_browser,
+            config=config,
+            repo=repo,
+            pricing_engine=pricing_engine,
+            report_gen=report_gen,
+        )
+
+
 @app.command("watch")
 def watch_cmd():
     """Monitor local session log files in real-time and auto-update metrics."""
-    config, repo, pricing_engine, providers, report_gen = _get_services()
-
-    def update_and_render():
-        _perform_scan(quiet=True)
-        records = repo.query_usage_events()
-        prompts = repo.query_prompts(limit=10)
-        code_changes = repo.query_code_changes(limit=10)
-        summary = report_gen.generate_summary(records, filter_date_str=datetime.now(timezone.utc).strftime("%Y-%m-%d"))
-        console.clear()
-        render_dashboard(
-            summary=summary,
-            prompts=prompts,
-            code_changes=code_changes,
-            title_suffix="Watch Mode (Live)",
-            console=console,
-        )
-
-    target_dir = providers[0].claude_dir if providers else config.get_claude_dir()
-    run_watch_loop(
-        target_dir=target_dir,
-        on_change_callback=update_and_render,
-        refresh_seconds=config.get_refresh_seconds(),
-        console=console,
-    )
+    _launch_live_ui()
 
 
 if __name__ == "__main__":

code_meter-0.4.0/src/code_meter/ui/web/__init__.py

@@ -0,0 +1,5 @@
+"""Web UI package for code-meter dashboard."""
+
+from code_meter.ui.web.server import start_web_server
+
+__all__ = ["start_web_server"]

code_meter-0.4.0/src/code_meter/ui/web/server.py

@@ -0,0 +1,194 @@
+"""Lightweight Web Dashboard HTTP Server running on http://localhost:5005 for code-meter."""
+
+import json
+import logging
+import threading
+import time
+import webbrowser
+from datetime import datetime, timezone
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from typing import Any, Dict, Optional
+
+from code_meter.analytics.reports import ReportGenerator
+from code_meter.pricing.engine import PricingEngine
+from code_meter.providers.antigravity import AntigravityProvider
+from code_meter.providers.claude_code import ClaudeCodeProvider
+from code_meter.providers.codex import CodexProvider
+from code_meter.storage.repository import UsageRepository
+from code_meter.ui.web.static import HTML_DASHBOARD
+from code_meter.watcher import run_watch_loop
+
+logger = logging.getLogger(__name__)
+
+
+def create_web_handler(repo: UsageRepository, pricing_engine: PricingEngine, report_gen: ReportGenerator):
+    """Factory creating HTTPRequestHandler with injected service dependencies."""
+
+    class CodeMeterWebHandler(BaseHTTPRequestHandler):
+        def log_message(self, format: str, *args: Any) -> None:
+            # Suppress default noisy HTTP request logs
+            pass
+
+        def do_GET(self) -> None:
+            path = self.path.split("?")[0]
+
+            if path in ("/", "/index.html"):
+                self.send_response(200)
+                self.send_header("Content-Type", "text/html; charset=utf-8")
+                self.end_headers()
+                self.wfile.write(HTML_DASHBOARD.encode("utf-8"))
+
+            elif path == "/api/summary":
+                self.handle_api_summary()
+
+            elif path == "/api/prompts":
+                self.handle_api_prompts()
+
+            elif path == "/api/changes":
+                self.handle_api_changes()
+
+            else:
+                self.send_error(404, "Not Found")
+
+        def handle_api_summary(self) -> None:
+            records = repo.query_usage_events()
+            prompts = repo.query_prompts(limit=15)
+            code_changes = repo.query_code_changes(limit=15)
+
+            costs = [
+                pricing_engine.calculate_cost(
+                    r.provider, r.model, r.input_tokens, r.output_tokens, r.cache_read_tokens, r.cache_write_tokens, r.timestamp
+                )
+                for r in records
+            ]
+
+            summary = report_gen.generate_summary(records, filter_date_str=datetime.now(timezone.utc).strftime("%Y-%m-%d"))
+            by_model = report_gen.aggregate_by_model(records, costs)
+            by_project = report_gen.aggregate_by_project(records, costs)
+
+            payload = {
+                "summary": {
+                    "total_requests": summary.total_requests,
+                    "total_input_tokens": summary.input_tokens,
+                    "total_output_tokens": summary.output_tokens,
+                    "total_cache_read_tokens": summary.cache_read_tokens,
+                    "total_cache_write_tokens": summary.cache_write_tokens,
+                    "total_tokens": summary.total_tokens,
+                    "total_cost": summary.estimated_cost_usd or 0.0,
+                },
+                "by_model": [
+                    {
+                        "model": m.model,
+                        "requests": m.request_count,
+                        "total_tokens": m.total_tokens,
+                        "total_cost": m.estimated_cost_usd or 0.0,
+                    }
+                    for m in by_model
+                ],
+                "by_project": [
+                    {
+                        "project_name": p.project_name,
+                        "requests": p.request_count,
+                        "total_tokens": p.total_tokens,
+                        "total_cost": p.estimated_cost_usd or 0.0,
+                    }
+                    for p in by_project
+                ],
+                "prompts": [
+                    {
+                        "timestamp": p.timestamp,
+                        "provider": p.provider,
+                        "prompt_text": p.prompt_text,
+                        "project_id": p.project_id or "",
+                    }
+                    for p in prompts
+                ],
+                "code_changes": [
+                    {
+                        "timestamp": c.timestamp,
+                        "provider": c.provider,
+                        "file_path": c.file_path,
+                        "change_type": c.change_type,
+                        "diff_summary": c.diff_summary,
+                    }
+                    for c in code_changes
+                ],
+            }
+
+            self.send_json_response(payload)
+
+        def handle_api_prompts(self) -> None:
+            prompts = repo.query_prompts(limit=50)
+            self.send_json_response({"prompts": [p.model_dump() for p in prompts]})
+
+        def handle_api_changes(self) -> None:
+            changes = repo.query_code_changes(limit=50)
+            self.send_json_response({"code_changes": [c.model_dump() for c in changes]})
+
+        def send_json_response(self, data: Dict[str, Any]) -> None:
+            body = json.dumps(data, indent=2, default=str).encode("utf-8")
+            self.send_response(200)
+            self.send_header("Content-Type", "application/json")
+            self.send_header("Access-Control-Allow-Origin", "*")
+            self.end_headers()
+            self.wfile.write(body)
+
+    return CodeMeterWebHandler
+
+
+def start_web_server(
+    host: str = "127.0.0.1",
+    port: int = 5005,
+    open_browser: bool = True,
+    config: Optional[Any] = None,
+    repo: Optional[UsageRepository] = None,
+    pricing_engine: Optional[PricingEngine] = None,
+    report_gen: Optional[ReportGenerator] = None,
+) -> None:
+    """Launch HTTP server on specified host/port serving localhost web dashboard."""
+    if not (repo and pricing_engine and report_gen and config):
+        from code_meter.cli import _get_services
+        config, repo, pricing_engine, providers, report_gen = _get_services()
+    else:
+        providers = [
+            ClaudeCodeProvider(config.get_claude_dir()),
+            CodexProvider(config.get_codex_dir()),
+            AntigravityProvider(config.get_antigravity_dir()),
+        ]
+
+    # Background scanner loop
+    def background_scan_and_watch():
+        def do_scan():
+            states = repo.get_scan_states()
+            for p in providers:
+                res = p.scan(states)
+                repo.save_records(res.records)
+                repo.save_prompts(res.prompts)
+                repo.save_code_changes(res.code_changes)
+                repo.update_scan_states(res.updated_states)
+
+        target_dirs = [config.get_claude_dir(), config.get_codex_dir(), config.get_antigravity_dir()]
+        run_watch_loop(target_dir=target_dirs, on_change_callback=do_scan, refresh_seconds=config.get_refresh_seconds())
+
+    watch_thread = threading.Thread(target=background_scan_and_watch, daemon=True)
+    watch_thread.start()
+
+    handler_cls = create_web_handler(repo, pricing_engine, report_gen)
+    server = ThreadingHTTPServer((host, port), handler_cls)
+
+    url = f"http://localhost:{port}"
+    print(f"\n[code-meter] Web Dashboard running at: {url}")
+    print("Press Ctrl+C to stop the web server.\n")
+
+    if open_browser:
+        def open_browser_later():
+            time.sleep(0.5)
+            webbrowser.open(url)
+        threading.Thread(target=open_browser_later, daemon=True).start()
+
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\nShutting down web dashboard server...")
+        server.shutdown()
+        server.server_close()