miracle-claw-extras 0.3.0

Companion CLI tools for Miracle Claw: config, doctor, stats, cost, export, share, restore, diff, bench, template.

Miracle Claw - Extras

Companion CLI tools for Miracle Claw.

Miracle Claw is a talk-to-LLM-and-run-code shell. This package adds 10 companion commands that make working with Miracle Claw easier, faster, and more transparent.

$ pip install miracle-claw-extras
$ mlg-doctor          # diagnose your install
$ mlg-stats --period 30d    # show your usage
$ mlg-share           # bundle a session for sharing

The 10 Commands

Command	What it does
mlg-config	Interactive config generator. Walks you through setup, or show/edit/validate/reset/import/export your existing config.
mlg-doctor	Health check. Detects missing deps, broken configs, unreachable services. Can auto-fix common issues.
mlg-bench	Benchmark sub-agents. Runs standard prompts through each agent and reports timing + quality.
mlg-export	Export sessions. JSON, Markdown, HTML, plain text, or PDF. Useful for sharing, archiving, or posting to a blog.
mlg-stats	Usage statistics. Total turns, time, by-model, by-day, by-hour, by-status. From your local history, no MAIC needed.
mlg-diff	Compare things. Two sessions, two configs, two outputs. Shows unified diff, side-by-side, or JSON.
mlg-template	Project scaffolding. 5 built-in templates (python-cli, python-api, web-app, tauri-desktop, mlg-skill). Add your own from git.
mlg-restore	Restore a session from a .mlgsnap bundle. Verifies the bundle, imports it as a local snapshot, and lists/deletes existing snapshots.
mlg-share	Bundle a session. Creates a .mlgsnap zip archive with the session, code, and optional config. SHA256-checksummed for tamper detection.
mlg-cost	Cost breakdown. Estimated spend by model, by day. Configurable per-model pricing.

Each command is also a standalone entry point, so you can type mlg-doctor directly without mlg-extras doctor.

Quickstart

# Install
pip install miracle-claw-extras

# Check your install
mlg-doctor

# See your usage this month
mlg-stats --period 30d

# Share a session with a teammate
mlg-share --output session.mlgsnap
# → send them session.mlgsnap
# → they run: mlg-restore session.mlgsnap

Documentation

• Installation guide
• Quickstart
• Command reference — one page per command
• Development guide — how to add a new command
• Troubleshooting

Requirements

• Python 3.10 or later
• A working Miracle Claw install (some commands read from ~/.miracle_claw/)
• The package itself is pure Python with three small deps: click, rich, pyyaml

License

Apache 2.0. See LICENSE.

Copyright 2026 Milagro Distribution Corp.

Related projects

• miracle-claw — the parent CLI (Apache 2.0, also by Milagro Distribution Corp.)