SenmuuuuW/dsh-whale-report
🐋 Whale Notepad — Your Agent Annual Report: Generate daily/weekly/monthly/annual reports from session event logs, any range, read-only and not rewritten
dsh-whale-report, presented as DeepTrace, converts local Harness event logs into daily through annual reports about sessions, tokens, estimated cost, tool calls, risks, anomalies, and provider balance. Its deterministic findings highlight repeated failures and retry waste, then attach evidence, affected sessions, confidence, and a baseline-to-target verification plan. The analysis stays read-only: v0.5 can detect or dismiss improvement opportunities but does not silently rewrite agent configuration.
Install
dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"Verified as the official README's recommended full-featured DSH installation. Restart dsh web afterward. Plain npm install only provides the package for direct engine or CLI use and does not register the Web UI or whale_report tool.
Compatibility
DeepSeek Harness Web for the integrated panel, tool, and live cost view; local Node/pnpm for CLI reports. It reads local compressed session archives, estimates provider cost, and treats missing or damaged session data as partial rather than zero.
Details
- Repo: SenmuuuuW/dsh-whale-report
- Category: Agent Capabilities
- Stars: 23
- Version: v0.5 feature line documented
- Last push: 2026-09-03
- First seen: 2026-08-14
Recent updates
The v0.5 README adds deterministic Improve findings with stable ids and verification plans, documents partial-data disclosure, and supports Web, HTML, PDF, Markdown, and PNG-oriented report workflows with stated export limits.
FAQ
- Is npm install enough to enable the DSH panel?
- No. The README says the GitHub Profile Bundle installation is required for the Web UI, whale_report tool, and live costing.
- Are the displayed costs exact bills?
- No. They are estimates based on documented provider pricing and should be checked against the provider bill.
- Will the Improve engine change my settings?
- No. In v0.5 it provides read-only findings and verification plans; automatic apply and self-healing are not implemented.
Alternatives
Ychris12138/dsh-usage-stats · Han-1413141/dsh-cost-meter · zh667/TokenLedger