coding-agent-roi 0.1.0__py3-none-any.whl

coding_agent_roi-0.1.0.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: coding-agent-roi
+Version: 0.1.0
+Summary: Track the cost, usage, and ROI of your AI coding agents across every tool.
+Project-URL: Homepage, https://github.com/Agent-ROI/agent-roi
+Project-URL: Repository, https://github.com/Agent-ROI/agent-roi
+Project-URL: Issues, https://github.com/Agent-ROI/agent-roi/issues
+Author: Agent-ROI contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai,claude,codex,cost,llm,observability,roi,tokens
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.111
+Requires-Dist: httpx>=0.27
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: pydantic-settings>=2.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=13.7
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer>=0.12
+Requires-Dist: uvicorn[standard]>=0.30
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# Agent-ROI
+
+**Track the cost, usage, and ROI of your AI coding agents — across every tool.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/Agent-ROI/agent-roi/actions/workflows/ci.yml/badge.svg)](https://github.com/Agent-ROI/agent-roi/actions/workflows/ci.yml)
+
+[English](./README.md) · [繁體中文](./README.zh.md)
+
+</div>
+
+---
+
+## What is Agent-ROI?
+
+When you use multiple AI coding tools — Claude Code, Codex CLI, GitHub Copilot, Cursor, and others — your token spend is scattered everywhere and impossible to evaluate. **Agent-ROI** unifies all of it.
+
+It reads the local session logs each tool already writes, uses a **model-free semantic classifier** to discover *what topic / task* each session was about, and then shows you **how many tokens each topic consumed** — so you can measure the **return on investment** of your agents, not just raw token counts.
+
+> The core question Agent-ROI answers: *"For this feature / bug / topic, how many tokens did my agents burn — and was it worth it?"*
+
+## Features
+
+- 🔌 **Tool-agnostic collectors** — parse local logs from Claude Code, Codex CLI, GitHub Copilot, and Gemini CLI (no proxy, no workflow change).
+- 🧠 **Topic classification** — a model-free semantic classifier groups sessions by topic so you see cost *per subject*, not per request. Runs fully offline, costs nothing, requires no external service.
+- 💰 **Cost & ROI tracking** — token usage mapped to per-model pricing, aggregated by **topic, tool, or model**, over a **custom time window**.
+- 🔎 **Drill-down & trust** — click any topic to see which tools and models its tokens came from; every figure is backed by a **viewable pricing table**, and estimated numbers are clearly badged vs exact ones.
+- 🖥️ **CLI** — `report`, per-topic drill-down, and a `pricing` command straight from the terminal.
+- 🌐 **Web UI** — a modern React dashboard with dimension/time controls, breakdowns, and drill-downs.
+- 🗄️ **Local-first** — everything stays on your machine (SQLite); fully offline; classification never sends data anywhere.
+
+## Architecture
+
+```
+┌──────────────┐   ┌──────────────┐   ┌──────────────┐
+│  Collectors  │──▶│  Classifier  │──▶│   Storage    │
+│ (parse logs) │   │  (semantic)  │   │  (SQLite)    │
+└──────────────┘   └──────────────┘   └──────┬───────┘
+                                             │
+                          ┌──────────────────┼──────────────────┐
+                          ▼                                      ▼
+                   ┌────────────┐                        ┌────────────┐
+                   │    CLI     │                        │  REST API  │──▶ Web UI (React)
+                   └────────────┘                        └────────────┘
+```
+
+See [docs/architecture.md](./docs/architecture.md) for details.
+
+## Install
+
+One line (macOS / Linux / WSL). Installs `uv` if needed, then the `agent-roi` command:
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/Agent-ROI/agent-roi/main/scripts/install.sh | sh
+```
+
+<details>
+<summary>Other ways to install</summary>
+
+```bash
+# With pipx
+pipx install agent-roi
+
+# With uv
+uv tool install agent-roi
+```
+
+To install the latest from source before a release is published, set
+`AGENT_ROI_FROM_GIT=1` before running the install script.
+</details>
+
+## Quick Start
+
+```bash
+# Ingest logs from all detected tools
+agent-roi ingest
+
+# Discover topics from your sessions (model-free, fully local)
+agent-roi classify
+
+# Cost breakdown — group by topic, tool, or model, over a time window
+agent-roi report --by tool --since 7d
+
+# Drill into one topic: which tools/models did its tokens come from?
+agent-roi topic "auth refactor"
+
+# Inspect the pricing table behind every cost figure
+agent-roi pricing
+
+# Launch the web dashboard (API + React UI), then open http://127.0.0.1:8000
+agent-roi serve
+```
+
+> Developing Agent-ROI itself? See [CONTRIBUTING.md](./CONTRIBUTING.md) — local
+> dev uses `uv` and runs the frontend on a separate Vite dev server.
+
+## Configuration
+
+Agent-ROI looks for config at `~/.config/agent-roi/config.toml`. See [docs/configuration.md](./docs/configuration.md).
+
+```toml
+[classifier]
+similarity_threshold = 0.18   # higher = more, smaller topics
+label_terms = 3               # words used to name each topic
+
+[collectors]
+enabled = ["claude_code", "codex", "copilot", "gemini"]
+```
+
+## Documentation
+
+| Doc | English | 繁體中文 |
+|-----|---------|----------|
+| Architecture | [architecture.md](./docs/architecture.md) | [architecture.zh.md](./docs/architecture.zh.md) |
+| Configuration | [configuration.md](./docs/configuration.md) | [configuration.zh.md](./docs/configuration.zh.md) |
+| Collectors | [collectors.md](./docs/collectors.md) | [collectors.zh.md](./docs/collectors.zh.md) |
+| Contributing | [CONTRIBUTING.md](./CONTRIBUTING.md) | [CONTRIBUTING.zh.md](./CONTRIBUTING.zh.md) |
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) and our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## License
+
+[MIT](./LICENSE) © Agent-ROI contributors

coding_agent_roi-0.1.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+agent_roi/__init__.py,sha256=w5PAbosOHLW324YR33d1EdHhLufCMJX5OAEmZZeaBkM,105
+agent_roi/api/__init__.py,sha256=8LheufkuMWBJbkSeZqzpwWmGBHxShmb5-wPGEXE5p38,24
+agent_roi/api/app.py,sha256=mdMpbjjJVVluSrgBb2PP1rxrp8Ilzm2bMlcTELyu6Wo,6489
+agent_roi/classify/__init__.py,sha256=KOAibqKlDqCBTbrCypn7LOVXlGJ0wN30b-nI5qjakSU,866
+agent_roi/classify/base.py,sha256=MJWy9nq1SQvZnfdKYF7rNFb-Es5_FlpR9U-GuAkO0C0,1445
+agent_roi/classify/semantic.py,sha256=6RbWfk9Fe_bwzmpVV512OEJQCJAt0syTpJ-VUFZSIM4,7582
+agent_roi/cli/__init__.py,sha256=C63yWifzpA0IV7YWDatpAdrhoV8zjqxAKv0xMf09VdM,19
+agent_roi/cli/main.py,sha256=-OkN3SH7E7mdVHqFgaj1TunIrcx56bD8XqD4pkQRjcQ,7008
+agent_roi/collectors/__init__.py,sha256=ax0xj61Ynq411QwzH02Bco8MqS78NGhbNNG3cCgAl9M,982
+agent_roi/collectors/base.py,sha256=Ihzxke6p-38Bxf5mJZK5HCndxs0bFA5-aiPX4-AvvP4,1539
+agent_roi/collectors/claude_code.py,sha256=0LDJyCTDryFR6R6-pZuMEi9B554m70p_hqLCqeQpbZ0,5701
+agent_roi/collectors/codex.py,sha256=VQ9_ny4M2PEKHGdAuaOs1qrtzp7GrWDmOjfVrlSyWpE,5478
+agent_roi/collectors/copilot.py,sha256=jHT8rPTxH7KdeZghZdUa6WBumn9OcZ9FG10JtpMa_mU,7560
+agent_roi/collectors/gemini.py,sha256=2fpv-mzCqcCLB5lPCOH478_AMgCG7hJEB5Xp7BUiIzg,7843
+agent_roi/core/__init__.py,sha256=ETauXfgnwzwFR_NUEv6XbO7W9aa7bwtGbjVkpB1TT_I,75
+agent_roi/core/config.py,sha256=n7Va6sI_SD5oQ9E0r7fkJ_QL9hyRAWsF14dqk7xg76Q,1725
+agent_roi/core/models.py,sha256=SYX1YGyJaLRY00lZGWRdAA9BI0UATNpUakFDWn8SkVU,6543
+agent_roi/core/platform.py,sha256=2I5KGLsNmt0TRA27BMKMV4BCkpGg_n4lqn_qXYDSw1U,4049
+agent_roi/core/pricing.py,sha256=G4204TbrjkzkMV9eJKA0oWYS9sNMpWyK3pFf6F3F-SA,3053
+agent_roi/core/project.py,sha256=z9GDVqshBpiZPwoUAoxtc92sUy972ah1uBmBEd6bqmo,1792
+agent_roi/core/service.py,sha256=AaJD5qcR4hKpNvBOP8GwqoPUxCMIe9q7YwvNqlnQxWY,6483
+agent_roi/core/timeframe.py,sha256=-2oJ2Wz8dUhDvjoF6c7NReSNbg5mlez32BBnUqmpoJo,2498
+agent_roi/core/tokens.py,sha256=sWMgvlr_aW5z7VoPPSbXIxmUgR73JBPjQIoqg4I_ZLw,1348
+agent_roi/storage/__init__.py,sha256=tP0GmIOTy55sTE0qOz933mje3vk1A15Bu5Y6IbTsa8U,88
+agent_roi/storage/db.py,sha256=Zf29lCwSsrc3zWL1A71ZaC1bTc4WeYx75EOrmvBYgdw,21140
+coding_agent_roi-0.1.0.dist-info/METADATA,sha256=t7YjKrKo0LoInlg3d0L2zvuoF0qM4IUbYKOsm9YP3z4,7035
+coding_agent_roi-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+coding_agent_roi-0.1.0.dist-info/entry_points.txt,sha256=Cl2DXAx1ygCVb7c5OqyxHzJumcAW3j8DLP3KQvdazIc,53
+coding_agent_roi-0.1.0.dist-info/licenses/LICENSE,sha256=mDk0ZOBLVgqU1YR0YKy8kLeX7Mic-QTcCxRsaqqtx38,1079
+coding_agent_roi-0.1.0.dist-info/RECORD,,

coding_agent_roi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

coding_agent_roi-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agent-roi = agent_roi.cli.main:app

coding_agent_roi-0.1.0.dist-info/licenses/LICENSE

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