mlx-optimizer

MLX Optimizer Plugin

mlx-optimizer is a plugin bundle for optimizing Python-first MLX projects on Apple Silicon. It gives Codex, GitHub Copilot CLI, VS Code Agent Plugins, Claude Code, and Cursor a focused set of skills, reference notes, audit scripts, and report templates for MLX performance work.

The plugin is intentionally evidence-driven. It helps an agent inspect a target repo, identify candidate performance and correctness risks, and verify changes with concrete commands, timings, memory telemetry, correctness checks, and residual-risk notes. Static findings are treated as candidates until the target workload proves them.

What This Plugin Provides

• Progressive-disclosure MLX skills for audits, training loops, inference loops, Metal profiling, custom-kernel escalation, and language-boundary guidance.
• Compact MLX reference files covering lazy evaluation, synchronization, transforms, memory, dtype policy, benchmark hygiene, and reporting.
• Stdlib-only Python utilities for static MLX audits, repo-local environment probing, and copy-ready benchmark scaffolding.
• Markdown templates for optimization reports, benchmark notes, and before/after verification.
• Packaging for Codex, GitHub Copilot/VS Code, Claude Code, and Cursor plugin installers.
• Smoke tests that validate script behavior and packaging paths without needing MLX to be installed.

Supported Plugin Surfaces

This repository contains multiple plugin packaging layers. Keep them distinct when editing manifests or release metadata.

Surface	Files	Install selector
Codex	plugins/mlx-optimizer/.codex-plugin/plugin.json and .agents/plugins/marketplace.json	mlx-optimizer@mlx-optimizer-local
GitHub Copilot CLI / VS Code Agent Plugins	plugin.json and .github/plugin/marketplace.json	mlx-optimizer@mlx-optimizer
Claude Code	plugins/mlx-optimizer/.claude-plugin/plugin.json and .claude-plugin/marketplace.json	mlx-optimizer@mlx-optimizer
Cursor	plugins/mlx-optimizer/.cursor-plugin/plugin.json and .cursor-plugin/marketplace.json	Local/team marketplace plugin

The canonical plugin implementation lives in plugins/mlx-optimizer/. The root plugin.json exists so Copilot and VS Code can resolve the same skill bundle from the repository root. Claude Code and Cursor use tool-specific manifests inside the canonical plugin root and marketplace files at the repository root.

Installation

Codex From This Checkout

codex plugin marketplace add /path/to/mlx-optimizer-plugin --json
codex plugin add mlx-optimizer@mlx-optimizer-local --json

Codex From GitHub

codex plugin marketplace add sealad886/mlx-optimizer-plugin --json
codex plugin add mlx-optimizer@mlx-optimizer-local --json

GitHub Copilot CLI

copilot plugin marketplace add sealad886/mlx-optimizer-plugin
copilot plugin install mlx-optimizer@mlx-optimizer

For local development, register this checkout as the marketplace source:

copilot plugin marketplace add /path/to/mlx-optimizer-plugin
copilot plugin install mlx-optimizer@mlx-optimizer

Direct local installs can still be useful while developing the plugin, but the Copilot CLI prefers marketplace-based installs:

copilot plugin install /path/to/mlx-optimizer-plugin

Claude Code

claude plugin marketplace add sealad886/mlx-optimizer-plugin
claude plugin install mlx-optimizer@mlx-optimizer

For local development, register this checkout:

claude plugin marketplace add /path/to/mlx-optimizer-plugin
claude plugin install mlx-optimizer@mlx-optimizer

VS Code Agent Plugins

Install from source with the VS Code command palette action Chat: Install Plugin From Source, then use this repository URL:

https://github.com/sealad886/mlx-optimizer-plugin

To browse it through a marketplace source, add the hosted repository to VS Code settings:

{
  "chat.plugins.marketplaces": [
    "sealad886/mlx-optimizer-plugin"
  ]
}

For local plugin development, register this checkout:

{
  "chat.pluginLocations": {
    "/path/to/mlx-optimizer-plugin": true
  }
}

Cursor

For local plugin development, symlink the canonical plugin root into Cursor's local plugin directory:

mkdir -p ~/.cursor/plugins/local
ln -s /path/to/mlx-optimizer-plugin/plugins/mlx-optimizer ~/.cursor/plugins/local/mlx-optimizer

Then restart Cursor or run Developer: Reload Window.

For team marketplace distribution, use Cursor's dashboard marketplace import flow with this repository. Cursor reads .cursor-plugin/marketplace.json at the repository root and loads plugins/mlx-optimizer/.cursor-plugin/plugin.json from the plugin source path. This repository does not claim public Cursor Marketplace publication until that submission is completed separately.

Skill Guide