cli-consumption 0.0.2__tar.gz → 0.0.4__tar.gz

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/.agents/skills/yolo/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: yolo
-description: Publish the current Codex work in a GitHub pull request, squash-merge it, then clean up its local and remote branches. Use only when the user explicitly invokes `$yolo` or requests the full publish, merge, and cleanup sequence.
+description: Publish the current Codex work in a GitHub pull request, squash-merge it, then clean up its local and remote branches without additional approval prompts. Use only when the user explicitly invokes `$yolo` or requests the full publish, merge, and cleanup sequence.
 ---
 
 # Publish, merge, and clean up
 
-Run each phase in order from the repository root. The implicit pull request is the one for the current Codex work and current branch.
+Run each phase in order from the repository root. The implicit pull request is the one for the current Codex work and current branch. Treat the explicit `$yolo` invocation as advance approval to push, create or ready the pull request, squash-merge it, and delete its exact source branch. Do not pause for additional confirmation during a successful, unambiguous run.
 
 ## 1. Publish
 
 1. Read all repository instructions and the product specification referenced by `AGENTS.md`.
-2. Load and follow `$yeet-github` in full to inspect, validate, commit, push, and open a draft pull request.
+2. Load and follow `$yeet-github` in full to inspect, validate, commit, push, and open a draft pull request, except do not request its approval before pushing or publishing: the explicit `$yolo` invocation already provides that approval.
 3. Retain the exact source and target branches, pushed SHA, pull-request number, and URL.
 4. Stop after any failure or ambiguous external result. Never merge or clean up after a partial failure.
 
@@ -21,8 +21,8 @@ Run each phase in order from the repository root. The implicit pull request is t
 3. Inspect required checks, reviews, conversations, and protections with `gh pr checks` and `gh pr view --json mergeStateStatus,reviewDecision,statusCheckRollup`.
 4. Mark a ready draft with `gh pr ready <number>`.
 5. Watch pending checks with `gh pr checks <number> --watch --interval 10`; stop and report any failing check.
-6. Present the final state and obtain explicit approval immediately before merging and deleting branches.
-7. After approval, use `gh pr merge <number> --squash --delete-branch --match-head-commit <source-sha>`.
+6. Present the verified final state as a progress update, then continue without requesting approval.
+7. Use `gh pr merge <number> --squash --delete-branch --match-head-commit <source-sha>`.
 8. If GitHub queues the merge, keep monitoring. Clean up only after `gh pr view <number> --json state,mergedAt,mergeCommit` reports `MERGED`.
 
 ## 3. Clean up
@@ -32,7 +32,7 @@ Run each phase in order from the repository root. The implicit pull request is t
 3. Run `git fetch --prune origin`.
 4. Switch to the target branch and update it only by fast-forward with `git switch <target-branch>` and `git pull --ff-only origin <target-branch>`.
 5. Delete the exact local source branch if it remains. `git branch -D <source-branch>` is allowed only after verified squash merge.
-6. If the unprotected remote branch remains, obtain fresh explicit approval before `git push origin --delete <source-branch>`.
+6. If the exact unprotected remote source branch remains, delete it with `git push origin --delete <source-branch>` without requesting additional approval.
 7. Run `git status --short --branch` and report the final state.
 
 ## Guardrails

cli_consumption-0.0.4/.agents/skills/yolo/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Yolo GitHub"
+  short_description: "Publish, squash-merge, and clean up without prompts"
+  default_prompt: "Use $yolo to publish, squash-merge, and clean up the current GitHub work without additional approval prompts."

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/.github/workflows/ci.yml

@@ -12,8 +12,8 @@ jobs:
   quality:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v10.0.1
         with:
           enable-cache: true
           python-version: "3.14"

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/.github/workflows/release.yaml

