§ badge
Machine Mode Ready.
A conformance badge for tools that implement the Machine Mode standard. Drop it in your README or docs to declare that your CLI offers a stable, discoverable, bounded, safe interface a non-human caller can rely on.
§ 01
Standard
Markdown
[](https://machinemode.io/)
HTML
<a href="https://machinemode.io/"><img src="https://machinemode.io/badge.svg" alt="Machine Mode Ready"></a>
reStructuredText
.. image:: https://machinemode.io/badge.svg :target: https://machinemode.io/ :alt: Machine Mode Ready
§ 02
Mini
Markdown
[](https://machinemode.io/)
HTML
<a href="https://machinemode.io/"><img src="https://machinemode.io/badge.svg?variant=mini" alt="Machine Mode Ready"></a>
reStructuredText
.. image:: https://machinemode.io/badge.svg?variant=mini :target: https://machinemode.io/ :alt: Machine Mode Ready
§ 03
Versioned
The badge takes optional profile and version query parameters. Default is aoi-cli at the current draft version. Pin to a specific spec version if you want the badge to age with your codebase.
Markdown
[](https://machinemode.io/)
HTML
<a href="https://machinemode.io/"><img src="https://machinemode.io/badge.svg?profile=aoi-cli&version=0.2" alt="Machine Mode Ready · AOI-CLI v0.2"></a>
reStructuredText
.. image:: https://machinemode.io/badge.svg?profile=aoi-cli&version=0.2 :target: https://machinemode.io/ :alt: Machine Mode Ready · AOI-CLI v0.2
§ 04
Who may use it
- Any tool whose machine mode passes the conformance checklist in §18 of the AOI‑CLI specification.
- Any wrapper or harness that exposes Machine Mode for an upstream tool whose own interface is not yet conforming.
- Any documentation, blog post, or article that explains or cites Machine Mode and wants a visible mark linking back to the standard.
The badge is self-declared, not certified. Conformance verification is a job for aoi-lint, not the badge.