agentprof 0.1.0__py3-none-any.whl

agentprof/server/static/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>agentprof</title>
+    <!-- API discovery: /api -->
+    <script type="module" crossorigin src="/assets/index-ZsPn1H3d.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C4HEqUVf.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

agentprof-0.1.0.dist-info/METADATA

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: agentprof
+Version: 0.1.0
+Summary: Analyse AI coding agent sessions: call trees, timings, tokens, cost and waste.
+Keywords: ai,agents,copilot,claude-code,llm,tokens,cost,observability
+Author: epicodic
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Dist: fastapi>=0.120
+Requires-Dist: uvicorn>=0.38
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/epicodic/agentprof
+Project-URL: Repository, https://github.com/epicodic/agentprof
+Project-URL: Issues, https://github.com/epicodic/agentprof/issues
+Description-Content-Type: text/markdown
+
+# agentprof
+
+[![PyPI](https://img.shields.io/pypi/v/agentprof?cacheSeconds=3600)](https://pypi.org/project/agentprof/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agentprof?cacheSeconds=3600)](https://pypi.org/project/agentprof/)
+[![CI](https://github.com/epicodic/agentprof/actions/workflows/ci.yml/badge.svg)](https://github.com/epicodic/agentprof/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/epicodic/agentprof/blob/main/LICENSE)
+
+**A profiler for AI coding agents: see where your agents spend time, tokens and money.**
+
+agentprof reads the session logs that Claude Code, OpenAI Codex CLI and VS Code Copilot Chat already write on your machine.
+It shows each session as a call tree of turns, subagents and tool calls, with an inline timeline, token counts, context growth, costs and hints about likely waste.
+Everything runs locally, so your sessions never leave your machine.
+
+![A Claude Code session as a call tree with timeline, cost, tokens and context per row](https://media.githubusercontent.com/media/epicodic/agentprof/main/docs/images/session-tree.png)
+
+## Features
+
+- **Call tree with timeline**: every prompt, subagent and tool call becomes a row with its duration, cost, tokens and peak context, next to a timeline bar for when it ran.
+  Nested subagents get their own colour-coded agent numbers, so you can follow a delegation chain at a glance.
+- **Cost and token accounting**: costs and tokens are given both per node and rolled up per subtree, with input, output, cache read and cache write tokens counted separately.
+  Estimated values are marked `≈`, and values the logs do not contain are shown as `–` instead of being guessed.
+- **Context tracking**: see how the context window grows call by call, where it peaks and where it was compacted.
+- **Agent summary**: one row per agent with its model, cache TTL, resumes, duration, own cost, share of the session cost and token breakdown.
+- **Node details**: open any turn or agent to see its timeline, cost per LLM call, context chart, subagents and a searchable list of LLM and tool calls, down to the raw prompt, result and tool arguments.
+- **Waste findings**: hints, not verdicts, about where time and money may have gone (see [Findings](#findings)).
+- **Live updates**: the session list fills in within seconds, and open sessions update while an agent is still working.
+- **JSON API for AI agents**: everything in the UI is also available as compact JSON, so an AI agent can analyse sessions itself, including how the agents and subagents in them worked together.
+
+![Node details with timeline, cost per LLM call, context growth, subagents and LLM calls](https://media.githubusercontent.com/media/epicodic/agentprof/main/docs/images/node-details.png)
+
+## Installation
+
+agentprof is a command-line tool that starts a local web app.
+Install it in its own isolated environment with [uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/):
+
+```sh
+uv tool install agentprof
+# or
+pipx install agentprof
+```
+
+Or run it once without installing it:
+
+```sh
+uvx agentprof
+```
+
+agentprof requires Python 3.12 or newer.
+
+## Usage
+
+```sh
+agentprof
+```
+
+This starts a local server on `127.0.0.1:8765` and opens your browser.
+The session list appears immediately and fills in while sessions are summarised in the background; a session is analysed in full when you open it.
+
+```
+agentprof [SESSION] [--host 127.0.0.1] [--port 8765] [--no-browser]
+          [--claude-root DIR] [--codex-root DIR] [--copilot-root DIR]
+          [--pricing FILE]
+```
+
+| Option | Purpose |
+|---|---|
+| `SESSION` | Open a session directly: `<agent>:<id>` (e.g. `claude-code:<id>`), a bare id, or a session file path such as a Copilot chat export. |
+| `--host`, `--port` | Interface and port to bind. |
+| `--no-browser` | Do not open a browser. |
+| `--claude-root`, `--codex-root`, `--copilot-root` | Read sessions from a different directory. |
+| `--pricing` | Replace the bundled price table: per-model token prices and the USD value of a Copilot credit (`usd_per_credit`). |
+
+## Supported agents
+
+| Agent | Sessions read from | Cost |
+|---|---|---|
+| Claude Code | `~/.claude/projects` (or `$CLAUDE_CONFIG_DIR/projects`), including subagent transcripts | USD at API list prices, estimated |
+| OpenAI Codex CLI | `~/.codex/sessions`, including subagent rollouts | USD at API list prices, estimated |
+| VS Code Copilot Chat | `workspaceStorage` of VS Code and VS Code Insiders on Linux, macOS and Windows | Credits as reported by Copilot, converted to USD at $0.01 per credit |
+
+Claude Code and Codex costs are API-equivalent estimates; on a subscription you do not pay per token.
+Costs keep their native unit and are never added across units.
+
+## Findings
+
+agentprof flags likely waste as hints, not verdicts.
+Each finding is attached to the turn or agent it is about, and the session header counts them.
+
+| Finding | What it looks for |
+|---|---|
+| Repeated reads | The same file read several times with overlapping line ranges. |
+| Re-acquired context | A subagent reading files its parent agent had already read. |
+| Retry chains | Sibling agents started with very similar tasks. |
+| Repeated or failing commands | The same command run again and again, or a high tool failure rate. |
+| Polling loops | Long streaks of consecutive polling calls. |
+| Cost outliers | Agents that cost far more than their siblings. |
+| Context bloat | Large uncached prompts and low cache hit ratios. |
+| Cold cache rewrites | Large cache writes with little reuse, for example after the cache expired during a wait for the user. |
+| Idle parents | A parent agent idling after a child agent completed. |
+| Context jumps | Context that grew sharply between two calls. |
+
+## Local API for AI agents
+
+agentprof is useful to people, and just as useful to AI agents.
+While it runs, everything it knows about a session is available as JSON on the same port, so you can point an agent at a session and ask it what went wrong, why a run was expensive or how its subagents worked together.
+
+The API is built for this:
+
+- **Self-describing**: [`/api`](http://127.0.0.1:8765/api/) lists every endpoint with its parameters, and each session page links to its JSON, so a URL from the browser is enough to start with.
+  `/sessions/{id}?format=json` returns the same data as the API route.
+- **Agent by agent**: `/summary` gives one row per agent with its parent agent, so the delegation tree can be rebuilt without the full call tree.
+  Each row has the agent's topic, models, LLM calls, peak context, tokens, cache TTL, resumes, longest gap, its own cost and the cost of everything it delegated.
+- **Findings first**: `/findings` puts the likely waste with the highest estimated cost first.
+- **Bounded downloads**: `depth` and `fields` cut a large call tree down to what fits in a context window; prompts, results and tool arguments are only fetched for the node that needs them.
+- **Honest numbers**: every value says whether it is `exact`, `estimated` or `n/a`, so an agent can tell measurements from guesses.
+
+For example, ask your agent:
+
+```text
+agentprof is running on http://127.0.0.1:8765. Start at /api, open session
+claude-code:<id> and explain which subagents drove the cost, where they
+waited for each other, and what we could do differently next time.
+```
+
+| Endpoint | Returns |
+|---|---|
+| [`/api`](http://127.0.0.1:8765/api/) | Endpoint index with parameters and descriptions |
+| [`/docs`](http://127.0.0.1:8765/docs) | Interactive OpenAPI schema |
+| `/api/sessions` | All sessions, newest first |
+| `/api/sessions/events` | Server-sent events for session list updates |
+| `/api/sessions/{id}` | The full call tree with metrics and findings; `depth` and `fields=session,diagnostics,tree` bound a large download |
+| `/api/sessions/{id}/summary` | One compact row per agent, with its parent, cost and cache breakdowns |
+| `/api/sessions/{id}/findings` | Findings, ordered by estimated avoidable cost, severity and time |
+| `/api/sessions/{id}/nodes/{node_id}` | Prompt, result and raw tool arguments of one node |
+| `/api/sessions/{id}/diagnostics` | Parse counts and redacted details of malformed lines |
+| `/api/pricing` | The effective price table and its model matching rule |
+
+## Development
+
+```sh
+./bootstrap.sh             # install uv, Node (nvm), pnpm and all dependencies
+uv run agentprof           # run against your own sessions
+pnpm --dir frontend dev    # frontend dev server, proxies /api to port 8765
+uv run qa                  # lint, type check and tests for Python and the frontend
+uv run build-dist          # build and smoke-test the distributions
+```
+
+See [`docs/architecture.md`](https://github.com/epicodic/agentprof/blob/main/docs/architecture.md) for how the code fits together, [`AGENTS.md`](https://github.com/epicodic/agentprof/blob/main/AGENTS.md) for conventions and [`docs/releasing.md`](https://github.com/epicodic/agentprof/blob/main/docs/releasing.md) for releases.
+
+## License
+
+[MIT](https://github.com/epicodic/agentprof/blob/main/LICENSE)

agentprof-0.1.0.dist-info/RECORD

@@ -0,0 +1,54 @@
+agentprof/__init__.py,sha256=VAd9TUmCRQZ185RhfonCSrV-5NtAFWIJkLUZUNIJXTo,188
+agentprof/adapters/__init__.py,sha256=r-SQUSBrrtLHfsP_I8cO7MerpRXDPwIzjutXfPLGg_M,631
+agentprof/adapters/base.py,sha256=G2J1cCr0nsTSuDwm2DhC3lpvsRxTWrhGNmuRONcmJZE,2153
+agentprof/adapters/claude_code/__init__.py,sha256=W0H4TRw8nNhV-JY1oDKcZhQrbv1dcLnVPj6i_ZOpD5c,88
+agentprof/adapters/claude_code/adapter.py,sha256=TPf_t4KyMtLthMrPBwKuPIAV4UTF8MS1ezJ0vg_tI_I,5186
+agentprof/adapters/claude_code/discovery.py,sha256=iL3bNiaC-jgE-yAVaJpbA9dukW_jifnMvHFn0nuVU8Q,2570
+agentprof/adapters/claude_code/prompts.py,sha256=sczOsGv2FOhOlrshsX-ef6KlVGSIOis0GN5IBWBZxTc,1962
+agentprof/adapters/claude_code/tools.py,sha256=CJ9Wo73OIT2Z1jHpnsvhnTS1ck6HbIt_Tp_EVneUM7Y,3388
+agentprof/adapters/claude_code/transcript.py,sha256=ksSAZU6TZDQth_KIIEOft13glzIuxDV9ABWyvWjWnX8,10173
+agentprof/adapters/claude_code/tree.py,sha256=SDxtQdBuXdjNMd9gQ6n8ifyRNb-uwKnr4HnD6UjTPrk,22418
+agentprof/adapters/codex/__init__.py,sha256=HzWqre-vj1Zcl3whvdQfRXlLnHSq946r9qVSD09hlSo,99
+agentprof/adapters/codex/adapter.py,sha256=dWVc_MrB8KQ8jMaYzZqf0DVYhbhxotOuBqmDKHMFnRg,6714
+agentprof/adapters/codex/discovery.py,sha256=IaKpfrZRX1k2cTIYVgG-kr5RY4vHlYLI-dRDItjt-fg,3889
+agentprof/adapters/codex/prompts.py,sha256=XLPAJu9tp2kuiaBHWt8duHNVe9AQ-Ajka4z1Xc_emiI,554
+agentprof/adapters/codex/rollout.py,sha256=2IgX76vEbeB-QpMufUL_nr9uawl07Y2DiAbUeOkzAfg,12023
+agentprof/adapters/codex/tools.py,sha256=FpE82AVteOsk711WjXL4u-kl1De2-1AIBBhEovxEaYA,3323
+agentprof/adapters/codex/tree.py,sha256=Zyg3EKggDdfoYsgfFTeToiHb6WqI6lFsW20hrY6w3yM,14141
+agentprof/adapters/copilot_vscode/__init__.py,sha256=1IPIb7oBlZLL5UlZB4y4POAS_mxXSHTaQGz7hzjSA_M,97
+agentprof/adapters/copilot_vscode/adapter.py,sha256=4kP5EkVAFhx8PQMazaoU8TxTcXulJvj-q-NtFyUtSd0,6928
+agentprof/adapters/copilot_vscode/debuglog.py,sha256=Ui7kIQOwpsmdF8-xeFMGZ0Sq-9JlUpOKK7xrt4c0rwM,5594
+agentprof/adapters/copilot_vscode/discovery.py,sha256=Opn5gX4Gq8p400DtF0fB0VVX1zDqk2ZHFfbvBnejJwQ,5995
+agentprof/adapters/copilot_vscode/session.py,sha256=8Zt29mNS51u2zDlTafWpH2g0Wgy5lcCgULRR18JvvEk,10468
+agentprof/adapters/copilot_vscode/tools.py,sha256=TDdl5BHiKtW7MCkIVZ52IejdocpZWlwyL7AgU5p2-KA,4931
+agentprof/adapters/copilot_vscode/transcript.py,sha256=fsFhZ4ON4i1tAGF59XTeHyAmcVaueu_eFWOly6LoVhQ,6782
+agentprof/adapters/copilot_vscode/tree.py,sha256=lva-ITYPpFR12Te0cD7BBkGvnzJ8crwWgl18wiOp1f8,13831
+agentprof/adapters/execution.py,sha256=vbK4n_mAN78cyM2_NIAOMJ-RGi94FzhL0Oo809BUoZM,2247
+agentprof/adapters/timestamps.py,sha256=C6ggBVR2spyChF9pZ-QIGR_gpAa5dzRzkuj95On6ULc,457
+agentprof/adapters/turns.py,sha256=o1Emtvedef38jl_5Sc-pfoJ-CvtSsxM0slOGjalvzGE,907
+agentprof/analysis/__init__.py,sha256=x05YC8fAqGW_NSAj7TCf2KuiYebGms0wVHpEC3Cak8k,122
+agentprof/analysis/agent_summary.py,sha256=n2_B-m9nRQnsaJTpaPdvEIa8v9Onwn7lmTgBiPKmKvc,6779
+agentprof/analysis/call_context.py,sha256=KZgBtzdJLwi7fT6eZJNEmrn8-mEZWYExqGS0gxYxMqk,4619
+agentprof/analysis/evidence_findings.py,sha256=strFEn7nlLc_fJLC3Pc4Z63SWXwomeeONE5cCS5HpeA,6640
+agentprof/analysis/execution.py,sha256=PpIELFqYwmxxa1fHXdWhxZe48dcQphXX7DXt_gIZyb0,1489
+agentprof/analysis/heuristics.py,sha256=6pJVK3T4b41of-SndTsLsI2k7YrfrqyQkvMeGI8hNNI,11893
+agentprof/analysis/pipeline.py,sha256=w5wWBX56LrhCBrvCcV-MIQylJcsG-iNIAi4K93UBkbk,1441
+agentprof/analysis/rollup.py,sha256=YGEHy0ciZzsSfKt6zlIBvONOnbh8iWNfcLLVNz9CawU,8112
+agentprof/cli.py,sha256=RVNqrORHhDd6UaFD4ljW60C88IWI9qwS_kiscenWvsU,5364
+agentprof/model.py,sha256=8JDQu0nnCrT5N4vOB8sYgVVSatHlqS7_kF-eaN2D7v4,11431
+agentprof/pricing.json,sha256=rYp_Grzm0ielGChOYHORFKOwDPOaIJ3VN4wo2KE1_LQ,1960
+agentprof/pricing.py,sha256=aLZNORP53tJnKuBLlNj51XhBP7rflMsWMM4Va1aVIgo,4387
+agentprof/registry.py,sha256=5-gcUol9O3KI-pAPB9sbPXqbVzpFM6o1vDWIGfmuYW0,11961
+agentprof/server/__init__.py,sha256=ZftUAuL2U2DgA-eaak38jUg2XGFvVSxOM4qtVHYCrLw,116
+agentprof/server/app.py,sha256=c85U6Xaio83l5ZyZVb2AyLcoWFm5afWKZeMbwglVKxE,16468
+agentprof/server/openapi.py,sha256=hdYRjwuZj4f_x_JUKWNdJRsfej_L9mwUIuoMVlRY30Q,845
+agentprof/server/pricing_schema.py,sha256=uegqC-p6R9irCSIx9JNv5zbO2LsacCw9b50weHtd8V8,1084
+agentprof/server/schemas.py,sha256=1mVZwhwuLcAtNeP-KRoHhtjQRlbIWLpLgFYKQqYrLtQ,17337
+agentprof/server/static/assets/index-C4HEqUVf.css,sha256=cu0pOXK94ia7zfpELeQ2QbZFfizyRpKyxhcyUkgekxE,221012
+agentprof/server/static/assets/index-ZsPn1H3d.js,sha256=HCUcrZW5a4ahj1_MQy9-F47Lz4QjhmdqK3AFRRX8AQs,768110
+agentprof/server/static/index.html,sha256=cykeXAqiJOwtPtlMno01xO7tptVcwGZ0m5vOLvkgKd4,427
+agentprof-0.1.0.dist-info/licenses/LICENSE,sha256=b7riK1squDxb3vrmVhNt7HWW3BtKkZv14m3YG0h08Yw,1065
+agentprof-0.1.0.dist-info/WHEEL,sha256=3iQx15CyXwGi4dbygedzA4M5T1eqO_SjwdPfUmqt2Cw,81
+agentprof-0.1.0.dist-info/entry_points.txt,sha256=NSdxaqSbNCwMrekCbB0Z1DWt0m9fycp_Axe-vZ8Tdjc,277
+agentprof-0.1.0.dist-info/METADATA,sha256=7wrw3G468FGAer5eyE18bMM_YUwl7NAlxv6g-hxhIWk,10121
+agentprof-0.1.0.dist-info/RECORD,,

agentprof-0.1.0.dist-info/WHEEL

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

agentprof-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,8 @@
+[console_scripts]
+agentprof = agentprof.cli:main
+
+[agentprof.adapters]
+claude-code = agentprof.adapters.claude_code.adapter:ClaudeCodeAdapter
+codex = agentprof.adapters.codex.adapter:CodexAdapter
+copilot-vscode = agentprof.adapters.copilot_vscode.adapter:CopilotVscodeAdapter
+

agentprof-0.1.0.dist-info/licenses/LICENSE

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