Universal command runner for Rust - Run any Rust file from anywhere with smart test detection
Installation • Quick Start • Documentation • VS Code Extension
RAZ is a universal command runner that executes any Rust file from any directory without requiring workspace context. It provides intelligent, cursor-aware test detection and persistent command overrides.
Without RAZ: Remember and retype complex cargo commands, navigate to project directories, manually manage test flags
With RAZ: Run any file from anywhere, save working configurations automatically, never lose your test setup
- 🎯 Universal Execution - Run any Rust file from anywhere without
cd
ing into directories - 📍 Cursor-Aware Detection - Automatically detects and runs the test/function at your cursor position
- 💾 Smart Override System - Save command flags per function, only persisted after successful execution
- 🛡️ Deferred Save - Failed commands never save bad configurations
- 🔧 IDE Integration - Works with VS Code, Vim, IntelliJ, and any editor
- 🚀 Zero Configuration - Works instantly with any Rust project structure
RAZ can run any Rust file from any directory without requiring workspace context:
- Run files from
/tmp/
or any random location - Execute tests without being in the project root
- Work with multiple projects simultaneously
RAZ analyzes your Rust files to determine:
- File type (binary, library, test, example, etc.)
- Module structure for accurate test targeting
- Framework detection (Leptos, Dioxus, Tauri, etc.)
- Entry points (main functions, tests, benchmarks)
Save command configurations per function - only working overrides are saved:
- Override data prepared but not saved immediately
- Command executed with the override applied
- Only if command succeeds is override saved to config
- Failed commands leave no persistent configuration
RAZ provides smart validation for command-line options:
- Context-aware validation (knows which options work with which commands)
- Framework-specific option support
- Helpful error messages with suggestions
- Configurable validation levels
RAZ works across multiple environments:
- CLI
- Command-line interface
- VS Code Extension
- IDE integration with hotkeys
- Vim/Neovim - Terminal and editor integration
- More coming soon - IntelliJ and other editors
Component | Description |
---|---|
raz-core |
Core command generation and execution engine |
raz-validation |
Framework-aware smart options validation |
raz-override |
Persistent override management with deferred save |
raz-config |
Configuration and settings management |
raz-common |
Shared utilities and types |
- Contributing Guide - Development setup and guidelines
See CONTRIBUTING.md for development setup and guidelines.
MIT - see LICENSE for details.
The universal command runner for Rust 🦀⚡