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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cli-consumption
-Version: 0.0.4
+Version: 0.0.6
 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, OpenCode, and the core Claude Code local transcript format are supported. Kilo
-Code and Pi are planned behind the same provider-neutral adapter contract.
+Codex, Kilo Code, Pi, OpenCode, and the core Claude Code local transcript format are
+supported.
 
 The collector deliberately excludes prompts, responses, tool arguments, and
 credentials. See [Privacy](docs/privacy.md) before sharing a database or export.
@@ -108,6 +108,18 @@ Select OpenCode to read `~/.local/share/opencode/opencode.db` instead:
 uv run cli-consumption collect --provider opencode --database usage.sqlite
 ```
 
+Select Kilo Code to read `~/.local/share/kilo/kilo.db` instead:
+
+```bash
+uv run cli-consumption collect --provider kilo --database usage.sqlite
+```
+
+Select Pi to read `~/.pi/agent/sessions/` instead:
+
+```bash
+uv run cli-consumption collect --provider pi --database usage.sqlite
+```
+
 Use `all` to detect and collect every supported provider present on the machine:
 
 ```bash
@@ -156,6 +168,22 @@ uv run cli-consumption collect --provider opencode \
   --source laptop=/data/opencode/laptop
 ```
 
+Copied Kilo Code sources point to the data directory containing `kilo.db`:
+
+```bash
+uv run cli-consumption collect --provider kilo \
+  --source desktop=/data/kilo/desktop \
+  --source laptop=/data/kilo/laptop
+```
+
+Copied Pi sources point to the agent directory containing `sessions/`:
+
+```bash
+uv run cli-consumption collect --provider pi \
+  --source desktop=/data/pi/desktop \
+  --source laptop=/data/pi/laptop
+```
+
 ## SQLite and PostgreSQL
 
 A file path selects SQLite. A SQLAlchemy URL selects PostgreSQL:

{cli_consumption-0.0.4 → cli_consumption-0.0.6}/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, OpenCode, and the core Claude Code local transcript format are supported. Kilo
-Code and Pi are planned behind the same provider-neutral adapter contract.
+Codex, Kilo Code, Pi, OpenCode, and the core Claude Code local transcript format are
+supported.
 
 The collector deliberately excludes prompts, responses, tool arguments, and
 credentials. See [Privacy](docs/privacy.md) before sharing a database or export.
@@ -80,6 +80,18 @@ Select OpenCode to read `~/.local/share/opencode/opencode.db` instead:
 uv run cli-consumption collect --provider opencode --database usage.sqlite
 ```
 
+Select Kilo Code to read `~/.local/share/kilo/kilo.db` instead:
+
+```bash
+uv run cli-consumption collect --provider kilo --database usage.sqlite
+```
+
+Select Pi to read `~/.pi/agent/sessions/` instead:
+
+```bash
+uv run cli-consumption collect --provider pi --database usage.sqlite
+```
+
 Use `all` to detect and collect every supported provider present on the machine:
 
 ```bash
@@ -128,6 +140,22 @@ uv run cli-consumption collect --provider opencode \
   --source laptop=/data/opencode/laptop
 ```
 
+Copied Kilo Code sources point to the data directory containing `kilo.db`:
+
+```bash
+uv run cli-consumption collect --provider kilo \
+  --source desktop=/data/kilo/desktop \
+  --source laptop=/data/kilo/laptop
+```
+
+Copied Pi sources point to the agent directory containing `sessions/`:
+
+```bash
+uv run cli-consumption collect --provider pi \
+  --source desktop=/data/pi/desktop \
+  --source laptop=/data/pi/laptop
+```
+
 ## SQLite and PostgreSQL
 
 A file path selects SQLite. A SQLAlchemy URL selects PostgreSQL:

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

