Repository navigation
v0.2.0 — Local-First Dashboard & Reliable Installer
MiMo Usage Dashboard v0.2.0
A major update introducing a local-first usage dashboard, a lightweight Python CLI, and a safer installation and upgrade system for MiMo Desktop.
✨ Highlights
📊 Usage Dashboard
- Token usage statistics, including input, output, reasoning, and cache consumption.
- Model usage breakdown and cache hit-rate visualization.
- 12-month activity heatmap and recent usage trends.
- Three dashboard views: Token Usage, Session Usage, and Context Usage.
- Self-contained HTML reports that work offline.
⚡ Local-First Architecture
- Rebuilt "/usage" using MiMo Desktop's native command mechanism.
- Usage aggregation and HTML generation run locally without AI computation.
- "/usage" generates a static HTML snapshot without starting a server.
- "/usage-open" enables an optional loopback-only, read-only refresh service.
- No telemetry or external data uploads.
🛠️ CLI & Installation
- Added npm CLI commands for installation, upgrades, diagnostics, reporting, and uninstallation.
- Introduced a transactional installer with preflight checks, backup, staging, validation, application, verification, and rollback.
- Preserves existing MiMo configuration, including JSONC comments and formatting.
- Protects user-modified files and refuses unsafe overwrites.
- Supports repeatable installation and controlled upgrades.
🔒 Security & Reliability
- Removed dynamic shell argument interpolation from MiMo slash commands.
- Added installation ownership verification using file hashes and manifests.
- Improved Windows path handling and database read-only access.
- Added safer service lifecycle management and uninstall behavior.
- Excluded local AI assistant memory from future Git tracking.
✅ Testing
- Expanded automated tests covering Python, Node.js, CLI, installation, upgrades, rollback, and dashboard behavior.
- Windows GitHub Actions CI passes on the release commit.
📦 Installation
Requirements:
- Python 3.10+
- Node.js 18+ for npm installation
- MiMo Desktop
npm install -g mimo-usage-dashboard
mimo-usage-dashboard install
Restart MiMo Desktop, open a new session, and run:
/usage
For the refreshable dashboard:
/usage-open
Alternatively, use the Windows PowerShell installer from the repository.
📚 Documentation
See the "README" (https://github.com/Martin-soaring-dev/mimo-usage-dashboard#readme) for installation instructions, CLI usage, architecture details, and troubleshooting.
- Dashboard data is read from the local MiMo Desktop database.
- "/usage" performs local processing, but MiMo Desktop may still use model tokens to relay the command result.
- The optional refresh service listens only on the local loopback interface.
- Existing installations should be upgraded using the supported installer rather than manually overwriting files.
Full Changelog: "View commits" (v0.1.2...v0.2.0)
What's Changed
- Add usage tabs and fix cache hit-rate chart by @Martin-soaring-dev in #1
- Promote installer hardening release to main by @Martin-soaring-dev in #3
- Fix /usage shell argument injection and Windows DB paths by @Martin-soaring-dev in #2
New Contributors
- @Martin-soaring-dev made their first contribution in #1
Full Changelog: v0.1.0...v0.2.0