Version and support

Package version in this checkout: 0.7.0 (release tag v0.7.0). Source documentation can include changes made after a published release. Use the artifact attached to a specific release when you need that version's docs.

Compatibility

Python 3.9+ for the core; macOS on Apple Silicon for host inspection and MLX execution. Optional backend dependency installation requires Python 3.12.

Support

• Issues and PRs: the cavi-ai/mlx-agent repository on GitHub.
• The core is a dependency-free Python package; adapters are generated deterministically from plugin.json and verified byte-for-byte in CI.

What is stable in 0.6.x

• The seven provider capabilities (mlx-scout, mlx-adopt, mlx-wire, mlx-bench, mlx-doctor, mlx-watch, mlx-fleet) and their argument grammars.
• The confirmation-gated transaction contract (preview hash, receipts, rollback).
• Receipt and state schemas (versioned, with migrations).

CLI-only commands can gain flags in minor releases. Download and lifecycle starts use preview hashes; direct inference and JIT policy operations use different interfaces. Use the CLI reference and command help for the current contract.

Release pipeline

Tagging vX.Y.Z runs the Release workflow. It refuses to proceed unless every committed copy of the version agrees — runtime, plugin manifest, both marketplace manifests, compatibility matrix, release evidence, site catalog, contract validator, and the documentation artifact. It then runs the full gate set, attaches mlx-agent-docs-vX.Y.Z.tar.gz to the GitHub Release, and dispatches cavi-oss-release to each registered documentation consumer.