xshell

xshell provides a set of cross-platform utilities for writing ergonomic “bash” scripts in Rust. Its headline feature is the cmd! macro, which offers a concise, interpolation-friendly syntax for building and running external commands while safely handling arguments and avoiding shell-injection pitfalls.

Beyond command execution, xshell bundles a Shell type with helpers for changing directories, reading and writing files, managing environment variables, and creating temporary directories, turning routine automation and build scripts into clean, portable Rust code.

What You Get

• A cmd! macro for building and running external commands with safe interpolation
• A Shell type with helpers for cwd, files, environment variables, and temp dirs
• Cross-platform behavior so the same script runs on Linux, macOS, and Windows
• Ergonomic error handling that plays well with anyhow and the ? operator

Common Use Cases

• Writing build, release, and CI automation scripts in Rust
• Replacing brittle bash scripts with portable, type-checked code
• Orchestrating external tools like git and cargo from Rust

Under The Hood

Architecture - The crate is deliberately small: lib.rs defines the Shell handle and the public cmd! interface, exec.rs implements command construction and process execution (re-implementing scripting-environment behavior in Rust rather than delegating to a system shell), and error.rs provides a focused error type. The cmd! macro is expanded from a companion xshell-macros proc-macro crate that parses the command template at compile time.

Tech Stack - Pure Rust built with Cargo, with essentially no runtime dependencies beyond the standard library and its own macro crate. It re-implements parts of a scripting environment (process spawning, cwd, env, temp dirs) directly on std.

Code Quality - The code is compact, idiomatic, and thoroughly documented at the module level, reflecting matklad’s characteristic clarity. It grew out of real xtask usage and has broad adoption (tens of millions of downloads); recent maintenance activity is low but the crate is stable and mature.

API Design - The API is a highlight: cmd!(sh, "...") reads almost like the shell it replaces, with interpolation and splat ({args...}) syntax, while Shell methods (read_file, set_current_dir, var) are discoverable and consistent. Getting started requires a single Shell::new() and virtually no boilerplate.