build-run-local

Align local Mojo builds with CI using pixi shell-hook and zero-warnings policy.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/mvillmow/ml-odyssey --skill build-run-local
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-run-local
Source: https://github.com/mvillmow/ml-odyssey/tree/main/.claude/skills/build-run-local
Command: npx skills add https://github.com/mvillmow/ml-odyssey --skill build-run-local

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you run local builds in an environment that mirrors CI, enabling you to validate changes before pushing.

Core Features & Use Cases

  • Environment activation: Use pixi shell-hook to set MOJO_PATH and flags for builds.
  • Local builds: Run mojo build with proper include paths.
  • Local tests: Execute test suites locally to verify behavior.
  • Code quality checks: Run pre-commit and ensure zero-warnings policy.

Quick Start

Activate environment: eval $(pixi shell-hook) Verify mojo version: pixi run mojo --version Build project: pixi run mojo build -I . shared/core/extensor.mojo Run tests: pixi run mojo test -I . tests/shared/core/ Run a specific test: pixi run mojo test -I . tests/shared/core/test_extensor.mojo Format code: pixi run mojo format .

Frequently Asked Questions about build-run-local

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run local builds that match my CI environment?

Local builds mirror CI by activating the pixi environment with eval $(pixi shell-hook), which sets MOJO_PATH and required flags. Build using pixi run mojo build -I . -O --no-warn-unused to compile with proper include paths and enforce zero-warnings policy.

How do I run tests locally before pushing changes?

Execute tests locally using pixi run mojo test -I . -v -k pattern to run test suites with verbose output and pattern matching. Run specific test files with pixi run mojo test -I . tests/shared/core/test_extensor.mojo to verify behavior matches CI.

Why are my local builds failing when CI passes?

Local build failures typically stem from environment misalignment. Ensure pixi shell-hook is activated, MOJO_PATH is configured correctly, and you're building with -I . -O --no-warn-unused flags to replicate CI's strict zero-warnings policy.

What's required to set up a local Mojo build environment?

Prerequisites include pixi for environment management and Mojo installed within the pixi environment. Activate with eval $(pixi shell-hook), verify the version with pixi run mojo --version, then configure include paths with -I . for local builds and tests.

Can I run code quality checks locally before committing?

Yes. Run pixi run mojo format . to format code locally, then execute builds and tests with zero-warnings enforcement using -O --no-warn-unused flags to catch issues before pushing to CI.

Do I need specific Mojo flags for local development?

Yes. Use -I . to include the local directory, -O for optimization, --no-warn-unused to enforce zero-warnings policy, and -v for verbose test output. These flags align local builds and tests with CI configuration.