build-run-local
Run local builds with proper environment setup. Use when building code locally to verify changes before pushing.
When & Why to Use This Skill
The Build and Run Local skill enables developers to execute local builds and tests within an environment that perfectly mirrors the CI pipeline. By utilizing Pixi for environment management and Mojo for compilation, it ensures that all code changes are verified, formatted, and linted locally, effectively preventing build failures and maintaining a zero-warnings policy before code is pushed to production.
Use Cases
- Pre-push Verification: Execute the complete build and test suite locally to identify and fix errors before creating a Pull Request.
- Environment Synchronization: Automatically set up and activate local development environments using Pixi to ensure parity with CI/CD configurations.
- Isolated Debugging: Troubleshoot build failures or specific test cases in a controlled local environment with verbose output and performance metrics.
- Automated Quality Checks: Enforce coding standards by running formatters, linters, and pre-commit hooks to comply with project-wide quality policies.
| name | build-run-local |
|---|---|
| description | "Run local builds with proper environment setup. Use when building code locally to verify changes before pushing." |
| category | ci |
| mcp_fallback | none |
Build and Run Local
Execute local builds with environment setup matching CI pipeline.
When to Use
- Building code locally before pushing
- Testing individual components locally
- Verifying changes work before creating PR
- Running tests in local environment
- Debugging build issues in isolation
Quick Reference
# Activate environment
eval "$(pixi shell-hook)"
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 specific test
pixi run mojo test -I . tests/shared/core/test_extensor.mojo
# Format code
pixi run mojo format .
Workflow
- Activate environment: Use pixi to setup environment
- Verify environment: Check mojo version and dependencies
- Build locally: Run mojo build with proper flags
- Run tests: Execute test suite locally
- Check warnings: Verify zero-warnings policy compliance
- Run pre-commit: Validate formatting and linting
- Commit changes: Only after local verification passes
Build Configuration
Environment Setup:
pixi shell-hookactivates the pixi environment- Sets MOJO_PATH and compiler flags
- Matches CI environment configuration
Build Flags:
-I .includes current directory in path-Oenables optimizations for release builds--no-warn-unusedsuppresses specific warnings (use sparingly)
Test Flags:
-I .for module resolution-vfor verbose output-k "pattern"to run specific tests
Output Format
Report build results with:
- Status - Success or failure
- Warnings - Any compiler warnings found (must be zero)
- Test Results - Passed/failed counts
- Build Time - Performance metrics
- Issues - Any errors encountered
Error Handling
| Problem | Solution |
|---|---|
| Environment not found | Run pixi shell-hook to activate |
| Module not found | Verify -I . flag and correct paths |
| Permission denied | Check file permissions and ownership |
| Out of memory | Reduce parallel jobs or simplify test |
| Timeout | Check for infinite loops or long operations |
References
- See pixi.toml for available tasks and configuration
- See CLAUDE.md for zero-warnings policy
- See mojo-test-runner skill for advanced testing