Yanked
This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: Not for public use, moved to private.
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.)
1 maintainer
Metadata
1 maintainer
Release files for miracle-claw-extras 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| miracle_claw_extras-0.3.0.tar.gz | 194.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| miracle_claw_extras-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 346.3 kB
Release files / miracle_claw_extras-0.3.0.tar.gz
| Download URL | miracle_claw_extras-0.3.0.tar.gz |
|---|---|
| Size | 194.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
adbf2fd35d5cee4f3cc2478e59fbe21b5759cb435742933ef31641d0dbc21a13
|
|
BLAKE2b-256 checksum How to use checksums |
4f209240999cc6f5460848c6edb8faf6d8f50c9a123602fd7f787a3007b67985
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Release files / miracle_claw_extras-0.3.0-py3-none-any.whl
| Download URL | miracle_claw_extras-0.3.0-py3-none-any.whl |
|---|---|
| Size | 151.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2750deb1804efc1a0e6e5256b901042b04e711483f29a3669865c15a2ac2cae0
|
|
BLAKE2b-256 checksum How to use checksums |
592c18dc478e09b345c1fd4c09683c5918addccc3d4b5698ae316de7ca4e77d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
