copilot-session-usage 0.2.2__tar.gz → 0.2.3__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 (99) hide show
  1. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/PKG-INFO +2 -2
  2. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/README.md +1 -1
  3. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/conf.py +5 -0
  4. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/index.md +4 -0
  5. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/tutorials/getting-started.md +24 -11
  6. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.editorconfig +0 -0
  7. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  8. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  9. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/guidelines/knowledge-base.guidelines.md +0 -0
  10. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/pull_request_template.md +0 -0
  11. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/skills/consolidate-knowledge-base/SKILL.md +0 -0
  12. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/skills/record-finding/SKILL.md +0 -0
  13. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/workflows/ci.yml +0 -0
  14. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.github/workflows/publish.yml +0 -0
  15. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.gitignore +0 -0
  16. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/.readthedocs.yaml +0 -0
  17. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/AGENTS.md +0 -0
  18. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/CHANGELOG.md +0 -0
  19. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/CONTRIBUTING.md +0 -0
  20. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/LICENSE +0 -0
  21. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/_static/changelog.js +0 -0
  22. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/_static/custom.css +0 -0
  23. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/changelog.md +0 -0
  24. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/explanation/how-cost-estimation-works.md +0 -0
  25. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/explanation/index.md +0 -0
  26. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/how-to/analyze-specific-session.md +0 -0
  27. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/how-to/batch-and-spending.md +0 -0
  28. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/how-to/export-json.md +0 -0
  29. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/how-to/index.md +0 -0
  30. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/how-to/wsl2.md +0 -0
  31. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/installation.md +0 -0
  32. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/reference/api.md +0 -0
  33. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/reference/cli.md +0 -0
  34. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/reference/index.md +0 -0
  35. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/reference/pricing.md +0 -0
  36. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/tutorials/index.md +0 -0
  37. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/justfile +0 -0
  38. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Base.schema.yaml +0 -0
  39. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Concept.schema.yaml +0 -0
  40. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Experiment.schema.yaml +0 -0
  41. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Finding.schema.yaml +0 -0
  42. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Playbook.schema.yaml +0 -0
  43. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Principle.schema.yaml +0 -0
  44. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Reference.schema.yaml +0 -0
  45. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/_schema/Structure.schema.yaml +0 -0
  46. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/concepts/copilot-cli.md +0 -0
  47. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/concepts/index.md +0 -0
  48. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/concepts/overview.md +0 -0
  49. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/concepts/session-cost-analysis.md +0 -0
  50. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/concepts/threshold-based-pricing.md +0 -0
  51. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/experiments/index.md +0 -0
  52. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/experiments/verify-subagent-cost-attribution.md +0 -0
  53. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/findings/cache-write-cost-not-tracked.md +0 -0
  54. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/findings/index.md +0 -0
  55. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/findings/subagent-logs-use-runsubagent-prefix.md +0 -0
  56. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/findings/title-jsonl-not-counted-as-model-turn.md +0 -0
  57. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/guides/automation-scripts.md +0 -0
  58. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/guides/cost-optimization.md +0 -0
  59. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/guides/index.md +0 -0
  60. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/guides/wsl2-setup.md +0 -0
  61. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/ideas/index.md +0 -0
  62. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/ideas/multi-session-efficiency-analytics.md +0 -0
  63. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/index.md +0 -0
  64. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/log.md +0 -0
  65. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/principles/findings-are-immutable.md +0 -0
  66. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/principles/index.md +0 -0
  67. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/reference/debug-log-format.md +0 -0
  68. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/reference/index.md +0 -0
  69. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/reference/pricing-formats.md +0 -0
  70. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/structures/cache-cost-approximation.md +0 -0
  71. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/structures/index.md +0 -0
  72. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/structures/knowledge-base-information-types.md +0 -0
  73. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/structures/session-discovery-algorithm.md +0 -0
  74. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/structures/subagent-cost-tracking.md +0 -0
  75. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/knowledge/structures/vscode-copilot-extension.md +0 -0
  76. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/pyproject.toml +0 -0
  77. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/scripts/refresh_pricing.py +0 -0
  78. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/skills/copilot-session-usage/SKILL.md +0 -0
  79. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/__init__.py +0 -0
  80. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/_internal/__init__.py +0 -0
  81. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/_internal/copilot_cli.py +0 -0
  82. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/_internal/core.py +0 -0
  83. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/_internal/vscode.py +0 -0
  84. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/api.py +0 -0
  85. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/cli.py +0 -0
  86. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/data/__init__.py +0 -0
  87. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/data/custom-models-pricing.yml +0 -0
  88. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/data/models-and-pricing.lock +0 -0
  89. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/src/copilot_session_usage/data/models-and-pricing.yml +0 -0
  90. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/conftest.py +0 -0
  91. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_api.py +0 -0
  92. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_cli.py +0 -0
  93. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_core.py +0 -0
  94. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_coverage_gaps.py +0 -0
  95. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_rendering.py +0 -0
  96. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_vscode.py +0 -0
  97. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/tests/test_vscode_platform.py +0 -0
  98. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/uv.lock +0 -0
  99. {copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/uv.toml +0 -0
{copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: copilot-session-usage
3
- Version: 0.2.2
3
+ Version: 0.2.3
4
4
  Summary: Usage and cost analytics for GitHub Copilot and Copilot-CLI session logs
5
5
  Project-URL: Homepage, https://github.com/gsemet/copilot-session-usage
6
6
  Project-URL: Documentation, https://copilot-session-usage.readthedocs.io/en/stable/
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
27
27
 
28
28
  Extract VS Code Copilot session cost KPIs (tokens, estimated USD, model, duration) from local debug logs.
29
29
 
30
- **Full documentation:** [copilot-session-usage.readthedocs.io](https://copilot-session-usage.readthedocs.io/)
30
+ **Full documentation:** [copilot-session-usage.readthedocs.io](https://copilot-session-usage.readthedocs.io/en/stable/)
31
31
 
32
32
  ## Installation
33
33
 
{copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/README.md RENAMED
@@ -11,7 +11,7 @@
11
11
 
12
12
  Extract VS Code Copilot session cost KPIs (tokens, estimated USD, model, duration) from local debug logs.
13
13
 
14
- **Full documentation:** [copilot-session-usage.readthedocs.io](https://copilot-session-usage.readthedocs.io/)
14
+ **Full documentation:** [copilot-session-usage.readthedocs.io](https://copilot-session-usage.readthedocs.io/en/stable/)
15
15
 
16
16
  ## Installation
17
17
 
{copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/conf.py RENAMED
@@ -24,6 +24,11 @@ extensions = [
24
24
  myst_enable_extensions = ["colon_fence", "deflist"]
25
25
 
26
26
  html_theme = "furo"
27
+ html_theme_options = {
28
+ "source_repository": "https://github.com/gsemet/copilot-session-usage",
29
+ "source_branch": "main",
30
+ "source_directory": "docs/source/",
31
+ }
27
32
  html_title = f"copilot-session-usage {version}"
28
33
  html_static_path = ["_static"]
29
34
  html_css_files = ["custom.css"]
{copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/index.md RENAMED
@@ -1,5 +1,7 @@
1
1
  # copilot-session-usage
2
2
 
3
+ [![GitHub](https://img.shields.io/badge/GitHub-copilot--session--usage-181717?logo=github)](https://github.com/gsemet/copilot-session-usage)
4
+
3
5
  **copilot-session-usage** reads VS Code Copilot debug logs and tells you
4
6
  how much each AI coding session cost in USD.
5
7
 
@@ -11,6 +13,8 @@ prints a cost report in seconds.
11
13
  The most common use: after a heavy agentic session, run
12
14
  `copilot-session-usage latest` to see what it cost.
13
15
 
16
+ Links to source code: [gsemet/copilot-session-usage](https://github.com/gsemet/copilot-session-usage)
17
+
14
18
  ::::{grid} 1 1 2 2
15
19
  :gutter: 3
16
20
 
{copilot_session_usage-0.2.2 → copilot_session_usage-0.2.3}/docs/source/tutorials/getting-started.md RENAMED
@@ -11,7 +11,7 @@ output. It assumes you have installed `copilot-session-usage` — see
11
11
  Run this after any VS Code Copilot chat session:
12
12
 
13
13
  ```bash
14
- copilot-session-usage latest
14
+ copilot-session-usage latest --format table
15
15
  ```
16
16
 
17
17
  Sample output:
@@ -41,19 +41,16 @@ Each field:
41
41
 
42
42
  ---
43
43
 
44
- ## Switch detail levels
44
+ ## Details Tables
45
45
 
46
- `--detail` controls how much data is shown:
46
+ `--format` controls the output type. Default is `json`:
47
47
 
48
48
  ```bash
49
49
  # Just cost and model names
50
- copilot-session-usage latest --detail minimal
50
+ copilot-session-usage latest --format table
51
51
 
52
- # Default: summary + per-model breakdown
53
- copilot-session-usage latest --detail compact
54
-
55
- # Everything: per-model + subagent attribution
56
- copilot-session-usage latest --detail full
52
+ # Default: summary + per-subagent breakdown
53
+ copilot-session-usage latest --format detailed
57
54
  ```
58
55
 
59
56
  ---
@@ -76,10 +73,16 @@ copilot-session-usage latest --format json --output session.json
76
73
 
77
74
  ## List recent sessions
78
75
 
79
- See which sessions exist without computing costs:
76
+ See which sessions exist without computing costs (limit set to 20 by default):
80
77
 
81
78
  ```bash
82
79
  copilot-session-usage list
80
+
81
+ # Limit to 5 sessions
82
+ copilot-session-usage list --limit 5
83
+
84
+ # Since a date
85
+ copilot-session-usage list --since 2026-07-01
83
86
  ```
84
87
 
85
88
  Output:
@@ -106,7 +109,14 @@ it lists them so you can pick the right UUID.
106
109
  ## Analyze a specific session by UUID
107
110
 
108
111
  ```bash
112
+ # Default json output
109
113
  copilot-session-usage id f5cbde8a-ec40-466f-86e6-f95c343b6c58
114
+
115
+ # Human readable summary
116
+ copilot-session-usage id f5cbde8a-ec40-466f-86e6-f95c343b6c58 --format table
117
+
118
+ # Human readable details with per-subagent breakdown
119
+ copilot-session-usage id f5cbde8a-ec40-466f-86e6-f95c343b6c58 --format detailed
110
120
  ```
111
121
 
112
122
  ---
@@ -114,8 +124,11 @@ copilot-session-usage id f5cbde8a-ec40-466f-86e6-f95c343b6c58
114
124
  ## Analyze multiple sessions at once
115
125
 
116
126
  ```bash
117
- # Last 10 sessions
127
+ # Last 10 sessions (json output)
118
128
  copilot-session-usage batch 10
129
+
130
+ # Summary table for last 10 sessions
131
+ copilot-session-usage batch 10 --format table
119
132
  ```
120
133
 
121
134
  Output includes a summary row with aggregate totals and a per-session table.