Skip to content

v0.2.0 — Local-First Dashboard & Reliable Installer

Choose a tag to compare

@Martin-soaring-dev Martin-soaring-dev released this 15 Oct 07:36
· 28 commits to main since this release

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.

⚠️ Notes

  • 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

New Contributors

Full Changelog: v0.1.0...v0.2.0