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 automates the execution of local builds and environment configurations to mirror CI pipelines. It enables developers to verify code changes, run comprehensive test suites, and ensure compliance with zero-warnings policies locally before pushing to a repository, specifically optimized for Mojo and Pixi-based development workflows.
Use Cases
- Pre-push Verification: Ensure local builds pass and match CI environment configurations to prevent broken builds in the remote repository.
- Automated Testing and QA: Execute Mojo test suites locally with specific flags to validate individual components and verify bug fixes before PR submission.
- Environment Synchronization: Use Pixi to automatically activate and manage shell environments, ensuring consistent compiler versions and dependency paths across the team.
- Code Quality Enforcement: Run automated formatting and linting checks locally to maintain high code standards and adhere to project-specific style guides.
- Isolated Debugging: Troubleshoot complex build issues or compiler warnings in a controlled local environment to reduce iteration time and CI resource usage.
| 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 |
| user-invocable | false |
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