coding-agent-tools 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. coding_agent_tools-0.1.0/.gitignore +7 -0
  2. coding_agent_tools-0.1.0/PKG-INFO +107 -0
  3. coding_agent_tools-0.1.0/README.md +99 -0
  4. coding_agent_tools-0.1.0/coding_agent_tools/__init__.py +3 -0
  5. coding_agent_tools-0.1.0/coding_agent_tools/agent_usage.py +983 -0
  6. coding_agent_tools-0.1.0/coding_agent_tools/claude_sessions.py +783 -0
  7. coding_agent_tools-0.1.0/coding_agent_tools/codex_sessions.py +583 -0
  8. coding_agent_tools-0.1.0/coding_agent_tools/find_session.py +498 -0
  9. coding_agent_tools-0.1.0/coding_agent_tools/opencode_sessions.py +517 -0
  10. coding_agent_tools-0.1.0/pyproject.toml +23 -0
coding_agent_tools-0.1.0/.gitignore ADDED
@@ -0,0 +1,7 @@
1
+ __pycache__/
2
+ *.pyc
3
+ .pytest_cache/
4
+ .venv/
5
+ dist/
6
+ build/
7
+ *.egg-info/
coding_agent_tools-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,107 @@
1
+ Metadata-Version: 2.4
2
+ Name: coding-agent-tools
3
+ Version: 0.1.0
4
+ Summary: Session search and unified usage analytics for coding agents
5
+ Requires-Python: >=3.11
6
+ Requires-Dist: rich>=13.0.0
7
+ Description-Content-Type: text/markdown
8
+
9
+ # CodingAgentTools
10
+
11
+ `CodingAgentTools` is a focused toolbox for local AI coding workflows.
12
+
13
+ It currently ships two high-leverage commands:
14
+
15
+ - `find-session`: search and resume sessions across Claude Code, Codex, and OpenCode.
16
+ - `agent-usage`: unified usage + estimated cost reporting across Claude Code, Codex, OpenClaw, OpenCode, and OpenWhispr.
17
+
18
+ ## Why this repo exists
19
+
20
+ This repository consolidates tools that were previously split across multiple projects/scripts:
21
+
22
+ - `find-session` (now embedded here)
23
+ - local `allusage` script (now `agent-usage`)
24
+
25
+ The goal is one installable package, one docs surface, and one place for improvements.
26
+
27
+ ## Install
28
+
29
+ ```bash
30
+ uv tool install .
31
+ ```
32
+
33
+ or with pip:
34
+
35
+ ```bash
36
+ pip install .
37
+ ```
38
+
39
+ ## Command: find-session
40
+
41
+ Search and resume sessions across agents from one interface.
42
+
43
+ ```bash
44
+ # Search current project
45
+ find-session "auth,refactor"
46
+
47
+ # Search across all projects
48
+ find-session -g
49
+
50
+ # Limit to one agent
51
+ find-session "redis" --agents codex
52
+ ```
53
+
54
+ Supported agents:
55
+
56
+ - Claude Code (`~/.claude/projects/*.jsonl`)
57
+ - Codex (`~/.codex/sessions/**/rollout-*.jsonl`)
58
+ - OpenCode (`~/.local/share/opencode/opencode.db`)
59
+
60
+ ## Command: agent-usage
61
+
62
+ Show token usage and estimated USD-equivalent cost by period.
63
+
64
+ ```bash
65
+ # Daily usage for all sources
66
+ agent-usage
67
+
68
+ # Weekly with per-model breakdown
69
+ agent-usage weekly --breakdown
70
+
71
+ # Only OpenCode + Codex
72
+ agent-usage monthly opencode codex
73
+ ```
74
+
75
+ ### Sources and aliases
76
+
77
+ - `claude` / `cc`
78
+ - `codex` / `cx`
79
+ - `openclaw` / `oc` / `claw`
80
+ - `opencode` / `oe` / `code`
81
+ - `openwhispr` / `ow` / `whispr`
82
+
83
+ ### Pricing model
84
+
85
+ `agent-usage` estimates cost from token counts using live LiteLLM pricing metadata.
86
+
87
+ - If a source already reports non-zero cost, estimated pricing is still preferred when model pricing is available.
88
+ - This avoids misleading `0` totals for subscription-backed usage (for example OpenCode sessions routed through subscription plans).
89
+ - For models not present in the pricing registry, the tool falls back to observed/source-reported cost when available.
90
+
91
+ ## References
92
+
93
+ - `ccusage` (inspiration for usage/cost reporting style): https://github.com/ryoppippi/ccusage
94
+ - `claude-code-tools` (Cloud/Claude Code tools reference and prior consolidation work): https://github.com/charlesnchr/claude-code-tools
95
+ - LiteLLM model pricing registry: https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json
96
+
97
+ ## Development
98
+
99
+ ```bash
100
+ python3 -m pip install -e .
101
+ find-session --help
102
+ agent-usage --help
103
+ ```
104
+
105
+ ## License
106
+
107
+ MIT
coding_agent_tools-0.1.0/README.md ADDED
@@ -0,0 +1,99 @@
1
+ # CodingAgentTools
2
+
3
+ `CodingAgentTools` is a focused toolbox for local AI coding workflows.
4
+
5
+ It currently ships two high-leverage commands:
6
+
7
+ - `find-session`: search and resume sessions across Claude Code, Codex, and OpenCode.
8
+ - `agent-usage`: unified usage + estimated cost reporting across Claude Code, Codex, OpenClaw, OpenCode, and OpenWhispr.
9
+
10
+ ## Why this repo exists
11
+
12
+ This repository consolidates tools that were previously split across multiple projects/scripts:
13
+
14
+ - `find-session` (now embedded here)
15
+ - local `allusage` script (now `agent-usage`)
16
+
17
+ The goal is one installable package, one docs surface, and one place for improvements.
18
+
19
+ ## Install
20
+
21
+ ```bash
22
+ uv tool install .
23
+ ```
24
+
25
+ or with pip:
26
+
27
+ ```bash
28
+ pip install .
29
+ ```
30
+
31
+ ## Command: find-session
32
+
33
+ Search and resume sessions across agents from one interface.
34
+
35
+ ```bash
36
+ # Search current project
37
+ find-session "auth,refactor"
38
+
39
+ # Search across all projects
40
+ find-session -g
41
+
42
+ # Limit to one agent
43
+ find-session "redis" --agents codex
44
+ ```
45
+
46
+ Supported agents:
47
+
48
+ - Claude Code (`~/.claude/projects/*.jsonl`)
49
+ - Codex (`~/.codex/sessions/**/rollout-*.jsonl`)
50
+ - OpenCode (`~/.local/share/opencode/opencode.db`)
51
+
52
+ ## Command: agent-usage
53
+
54
+ Show token usage and estimated USD-equivalent cost by period.
55
+
56
+ ```bash
57
+ # Daily usage for all sources
58
+ agent-usage
59
+
60
+ # Weekly with per-model breakdown
61
+ agent-usage weekly --breakdown
62
+
63
+ # Only OpenCode + Codex
64
+ agent-usage monthly opencode codex
65
+ ```
66
+
67
+ ### Sources and aliases
68
+
69
+ - `claude` / `cc`
70
+ - `codex` / `cx`
71
+ - `openclaw` / `oc` / `claw`
72
+ - `opencode` / `oe` / `code`
73
+ - `openwhispr` / `ow` / `whispr`
74
+
75
+ ### Pricing model
76
+
77
+ `agent-usage` estimates cost from token counts using live LiteLLM pricing metadata.
78
+
79
+ - If a source already reports non-zero cost, estimated pricing is still preferred when model pricing is available.
80
+ - This avoids misleading `0` totals for subscription-backed usage (for example OpenCode sessions routed through subscription plans).
81
+ - For models not present in the pricing registry, the tool falls back to observed/source-reported cost when available.
82
+
83
+ ## References
84
+
85
+ - `ccusage` (inspiration for usage/cost reporting style): https://github.com/ryoppippi/ccusage
86
+ - `claude-code-tools` (Cloud/Claude Code tools reference and prior consolidation work): https://github.com/charlesnchr/claude-code-tools
87
+ - LiteLLM model pricing registry: https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json
88
+
89
+ ## Development
90
+
91
+ ```bash
92
+ python3 -m pip install -e .
93
+ find-session --help
94
+ agent-usage --help
95
+ ```
96
+
97
+ ## License
98
+
99
+ MIT
coding_agent_tools-0.1.0/coding_agent_tools/__init__.py ADDED
@@ -0,0 +1,3 @@
1
+ """CodingAgentTools package."""
2
+
3
+ __version__ = "0.1.0"