---
name: mflux-dev-env
description: Set 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).