@@ -16,8 +16,9 @@ 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 exposes the complete analytics contract; Claude Code and
-  OpenCode expose the core dimensions available in their local stores.
+  work-item intervals. Codex exposes the complete analytics contract; Claude Code,
+  Kilo Code, OpenCode, and Pi 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 → cli_consumption-0.0.6}/docs/provider-support.md

@@ -4,9 +4,9 @@
 | --- | --- | --- |
 | Codex | Supported | Local rollout JSONL and optional metadata-only subagent state |
 | Claude Code | Supported (core) | Local project transcript JSONL |
+| Kilo Code | Supported (core) | Local SQLite session store |
 | OpenCode | Supported (core) | Local SQLite v2 session store |
-| Kilo Code | Planned | To be verified before implementation |
-| Pi | Planned | To be verified before implementation |
+| Pi | Supported (core) | Local session JSONL v1-v3 |
 
 “Supported” means the adapter has synthetic fixtures, extracts conversations, turns,
 models, token usage, and tool names when available, and passes privacy regression tests.
@@ -49,6 +49,37 @@ components. The adapter does not currently read pre-v2 JSON storage, legacy
 provider-reported cost. The SQLite schema is internal and may change without notice;
 local token events are not billing data.
 
+Kilo Code reads `kilo.db` from its data directory (normally
+`~/.local/share/kilo/`). The adapter was qualified against Kilo Code CLI v7.5.5 and
+the matching current `session`, `message`, and `part` schema. It extracts user turns,
+assistant model calls, model references, token usage, tool names, and compaction parts
+while discarding titles, prompts, responses, reasoning, tool inputs/results, commands,
+errors, paths, diffs, costs, snapshots, and arbitrary metadata.
+
+Kilo Code 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 read the legacy IDE extension's task files, cloud-only
+sessions, `session_message` queue records, child-session relationships, context-window
+sizes, costs, snapshots, or provider-reported generation metrics. `KILO_DB` can select
+a non-default database, which must be passed explicitly with `--source`. Kilo Code's
+SQLite schema can change without notice, and its local token events are not billing
+data.
+
+Pi reads session JSONL files under `~/.pi/agent/sessions/` (or copied agent
+directories). It extracts user turns, assistant and compaction model calls, provider
+and model identifiers, token usage, tool names, thinking-level changes, and compaction
+timestamps while discarding prompts, responses, thinking, tool arguments/results,
+commands/output, summaries, errors, costs, paths, extension data, and arbitrary
+metadata. All persisted branches are counted because Pi retains branch history in the
+same session file.
+
+Pi reports uncached input, cache reads, cache writes, output, and optional reasoning
+tokens. Normalized input includes all three input components; reasoning is retained as
+a subset of output rather than added twice. This adapter does not collect custom
+session directories automatically, context-window sizes, costs, branch relationships,
+or provider-reported durations. Pi's JSONL schema can change without notice, and its
+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.4 → cli_consumption-0.0.6}/docs/roadmap.md

@@ -4,6 +4,8 @@
 
 - Complete Codex local collector
 - Core Claude Code local transcript collector
+- Core Pi local session collector
+- Core Kilo Code local SQLite collector
 - Offline multi-machine deduplication
 - SQLite and PostgreSQL storage
 - Metadata-only central collection API
@@ -14,8 +16,7 @@
 
 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
+3. Add cross-provider comparison views once at least two adapters expose reliable model
    and token dimensions.
 
 ## Later operational work

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

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

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

@@ -0,0 +1,13 @@
+from cli_consumption.adapters.claude import ClaudeAdapter
+from cli_consumption.adapters.codex import CodexAdapter
+from cli_consumption.adapters.kilo import KiloAdapter
+from cli_consumption.adapters.opencode import OpenCodeAdapter
+from cli_consumption.adapters.pi import PiAdapter
+
+__all__ = [
+    "ClaudeAdapter",
+    "CodexAdapter",
+    "KiloAdapter",
+    "OpenCodeAdapter",
+    "PiAdapter",
+]