CLI Reference¶

The canonical developer workflow uses the cross-platform intellifl-dev CLI. Every command is invoked through uv run:

uv run intellifl-dev <command> [-- <args...>]

make compatibility

make <target> is still available as a thin wrapper, but intellifl-dev is the source of truth for all supported commands.

Environment¶

Command	Description
`check-env`	Verify that `uv`, Python, and Docker are available and correctly configured

uv run intellifl-dev check-env

Setup & Maintenance¶

Command	Description
`setup`	Install all Python dependencies and download datasets
`upgrade`	Update all dependencies to their latest versions
`yolo`	Nuke and rebuild: runs `clean` → `setup` → `upgrade` in sequence

Bootstrap a fresh clone

uv run intellifl-dev setup

Full rebuild from scratch

uv run intellifl-dev yolo

Development Workflows¶

Command	Description
`dev`	Start all services via Docker Compose (hot reload in dev mode)
`dev-down`	Stop all services
`docs`	Serve the documentation site locally (Zensical)
`sim`	Run a local simulation with optimized Ray environment
`baselines`	Record fast simulation baselines for CI regression checks

Start development Stop development Run a simulation Serve docs

uv run intellifl-dev dev

This starts the full Docker Compose stack: API, frontend, Redis, Celery worker, and docs site. In development mode, docker-compose.override.yml is automatically applied for hot reload.

uv run intellifl-dev dev-down

uv run intellifl-dev sim

Runs the default example config at config/simulation_strategies/example_strategy_config.json. Pass extra arguments after --:

uv run intellifl-dev sim -- path/to/custom_config.json --log-level DEBUG

uv run intellifl-dev docs

Launches Zensical's local dev server with live reload.

Quality Gates¶

Command	Description
`lint`	Run code quality checks (ruff format, ruff check, ty)
`validate`	Quick feedback: lint + unit tests only
`test`	Full test suite: unit + integration + performance
`audit`	Audit Python dependencies for known security vulnerabilities (pip-audit)
`frontend-audit`	Fix frontend (npm) security vulnerabilities

Fast feedback loop

uv run intellifl-dev validate

Full CI-equivalent suite

uv run intellifl-dev test

Security scanning

audit runs pip-audit against the locked dependency set. frontend-audit runs npm audit fix in the frontend/ directory.

Maintenance¶

Command	Description
`deps`	Show the dependency tree
`clean`	Remove build artifacts and caches
`reset`	Clean artifacts and experiment results (`out/`)
`cache-dir`	Show uv's cache directory location
`cache-prune`	Prune unused entries from uv's cache

Clean up disk space

uv run intellifl-dev clean

Nuclear option — wipe everything including results

uv run intellifl-dev reset

Destructive commands

reset deletes the out/ directory containing all simulation results. Use clean if you only want to remove build artifacts.

Passthrough arguments¶

Any command accepts extra arguments after a -- separator. These are forwarded directly to the underlying script or tool:

uv run intellifl-dev sim -- config/custom.json --log-level DEBUG
uv run intellifl-dev test -- -k test_flower_client -v