@@ -25,7 +25,7 @@ jobs:
       release-sha: ${{ steps.version.outputs.release-sha }}
       version: ${{ steps.version.outputs.version }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7.0.1
         with:
           fetch-depth: 0
           ref: ${{ inputs.release_sha || github.sha }}
@@ -77,10 +77,10 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7.0.1
         with:
           ref: ${{ needs.detect-version.outputs.release-sha }}
-      - uses: astral-sh/setup-uv@v6
+      - uses: astral-sh/setup-uv@v10.0.1
         with:
           enable-cache: true
           python-version: "3.14"
@@ -92,7 +92,7 @@ jobs:
       - run: uv run pytest --cov --cov-report=term-missing
       - run: uv build
       - name: Upload distributions
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: python-package-distributions
           path: dist/
@@ -105,7 +105,7 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7.0.1
         with:
           fetch-depth: 0
           ref: ${{ needs.detect-version.outputs.release-sha }}
@@ -141,7 +141,7 @@ jobs:
       id-token: write
     steps:
       - name: Download distributions
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8.0.1
         with:
           name: python-package-distributions
           path: dist/

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cli-consumption
-Version: 0.0.2
+Version: 0.0.4
 Summary: Analyze and consolidate AI coding CLI consumption across machines.
 Project-URL: Homepage, https://github.com/Guillaume-Lombardo/cli-consumption
 Project-URL: Documentation, https://github.com/Guillaume-Lombardo/cli-consumption#readme
@@ -33,8 +33,8 @@ models, tokens, tools, conversations, and turns. It can analyze one workstation,
 consolidate copied data from several machines, or send metadata-only snapshots to a
 central collector.
 
-Codex is fully supported. Claude Code, OpenCode, Kilo Code, and Pi are planned behind
-the same provider-neutral adapter contract.
+Codex, OpenCode, and the core Claude Code local transcript format are supported. Kilo
+Code and Pi are planned behind the same provider-neutral adapter contract.
 
 The collector deliberately excludes prompts, responses, tool arguments, and
 credentials. See [Privacy](docs/privacy.md) before sharing a database or export.
@@ -96,6 +96,28 @@ hostname:
 uv run cli-consumption collect --database usage.sqlite
 ```
 
+Select Claude Code to read `~/.claude/projects/` instead:
+
+```bash
+uv run cli-consumption collect --provider claude --database usage.sqlite
+```
+
+Select OpenCode to read `~/.local/share/opencode/opencode.db` instead:
+
+```bash
+uv run cli-consumption collect --provider opencode --database usage.sqlite
+```
+
+Use `all` to detect and collect every supported provider present on the machine:
+
+```bash
+uv run cli-consumption collect --provider all --database usage.sqlite
+```
+
+With explicit copied sources, each path is inspected for the provider-specific
+`sessions/` or `projects/` directory. Sources that contain no supported provider data
+are rejected instead of silently skipped.
+
 For an offline multi-machine workflow, copy only each machine's Codex `sessions/`
 directory into a trusted analysis location. Do not copy `auth.json` or other
 credentials. Then repeat `--source`:
@@ -118,6 +140,22 @@ uv run cli-consumption collect \
   --project cli-consumption=/home/me/dev/cli-consumption
 ```
 
+Copied Claude Code sources point to the configuration directory containing `projects/`:
+
+```bash
+uv run cli-consumption collect --provider claude \
+  --source desktop=/data/claude/desktop \
+  --source laptop=/data/claude/laptop
+```
+
+Copied OpenCode sources point to the data directory containing `opencode.db`:
+
+```bash
+uv run cli-consumption collect --provider opencode \
+  --source desktop=/data/opencode/desktop \
+  --source laptop=/data/opencode/laptop
+```
+
 ## SQLite and PostgreSQL
 
 A file path selects SQLite. A SQLAlchemy URL selects PostgreSQL:

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/README.md

@@ -5,8 +5,8 @@ models, tokens, tools, conversations, and turns. It can analyze one workstation,
 consolidate copied data from several machines, or send metadata-only snapshots to a
 central collector.
 
-Codex is fully supported. Claude Code, OpenCode, Kilo Code, and Pi are planned behind
-the same provider-neutral adapter contract.
+Codex, OpenCode, and the core Claude Code local transcript format are supported. Kilo
+Code and Pi are planned behind the same provider-neutral adapter contract.
 
 The collector deliberately excludes prompts, responses, tool arguments, and
 credentials. See [Privacy](docs/privacy.md) before sharing a database or export.
@@ -68,6 +68,28 @@ hostname:
 uv run cli-consumption collect --database usage.sqlite
 ```
 
+Select Claude Code to read `~/.claude/projects/` instead:
+
+```bash
+uv run cli-consumption collect --provider claude --database usage.sqlite
+```
+
+Select OpenCode to read `~/.local/share/opencode/opencode.db` instead:
+
+```bash
+uv run cli-consumption collect --provider opencode --database usage.sqlite
+```
+
+Use `all` to detect and collect every supported provider present on the machine:
+
+```bash
+uv run cli-consumption collect --provider all --database usage.sqlite
+```
+
+With explicit copied sources, each path is inspected for the provider-specific
+`sessions/` or `projects/` directory. Sources that contain no supported provider data
+are rejected instead of silently skipped.
+
 For an offline multi-machine workflow, copy only each machine's Codex `sessions/`
 directory into a trusted analysis location. Do not copy `auth.json` or other
 credentials. Then repeat `--source`:
@@ -90,6 +112,22 @@ uv run cli-consumption collect \
   --project cli-consumption=/home/me/dev/cli-consumption
 ```
 
+Copied Claude Code sources point to the configuration directory containing `projects/`:
+
+```bash
+uv run cli-consumption collect --provider claude \
+  --source desktop=/data/claude/desktop \
+  --source laptop=/data/claude/laptop
+```
+
+Copied OpenCode sources point to the data directory containing `opencode.db`:
+
+```bash
+uv run cli-consumption collect --provider opencode \
+  --source desktop=/data/opencode/desktop \
+  --source laptop=/data/opencode/laptop
+```
+
 ## SQLite and PostgreSQL
 
 A file path selects SQLite. A SQLAlchemy URL selects PostgreSQL:

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/docs/architecture.md

@@ -16,7 +16,8 @@ provider files -> adapter -> metadata-only snapshot -> SQL storage -> dashboard/
 
 - `adapters`: parse a CLI's local data into conversations, turns, model calls, tool
   calls, context-pressure samples, bounded turn settings, compactions, and content-free
-  work-item intervals. Codex is the first complete implementation.
+  work-item intervals. Codex exposes the complete analytics contract; Claude Code and
+  OpenCode expose the core dimensions available in their local stores.
 - `models`: define the transport boundary shared by offline and API ingestion.
 - `storage`: owns the normalized schema, idempotent replacement rules, SQLite, and
   PostgreSQL engine creation.

cli_consumption-0.0.4/docs/provider-support.md

@@ -0,0 +1,54 @@
+# Provider support
+
+| Provider | Status | Initial source |
+| --- | --- | --- |
+| Codex | Supported | Local rollout JSONL and optional metadata-only subagent state |
+| Claude Code | Supported (core) | Local project transcript JSONL |
+| OpenCode | Supported (core) | Local SQLite v2 session store |
+| Kilo Code | Planned | To be verified before implementation |
+| Pi | Planned | To be verified before implementation |
+
+“Supported” means the adapter has synthetic fixtures, extracts conversations, turns,
+models, token usage, and tool names when available, and passes privacy regression tests.
+It does not mean that token counters are equivalent to invoices.
+
+`--provider all` detects every supported provider from its expected data directory and
+ingests each metadata-only snapshot independently. With no explicit source it checks
+the local default homes; repeated `--source` paths are filtered by detected format.
+
+Codex additionally exposes provider-reported turn duration and TTFT, model context
+window samples, bounded reasoning/collaboration/service-tier labels, timestamped
+compactions, technical work-item categories and durations, and local thread-spawn
+relationships. Work-item content and rate-limit payloads are deliberately excluded.
+Subagent state can remain `open` after a child thread is technically closed; reporting
+therefore derives closure from collected child turns when they are available.
+
+Claude Code reads top-level sessions from
+`~/.claude/projects/<project>/<session-id>.jsonl` (or `CLAUDE_CONFIG_DIR`). It extracts
+main-session turns, models, token usage, tool names, and compaction timestamps while
+discarding prompts, responses, tool inputs/results, paths, branches, and arbitrary
+metadata. Streaming fragments are deduplicated by request or message identifier.
+
+Claude Code emits uncached, cache-read, and cache-creation input separately. Normalized
+`input_tokens` is their sum, with each component retained in its corresponding field.
+The internal transcript schema can change between Claude Code releases and local usage
+is not billing data. This first increment does not collect subagent transcripts,
+context-window sizes, effort/service-tier settings, TTFT, provider-reported duration,
+or technical work-item intervals.
+
+OpenCode reads `opencode.db` from its XDG data directory (normally
+`~/.local/share/opencode/`). It extracts v2 session messages, model references, token
+usage, tool names, and compaction timestamps while discarding message text, reasoning,
+tool inputs/results, shell commands/output, paths, titles, errors, costs, and arbitrary
+metadata. Model labels combine OpenCode's provider and model identifiers.
+
+OpenCode reports uncached input, cache reads, cache writes, visible output, and
+reasoning separately. Normalized input and output totals include their respective
+components. The adapter does not currently read pre-v2 JSON storage, legacy
+`message`/`part` tables, child-session relationships, context-window sizes, or
+provider-reported cost. The SQLite schema is internal and may change without notice;
+local token events are not billing data.
+
+Provider formats can change without notice. Unknown fields are ignored; malformed
+provider records are counted and skipped. Compatibility fixes should add a fixture for
+both the old and new format whenever possible.

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/docs/roadmap.md

@@ -3,6 +3,7 @@
 ## Current foundation
 
 - Complete Codex local collector
+- Core Claude Code local transcript collector
 - Offline multi-machine deduplication
 - SQLite and PostgreSQL storage
 - Metadata-only central collection API
@@ -11,7 +12,7 @@
 
 ## Next provider increments
 
-1. Validate Claude Code's local and endpoint formats, then add its adapter.
+1. Extend Claude Code support only where local metadata has reliable semantics.
 2. Add OpenCode with the same normalized contract.
 3. Add Kilo Code and Pi after format and licensing review.
 4. Add cross-provider comparison views once at least two adapters expose reliable model

{cli_consumption-0.0.2 → cli_consumption-0.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cli-consumption"
-version = "0.0.2"
+version = "0.0.4"
 description = "Analyze and consolidate AI coding CLI consumption across machines."
 readme = "README.md"
 requires-python = ">=3.14"

cli_consumption-0.0.4/src/cli_consumption/adapters/__init__.py

@@ -0,0 +1,5 @@
+from cli_consumption.adapters.claude import ClaudeAdapter
+from cli_consumption.adapters.codex import CodexAdapter
+from cli_consumption.adapters.opencode import OpenCodeAdapter
+
+__all__ = ["ClaudeAdapter", "CodexAdapter", "OpenCodeAdapter"]