agent-usage-tracker 0.1.0__tar.gz → 0.2.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.
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/CONTRACT.md +19 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/PKG-INFO +46 -2
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/README.md +45 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/config.example.toml +2 -2
- agent_usage_tracker-0.2.0/docs/first-run.md +64 -0
- agent_usage_tracker-0.2.0/docs/improvement.md +834 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/local-labels.md +7 -2
- agent_usage_tracker-0.2.0/docs/quota.md +44 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/reference.md +20 -5
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/aut-scan.sh +2 -0
- agent_usage_tracker-0.2.0/packaging/launchd/dev.aut.improve-draft.plist +31 -0
- agent_usage_tracker-0.2.0/packaging/windows/register-task.ps1 +50 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/pyproject.toml +6 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/__init__.py +1 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/cli.py +45 -26
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/_util.py +5 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/codex.py +1 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor_sdk.py +20 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/generic_sdk.py +3 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/config.py +47 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/coverage.py +6 -3
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/demo.py +62 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/demo_cli.py +28 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/diagnostics.py +1 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/event.py +5 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/git_days.py +3 -14
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/history_steers.py +27 -8
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/case_view.py +76 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/cli.py +91 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/decide.py +406 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/draft.py +395 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/draft_adapters.py +232 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/groups.py +260 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/inbox.py +199 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/judge.py +217 -26
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/outputs.py +227 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/proposals.py +14 -2
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/qualify.py +288 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/report_card.py +385 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubric.py +64 -26
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/schedule.py +20 -28
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/scores.py +75 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/store.py +13 -2
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/validation.py +39 -25
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve_publish.py +109 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/backends.py +15 -5
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/bakeoff.py +45 -34
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/core.py +14 -8
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/evalset.py +26 -23
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/gold.py +61 -23
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/replay.py +21 -5
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/run.py +23 -19
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/tasks.py +14 -12
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/teach.py +15 -6
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observation_cli.py +2 -2
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observations.py +7 -2
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/operational_status.py +270 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/outcome_git.py +6 -2
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/overview.py +178 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/overview_cli.py +83 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/pricing.py +89 -22
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/pricing_cli.py +31 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/quota.py +255 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/quota_cli.py +147 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/scheduled.py +2 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/setup_cli.py +157 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/setup_schedule.py +164 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/README.md +6 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/dashboards/agents-effort.json +168 -4
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/dashboards/agents-usage.json +99 -37
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/01_schema.sql +31 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/sink_stack/sql/02_price.sql +73 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/03_effort.sql +9 -11
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/04_grants.sql +2 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/summary.py +363 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/summary_cli.py +34 -0
- agent_usage_tracker-0.2.0/src/agent_usage_tracker/usage_price.py +112 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_collectors.py +18 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_generic_sdk.py +18 -0
- agent_usage_tracker-0.2.0/tests/fixtures/claude-statusline-quota.json +10 -0
- agent_usage_tracker-0.2.0/tests/improve/test_case_context.py +88 -0
- agent_usage_tracker-0.2.0/tests/improve/test_decide.py +439 -0
- agent_usage_tracker-0.2.0/tests/improve/test_draft.py +314 -0
- agent_usage_tracker-0.2.0/tests/improve/test_draft_adapters.py +186 -0
- agent_usage_tracker-0.2.0/tests/improve/test_groups.py +275 -0
- agent_usage_tracker-0.2.0/tests/improve/test_inbox.py +158 -0
- agent_usage_tracker-0.2.0/tests/improve/test_judge_queue.py +134 -0
- agent_usage_tracker-0.2.0/tests/improve/test_outputs.py +464 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_proposals.py +30 -0
- agent_usage_tracker-0.2.0/tests/improve/test_qualify.py +365 -0
- agent_usage_tracker-0.2.0/tests/improve/test_report_card.py +274 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_rubric.py +68 -3
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_schedule.py +82 -0
- agent_usage_tracker-0.2.0/tests/improve/test_scores.py +101 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_store.py +15 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_t3.py +4 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_validation.py +52 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/label_helpers.py +18 -5
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_history_steers.py +28 -2
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label.py +5 -5
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_bakeoff.py +63 -25
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_context.py +5 -5
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_core.py +25 -4
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_evalset.py +49 -27
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_gap.py +9 -8
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_gold.py +8 -8
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_replay.py +22 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_tasks.py +32 -12
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_teach.py +11 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_writing.py +3 -3
- agent_usage_tracker-0.2.0/tests/pipeline/price_fixture.py +62 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_coverage.py +2 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_coverage_scan.py +2 -1
- agent_usage_tracker-0.2.0/tests/pipeline/test_delivery_notices.py +124 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_demo.py +52 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_first_run.py +229 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_ledger_zone.py +51 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_overview.py +101 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_overview_quota.py +82 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_pricing.py +87 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_publish_improve.py +172 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_quota.py +256 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_scan_wrapper.py +19 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_sink.py +21 -1
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_sink_sql.py +180 -1
- agent_usage_tracker-0.2.0/tests/pipeline/test_summary.py +208 -0
- agent_usage_tracker-0.2.0/tests/pipeline/test_summary_native_counts.py +93 -0
- agent_usage_tracker-0.2.0/tests/test_public_projection.py +32 -0
- agent_usage_tracker-0.1.0/docs/improvement.md +0 -434
- agent_usage_tracker-0.1.0/packaging/windows/register-task.ps1 +0 -19
- agent_usage_tracker-0.1.0/src/agent_usage_tracker/sink_stack/sql/02_price.sql +0 -60
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/.gitignore +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/DEPLOY.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/LICENSE +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/collectors-to-add.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/harness-coverage.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/2026-11-08-understanding-implicit-state-machines.html +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/2026-11-09-status-state-reliability-fixes.html +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/docs-index.json +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/index.html +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/improvement-studies.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/new-laptop.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/observations.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/research/codexbar-learnings.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/research/otel-lane.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/research/sdk-usage-capture.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/superpowers/plans/2026-07-22-aut-showcase-metrics.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/superpowers/specs/2026-07-22-aut-showcase-metrics-design.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/README.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/claude/commands/outcome.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.backup.plist +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.improve-audit.plist +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.retry.plist +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.scan.plist +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/Dockerfile +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/Dockerfile.dockerignore +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/README.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/aut-observations.service +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/sql/turn-snapshot-grant.sql +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/systemd/agent-usage-tracker.service +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/systemd/agent-usage-tracker.timer +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/backup.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/__init__.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/activity_common.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/activitywatch.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/claude_code.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/claude_code_activity.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/commits.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor_api.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/pi.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/session_digest.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/t3.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/coverage_catalog.json +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/cursor_run.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/episode_store.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/git_day_cache.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/git_safe.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/harness_inventory.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/__init__.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/desktop.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/evidence.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/avoidable_recovery.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/code_quality.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/completion_supported.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/redundant_tests.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/verbosity.md +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/runtime.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/search_check.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/studies.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/study_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/study_decision.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/study_followup.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/t3.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/trial.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/inspector.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/__init__.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/baseline.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/clef.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/context.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/covered_run.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/local.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/local_parallel.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/merge.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/outcome_coverage.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/local_page.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/manual_time.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/net.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observation_report.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observation_server.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/outcomes.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/push.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/redact.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/repo_keys.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/review.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/scan.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sdk.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/apply.sh +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/compose.yaml +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/env.example +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/provisioning/dashboards/aut.yaml +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/provisioning/datasources/agents.yaml +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/refresh.sql +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sources.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/state.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/telemetry.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/codex_pi_helpers.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_activity.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_activitywatch.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_activitywatch_macos.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_claude_code.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_claude_profiles.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_codex.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_codex_pi.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_commits.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_api.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_cli_cache.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_sdk.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_links.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_links_claude.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_pi.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_read_horizon.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_session_digest.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_source_registry.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_t3.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/conftest.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/__init__.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/conftest.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_case_view.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_desktop.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_evidence.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_evidence_citations.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_choices.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_deadline.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_native_deadline.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_sampling.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_stall.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_runtime.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_search_check.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_studies.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_studies_decision.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_trial.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_context_paths.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_covered_run.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_cursor_origin.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_baseline.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_local.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_models.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_parallel.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_reliability.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_outcome_coverage.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/outcomes/test_outcome_git.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/outcomes/test_outcome_reliability.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/outcomes/test_outcomes.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/fake_psycopg.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_backup.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_coverage_diagnostics.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_cursor_run.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_delivery_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_git_day_cache.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_git_days.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_harness_inventory.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_heartbeat.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_inspect.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_local_page.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_net.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_push.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_push_outbox.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_push_snapshots.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_redact.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_repo_keys.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_review.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_sessions.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_state.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observation_cli.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observation_report.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observation_server.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observations.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observe_entrypoint.py +0 -0
- {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_telemetry.py +0 -0
|
@@ -935,3 +935,22 @@ People can change coding tools without assuming that a successful collector capt
|
|
|
935
935
|
Doctor does not fetch a website or manufacture a publisher receipt.
|
|
936
936
|
|
|
937
937
|
The [coverage guide](docs/harness-coverage.md) defines the registry, limits and supported fields.
|
|
938
|
+
|
|
939
|
+
### Advisory improvement scores
|
|
940
|
+
|
|
941
|
+
`aut publish-improve` sends sampled verdict counts and human adoption metadata to the private sink.
|
|
942
|
+
It sends no evidence text, paths, case identifiers, session identifiers, rationale or commit SHAs.
|
|
943
|
+
|
|
944
|
+
`agents.improve_score_daily` is append-only, keyed by
|
|
945
|
+
`(day, rubric_id, rubric_version, harness, trigger, pushed_at)`.
|
|
946
|
+
Counts are `passed`, `failed`, `unknown` (nonnegative integers), with a boolean `qualified`.
|
|
947
|
+
`day` is the work date in the configured ledger time zone.
|
|
948
|
+
Triggers are `control`, `error_result`, or `merge`; versions are nonnegative integers.
|
|
949
|
+
`agents.improve_score_latest` exposes the latest push for each key without `pushed_at`.
|
|
950
|
+
A zero row clears a key removed inside the publisher's recomputed date window.
|
|
951
|
+
|
|
952
|
+
`agents.improve_adoption` holds `adoption_id` (first 16 hex of the private record key),
|
|
953
|
+
`adopted_at` (local noon), operator-written `title` (1..120 characters),
|
|
954
|
+
`kind` (`instruction`, `skill`, `config`, `code`), `rubric_ids` (text array), and optional integer `pr`.
|
|
955
|
+
Adoptions use `ON CONFLICT (adoption_id) DO NOTHING`. They do not claim a benefit.
|
|
956
|
+
The writer can select and insert both tables. Grafana reads only the latest score view and adoption table.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: agent-usage-tracker
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.2.0
|
|
4
4
|
Summary: Passive, subscription-safe tracker of coding-agent work (Claude Code, Codex, Cursor, Pi): usage, sessions, activity, active time, outcomes and local labels. Reads local logs, normalizes, pushes to a self-hosted sink.
|
|
5
5
|
Project-URL: Homepage, https://github.com/rhnfzl/agent-usage-tracker
|
|
6
6
|
Project-URL: Issues, https://github.com/rhnfzl/agent-usage-tracker/issues
|
|
@@ -95,6 +95,37 @@ It reads your current user's logs and writes usage rows to a local CSV.
|
|
|
95
95
|
Cursor CLI contributes prompt rows, not token counts; choose a Cursor token source below for those.
|
|
96
96
|
An unreadable source makes export exit nonzero, so a partial file cannot silently count as a complete export.
|
|
97
97
|
|
|
98
|
+
### Read a local usage summary
|
|
99
|
+
|
|
100
|
+
Use the summary to see recorded usage by agent, model, or project.
|
|
101
|
+
It reads local logs without a database, a provider account, or a network connection.
|
|
102
|
+
Try a synthetic example first, or preview local setup.
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
aut demo
|
|
106
|
+
aut setup
|
|
107
|
+
aut summary
|
|
108
|
+
aut summary --period week --group-by model
|
|
109
|
+
aut summary --since 2026-06-01 --until 2026-07-01 --group-by project --json
|
|
110
|
+
aut overview
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
The report uses the configured ledger time zone. The end date is exclusive.
|
|
114
|
+
Source coverage describes what AUT can read. JSON uses `null` when no values are known for a count.
|
|
115
|
+
The `unknown_events` field shows how many records lack each value.
|
|
116
|
+
Keep the output private if it includes project names.
|
|
117
|
+
|
|
118
|
+
Use `aut setup --apply` to create a starter configuration if you need one.
|
|
119
|
+
The [first-run guide](docs/first-run.md) covers optional scheduled delivery.
|
|
120
|
+
|
|
121
|
+
`aut sync-prices` explicitly refreshes local API list rates. The summary separates the known
|
|
122
|
+
estimated subtotal from the full estimate and from costs recorded in source logs.
|
|
123
|
+
Use `aut summary --compare-prices MODEL_A MODEL_B` to apply two rates to the same observed token mix.
|
|
124
|
+
|
|
125
|
+
Use `aut statusline` to check cached quota, reset times, and scan freshness.
|
|
126
|
+
The [quota guide](docs/quota.md) shows how to feed Claude Code statusline input into AUT
|
|
127
|
+
and enable local notices for quota or pending delivery.
|
|
128
|
+
|
|
98
129
|
### Keep history in your own database
|
|
99
130
|
|
|
100
131
|
Install the PostgreSQL extra:
|
|
@@ -193,7 +224,7 @@ They can also classify your instructions and infer whether a piece of work is re
|
|
|
193
224
|
|
|
194
225
|
Local estimates read Claude Code, Codex, Cursor CLI, and Pi inputs.
|
|
195
226
|
Prompts and final replies stay inside the episode's time bounds.
|
|
196
|
-
Daily work also stops at
|
|
227
|
+
Daily work also stops at midnight in `ledger_timezone`, so shared sessions cannot mix separate work days.
|
|
197
228
|
Cursor replies are omitted because their stores lack reliable per-reply timestamps.
|
|
198
229
|
Cases without sufficient evidence stay unclassified; uncertain model decisions stay unknown.
|
|
199
230
|
|
|
@@ -253,11 +284,17 @@ Native desktop receipts use `aut improve desktop`; command success does not esta
|
|
|
253
284
|
```bash
|
|
254
285
|
aut improve audit --days 7 --limit 30
|
|
255
286
|
aut improve status
|
|
287
|
+
aut improve report-card --days 28 --format md
|
|
256
288
|
```
|
|
257
289
|
|
|
258
290
|
Local judging uses cached models through the existing label extra.
|
|
259
291
|
Bounded reviews preserve completed judgments and resume unfinished work within the configured budget.
|
|
260
292
|
`aut improve inspect --case CASE_ID` writes a private view of a captured attempt and its source references.
|
|
293
|
+
|
|
294
|
+
`aut improve label --rubric completion_supported` opens a private human review page to check an advisory judge against captured cases.
|
|
295
|
+
`aut improve draft` prepares small changes for human review in private candidates. Remote drafters receive selected redacted file text; conversation excerpts stay off by default.
|
|
296
|
+
|
|
297
|
+
Captured commit results can attach redacted local diffs for `code_quality` judging and human labels. Local commit-state changes queue another advisory review.
|
|
261
298
|
Missing or clipped evidence stays explicit; inspection does not upgrade a judgment.
|
|
262
299
|
Read the [private improvement guide](docs/improvement.md) before judging, staging changes, or executing trials.
|
|
263
300
|
The guide covers executable judge references, independent agent-task acceptance, and stable wheel installations.
|
|
@@ -273,6 +310,8 @@ Update the installed package before copying a new wrapper; the wrapper calls `au
|
|
|
273
310
|
The scheduler prevents overlapping runs and records daily success only after each step completes.
|
|
274
311
|
Failed or unfinished daily steps retry after the next successful scan.
|
|
275
312
|
Local scheduled labels require `AUT_LABEL=1` and `AUT_LABEL_MODE=local` in `scan.env`, plus saved recipes.
|
|
313
|
+
`AUT_IMPROVE_PUBLISH=1` adds daily advisory score and adoption-marker delivery after outcomes.
|
|
314
|
+
Deploy the updated sink schema first. Preview with `aut publish-improve --dry-run`.
|
|
276
315
|
An interrupted historical replay resumes when you invoke its saved job again; preparing a job does not install a scheduler.
|
|
277
316
|
|
|
278
317
|
Follow the [timer setup](packaging/README.md) and [wrapper reference](docs/reference.md#scheduling).
|
|
@@ -316,6 +355,11 @@ Read the [full privacy and network-call reference](docs/reference.md#privacy-mod
|
|
|
316
355
|
| Start with | Purpose |
|
|
317
356
|
|---|---|
|
|
318
357
|
| `aut status` | Check configuration, progress, and backup age |
|
|
358
|
+
| `aut setup` | Preview configuration, source checks, and delivery status |
|
|
359
|
+
| `aut demo` | Try the local summary on synthetic agent logs |
|
|
360
|
+
| `aut summary --period week` | See local usage, source coverage, and unknown counts |
|
|
361
|
+
| `aut overview` | Open a private page with usage, source health, and available evidence |
|
|
362
|
+
| `aut statusline` | Check cached quota, reset times, and scan freshness |
|
|
319
363
|
| `aut scan --dry-run` | Inspect parsed totals without sending rows |
|
|
320
364
|
| `aut scan` | Deliver new usage and activity |
|
|
321
365
|
| `aut export --out usage.csv` | Export local usage without a sink |
|
|
@@ -63,6 +63,37 @@ It reads your current user's logs and writes usage rows to a local CSV.
|
|
|
63
63
|
Cursor CLI contributes prompt rows, not token counts; choose a Cursor token source below for those.
|
|
64
64
|
An unreadable source makes export exit nonzero, so a partial file cannot silently count as a complete export.
|
|
65
65
|
|
|
66
|
+
### Read a local usage summary
|
|
67
|
+
|
|
68
|
+
Use the summary to see recorded usage by agent, model, or project.
|
|
69
|
+
It reads local logs without a database, a provider account, or a network connection.
|
|
70
|
+
Try a synthetic example first, or preview local setup.
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
aut demo
|
|
74
|
+
aut setup
|
|
75
|
+
aut summary
|
|
76
|
+
aut summary --period week --group-by model
|
|
77
|
+
aut summary --since 2026-06-01 --until 2026-07-01 --group-by project --json
|
|
78
|
+
aut overview
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
The report uses the configured ledger time zone. The end date is exclusive.
|
|
82
|
+
Source coverage describes what AUT can read. JSON uses `null` when no values are known for a count.
|
|
83
|
+
The `unknown_events` field shows how many records lack each value.
|
|
84
|
+
Keep the output private if it includes project names.
|
|
85
|
+
|
|
86
|
+
Use `aut setup --apply` to create a starter configuration if you need one.
|
|
87
|
+
The [first-run guide](docs/first-run.md) covers optional scheduled delivery.
|
|
88
|
+
|
|
89
|
+
`aut sync-prices` explicitly refreshes local API list rates. The summary separates the known
|
|
90
|
+
estimated subtotal from the full estimate and from costs recorded in source logs.
|
|
91
|
+
Use `aut summary --compare-prices MODEL_A MODEL_B` to apply two rates to the same observed token mix.
|
|
92
|
+
|
|
93
|
+
Use `aut statusline` to check cached quota, reset times, and scan freshness.
|
|
94
|
+
The [quota guide](docs/quota.md) shows how to feed Claude Code statusline input into AUT
|
|
95
|
+
and enable local notices for quota or pending delivery.
|
|
96
|
+
|
|
66
97
|
### Keep history in your own database
|
|
67
98
|
|
|
68
99
|
Install the PostgreSQL extra:
|
|
@@ -161,7 +192,7 @@ They can also classify your instructions and infer whether a piece of work is re
|
|
|
161
192
|
|
|
162
193
|
Local estimates read Claude Code, Codex, Cursor CLI, and Pi inputs.
|
|
163
194
|
Prompts and final replies stay inside the episode's time bounds.
|
|
164
|
-
Daily work also stops at
|
|
195
|
+
Daily work also stops at midnight in `ledger_timezone`, so shared sessions cannot mix separate work days.
|
|
165
196
|
Cursor replies are omitted because their stores lack reliable per-reply timestamps.
|
|
166
197
|
Cases without sufficient evidence stay unclassified; uncertain model decisions stay unknown.
|
|
167
198
|
|
|
@@ -221,11 +252,17 @@ Native desktop receipts use `aut improve desktop`; command success does not esta
|
|
|
221
252
|
```bash
|
|
222
253
|
aut improve audit --days 7 --limit 30
|
|
223
254
|
aut improve status
|
|
255
|
+
aut improve report-card --days 28 --format md
|
|
224
256
|
```
|
|
225
257
|
|
|
226
258
|
Local judging uses cached models through the existing label extra.
|
|
227
259
|
Bounded reviews preserve completed judgments and resume unfinished work within the configured budget.
|
|
228
260
|
`aut improve inspect --case CASE_ID` writes a private view of a captured attempt and its source references.
|
|
261
|
+
|
|
262
|
+
`aut improve label --rubric completion_supported` opens a private human review page to check an advisory judge against captured cases.
|
|
263
|
+
`aut improve draft` prepares small changes for human review in private candidates. Remote drafters receive selected redacted file text; conversation excerpts stay off by default.
|
|
264
|
+
|
|
265
|
+
Captured commit results can attach redacted local diffs for `code_quality` judging and human labels. Local commit-state changes queue another advisory review.
|
|
229
266
|
Missing or clipped evidence stays explicit; inspection does not upgrade a judgment.
|
|
230
267
|
Read the [private improvement guide](docs/improvement.md) before judging, staging changes, or executing trials.
|
|
231
268
|
The guide covers executable judge references, independent agent-task acceptance, and stable wheel installations.
|
|
@@ -241,6 +278,8 @@ Update the installed package before copying a new wrapper; the wrapper calls `au
|
|
|
241
278
|
The scheduler prevents overlapping runs and records daily success only after each step completes.
|
|
242
279
|
Failed or unfinished daily steps retry after the next successful scan.
|
|
243
280
|
Local scheduled labels require `AUT_LABEL=1` and `AUT_LABEL_MODE=local` in `scan.env`, plus saved recipes.
|
|
281
|
+
`AUT_IMPROVE_PUBLISH=1` adds daily advisory score and adoption-marker delivery after outcomes.
|
|
282
|
+
Deploy the updated sink schema first. Preview with `aut publish-improve --dry-run`.
|
|
244
283
|
An interrupted historical replay resumes when you invoke its saved job again; preparing a job does not install a scheduler.
|
|
245
284
|
|
|
246
285
|
Follow the [timer setup](packaging/README.md) and [wrapper reference](docs/reference.md#scheduling).
|
|
@@ -284,6 +323,11 @@ Read the [full privacy and network-call reference](docs/reference.md#privacy-mod
|
|
|
284
323
|
| Start with | Purpose |
|
|
285
324
|
|---|---|
|
|
286
325
|
| `aut status` | Check configuration, progress, and backup age |
|
|
326
|
+
| `aut setup` | Preview configuration, source checks, and delivery status |
|
|
327
|
+
| `aut demo` | Try the local summary on synthetic agent logs |
|
|
328
|
+
| `aut summary --period week` | See local usage, source coverage, and unknown counts |
|
|
329
|
+
| `aut overview` | Open a private page with usage, source health, and available evidence |
|
|
330
|
+
| `aut statusline` | Check cached quota, reset times, and scan freshness |
|
|
287
331
|
| `aut scan --dry-run` | Inspect parsed totals without sending rows |
|
|
288
332
|
| `aut scan` | Deliver new usage and activity |
|
|
289
333
|
| `aut export --out usage.csv` | Export local usage without a sink |
|
|
@@ -10,8 +10,8 @@
|
|
|
10
10
|
machine = "laptop"
|
|
11
11
|
|
|
12
12
|
# What a "day" is in the sink's views: the IANA zone the sink was installed with (its AUT_TZ).
|
|
13
|
-
# Default: Europe/Amsterdam. git-days
|
|
14
|
-
#
|
|
13
|
+
# Default: Europe/Amsterdam. git-days, history-steers and the label commands count days in it.
|
|
14
|
+
# git-days and history-steers stop when it differs from the zone a sink_stack sink records.
|
|
15
15
|
# ledger_timezone = "Europe/Berlin"
|
|
16
16
|
|
|
17
17
|
# Which agents to collect. Omit to collect every collector except the opt-in activitywatch.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# First run
|
|
2
|
+
|
|
3
|
+
AUT reads the logs your coding agents already save. You can try it and check local coverage before
|
|
4
|
+
you choose a database or send any data.
|
|
5
|
+
|
|
6
|
+
## Start with a local report
|
|
7
|
+
|
|
8
|
+
```sh
|
|
9
|
+
aut setup
|
|
10
|
+
aut demo
|
|
11
|
+
aut setup --apply
|
|
12
|
+
aut summary
|
|
13
|
+
aut overview
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
`aut setup` previews the config path and checks local source metadata. Use `--json` for a
|
|
17
|
+
receipt with separate settings, source observations and delivery state. A scan receipt
|
|
18
|
+
describes locally emitted rows. The local queue can show pending rows, while delivery remains
|
|
19
|
+
unverified until you check the sink. A missing source can mean that the agent has yet to log
|
|
20
|
+
any work. Run `aut doctor --json` for the full private coverage report.
|
|
21
|
+
|
|
22
|
+
`aut setup --apply` creates the starter config only when the file is missing. The starter
|
|
23
|
+
uses local logs and leaves delivery off. The [config example](../config.example.toml) describes
|
|
24
|
+
optional sources and transport settings. The demo uses sample logs in a temporary directory.
|
|
25
|
+
It needs no provider account, database or previous setup.
|
|
26
|
+
|
|
27
|
+
The overview opens a private loopback page. Choose a date range and group by agent, model
|
|
28
|
+
or project. It shows when usage was last seen and whether scan evidence is fresh. If an
|
|
29
|
+
improvement store exists, the page links to its private report card. Use
|
|
30
|
+
`aut overview --no-browser` to get the local URL and Ctrl-C to close the page.
|
|
31
|
+
Quota appears after a [local capture](quota.md). The overview reads the cache for each page
|
|
32
|
+
request and shows freshness, the reset time and any supported pace estimate.
|
|
33
|
+
|
|
34
|
+
Use `aut improve inspect --case CASE_ID` to review the private context for a saved case.
|
|
35
|
+
The view links text sizes, exact repeat reads and observed compactions to their frozen events.
|
|
36
|
+
Captured text sizes use UTF-8 bytes and can be clipped. Actual model context tokens are unknown.
|
|
37
|
+
|
|
38
|
+
## Schedule delivery to your own sink
|
|
39
|
+
|
|
40
|
+
Set the transport in your local config. The scheduled job needs access to any environment
|
|
41
|
+
variables that the config names. AUT leaves credentials out of scheduler entries. Use a stable
|
|
42
|
+
`aut` executable, such as one from `uv tool install agent-usage-tracker`.
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
aut setup --schedule
|
|
46
|
+
aut setup --apply --schedule
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The first command previews. The second enables a per-user scan timer, which can start a scan
|
|
50
|
+
as soon as the scheduler loads it. It uses launchd on macOS, a systemd user timer on Linux,
|
|
51
|
+
and a scheduled task for the current interactive user on Windows. It keeps existing config and
|
|
52
|
+
refuses to replace a schedule created outside guided setup. On macOS the scheduled logs are
|
|
53
|
+
under `~/Library/Logs`. Linux uses the user journal and Windows uses Task Scheduler history.
|
|
54
|
+
|
|
55
|
+
On Windows, setup uses a process-local execution policy for the packaged script. Group Policy
|
|
56
|
+
can still block it. Use Task Scheduler to run `aut scan` if your administrator permits it.
|
|
57
|
+
|
|
58
|
+
The guided timer uses the default AUT config and state paths. For a custom setup, an existing
|
|
59
|
+
manual timer, or a system without a supported user scheduler, see
|
|
60
|
+
[the scheduler templates](../packaging/README.md). Use `aut summary` for local reporting on demand.
|
|
61
|
+
|
|
62
|
+
`aut setup --uninstall` removes only the scan entry created by guided setup. It keeps config,
|
|
63
|
+
scan state and logs. It can remove the managed entry when the config is unreadable.
|
|
64
|
+
Custom daily jobs and manual scan timers have their own removal procedures.
|