mflux-dev-env

Set up and work in the mflux dev environment (arm64 expectation, uv, Makefile targets, lint/format/test).

⭐1.7kstars🔀109forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

This Claude skill streamlines the setup and management of the mflux development environment, specifically optimized for macOS arm64 architectures. By integrating 'uv' for Python dependency management and providing standardized Makefile targets, it automates essential workflows including installation, linting, formatting, building, and testing to ensure environment consistency and developer productivity.

Use Cases

  • Initial Environment Setup: Quickly configure a local development environment for the mflux repository on macOS arm64 using automated installation scripts.
  • Automated Code Quality Checks: Execute standardized linting, formatting, and pre-commit suites to maintain code integrity and adhere to project style guides.
  • Environment Troubleshooting: Diagnose and resolve local setup issues or dependency conflicts by leveraging canonical environment commands.
  • Consistent Build and Test Execution: Run project builds and comprehensive test suites with optimized configurations to ensure reliable software delivery.
namemflux-dev-env
descriptionSet up and work in the mflux dev environment (arm64 expectation, uv, Makefile targets, lint/format/test).

mflux dev environment

This repo expects macOS arm64 and prefers uv + Makefile targets.

When to Use

  • You’re setting up the repo locally or diagnosing environment/setup issues.
  • You need the canonical way to run lint/format/check/build/test.

Instructions

  • Prefer Makefile targets:
    • Install: /install (or make install)
    • Lint: /lint (or make lint)
    • Format: /format (or make format)
    • Pre-commit suite: /check (or make check)
    • Build: /build (or make build)
  • Prefer uv run ... for running Python commands to ensure the correct environment.
  • When running tests, keep MFLUX_PRESERVE_TEST_OUTPUT=1 enabled (the /test* commands do this).