Rura transforms the tedious "edit, up-arrow, rerun" shell cycle into a fluid, interactive TUI scratchpad. It features live previews, syntax highlighting, and partial execution, allowing you to debug and iterate on commands in real time.

• Partial Pipeline Execution: Execute only up to the current subcommand to debug complex pipes.
• Context-aware Completion: Tab-complete commands and file paths using your system's bash, zsh, or fish tools.
• Custom Shell Support: Specify which shell to use for command execution and completions (supports sh, bash, zsh, fish on Unix and powershell on Windows).
• Live Execution Modes: Real-time feedback as you type, with optional "Live Until Cursor" or "Live Full" modes.
• Search: Search and highlight text within the output pane with regex support.
• Syntax Highlighting: Visual feedback for subcommand boundaries, quotes, and pipes.
• Error Highlighting: Highlights the failed subcommand in the input field.
• Command Caching: Automatically caches output of subcommands to speed up iteration.
• Command Formatting: Automatically format your command pipeline.
• Subcommand Editing: Quick copy, cut, and paste of subcommands.
• Progress Indicator: Visual indicator for long-running commands.
• Persistent History: Quickly access and reuse previous commands.
• Save to File: Save current output or command to a file.
• Line Wrapping: Toggle whether long output lines wrap to fit the view.
• Customizable: Fully configurable key bindings, themes, and UI placement via TOML.

Live Execution

History

Search with regex support

Configurable layout

Command and filename completion

Line wrapping

Check the Releases page for pre-compiled binaries for your platform.

Homebrew (macOS/Linux):

brew install rura

Arch Linux (AUR): Install via your AUR helper:

# Pre-compiled binary
yay -S rura-bin

# Build from latest git source
yay -S rura-git

Cargo:

# From crates.io
cargo install rura

# From source
cargo install --git https://github.com/tlipinski/rura

You can start Rura by passing a file as an argument, piping data into it, or providing an initial command.

# Open a file
rura --file data.json

# Pipe data into rura
cat logs.txt | rura

# Start with an initial command
rura --command "grep error | sort"

# Print the last executed command from history without opening the UI
rura --last

In the save popup, type a destination path (Tab completes paths) and press Enter to write. Existing files are not overwritten.

Rura can be configured via a TOML file. The shell used by Rura is determined by (in order of priority):

1. The --shell (or -s) CLI argument.
2. The shell property in the configuration file.
3. The SHELL environment variable.
4. Default to sh.

The configuration path is determined as follows:

1. Path specified by the --config (or -C) CLI argument.
2. Path specified by the RURA_CONFIG environment variable.
3. Default path:
   • Linux: ~/.config/rura/config.toml
   • macOS: ~/Library/Application Support/rura/config.toml
   • Windows: %APPDATA%\rura\config.toml

You can override any default key binding in the [keybindings] section. Multiple keys can be assigned to the same action.

[keybindings]
quit = ["ctrl+q", "ctrl+c"]
execute_full = ["enter"]
complete = ["tab"]
complete_prev = ["shift+tab"]
subcommand_next = ["alt+right"]

Colors and styles can be adjusted in the [theme] section. Supported colors include red, green, yellow, blue, magenta, cyan, gray, black, white, and hex codes (e.g., "#ffffff").

Available theme keys:

[theme.cmd_highlight]
fg = "black"
bg = "yellow"
bold = true

[theme.line_nums]
fg = "magenta"

Rura maintains a persistent command history. The history file is located at:

• Linux: ~/.local/share/rura/history.txt
• macOS: ~/Library/Application Support/rura/history.txt
• Windows: %APPDATA%\rura\history.txt

Application logs are useful for troubleshooting. They are stored at:

• Linux: ~/.cache/rura/logs.txt
• macOS: ~/Library/Caches/rura/logs.txt
• Windows: %LOCALAPPDATA%\rura\logs.txt