r3bl-cmdr

Why R3BL?

R3BL TUI library & suite of apps focused on developer productivity

Table of contents

• Introduction
• Installation
• Changelog
• Learn how these crates are built, provide feedback
• Run giti binary target
• Run edi binary target
• Build, run, test tasks
  • Prerequisites
    • Binary Development Features

Introduction

Please read the main README.md of the r3bl-open-core monorepo and workspace to get a better understanding of the context in which this crate is meant to exist.

Installation

The two apps, edi and giti, that comprise r3bl-cmdr will make you smile and make you more productive. Both are fully async (built on r3bl_tui) and currently available as early access preview 🐣.

• 😺 giti - An interactive git CLI app designed to give you more confidence and a better experience when working with git.

  • Fully async—never blocks the main thread
  • Visual branch selection
  • Streamlined commit workflows

• 🦜 edi - A TUI Markdown editor that lets you edit Markdown files in your terminal in style.

  • Fully async—never blocks the main thread
  • Gradient colors and smart terminal capability detection (gracefully degrades)
  • Smart list formatting and full emoji support
  • Language-specific syntax highlighting inside fenced code blocks
  • SSH optimized—only repaints what's changed
  • Zero-copy gap buffer for responsive editing even in large files

To install r3bl-cmdr on your system, run the following command, assuming you have cargo on your system:

cargo install r3bl-cmdr

If you don't have cargo on your system, you can either:

1. Follow these instructions to install cargo on your system first. Then run cargo install r3bl-cmdr to install this crate. Here are the commands for Linux:

   # Install Rust toolchain using rustup.
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   # Install the r3bl-cmdr crate.
   cargo install r3bl-cmdr
   

2. Build the binaries from the crate's source code. First clone this repo. Then, run:

   git clone https://github.com/r3bl-org/r3bl-open-core/ # clone the repo locally
   cd r3bl-open-core       # navigate to the repo root
   ./bootstrap.sh          # install all required tools
   cd cmdr/                # navigate to the cmdr crate
   cargo install --path .  # after install, the binaries are in ~/.cargo/bin
   

Changelog

Please check out the changelog to see how the crate has evolved over time.

Learn how these crates are built, provide feedback

To learn how we built this crate, please take a look at the following resources.

• If you like consuming video content, here's our YT channel. Please consider subscribing.
• If you like consuming written content, here's our developer site.

Run giti binary target

To run from binary:

• Run cargo install r3bl-cmdr (detailed instructions above). This will install giti locally to ~/.cargo/bin.
• Run giti from anywhere on your system.
• Try giti --help to see the available commands.
• To delete one or more branches in your repo run giti branch delete.
• To checkout a branch run giti branch checkout.
• To create a new branch run giti branch new.

To run from source:

• Clone the r3bl-open-core repo.
• Run ./bootstrap.sh to install all required tools (Linux/macOS).
• Run fish run.fish install-cmdr to install giti locally to ~/.cargo/bin.
• Run giti from anywhere on your system.
• Try giti --help to see the available commands.
• To delete one or more branches in your repo run giti branch delete.
• To checkout a branch run giti branch checkout.
• To create a new branch run giti branch new.
• If you want to generate log output for giti, run giti -l. For example, giti -l branch delete. To view this log output run fish run.fish log.

Run edi binary target

To run from binary:

• Run cargo install r3bl-cmdr (detailed instructions above). This will install edi locally to ~/.cargo/bin.
• Run edi from anywhere on your system.
• Try edi --help to see the available commands.
• To open an existing file, run edi <file_name>. For example, edi README.md.

To run from source:

• Clone the r3bl-open-core repo.
• Run ./bootstrap.sh to install all required tools (Linux/macOS).
• Run fish run.fish install-cmdr to install edi locally to ~/.cargo/bin.
• Run edi from anywhere on your system.
• Try edi --help to see the available commands.
• To open an existing file, run edi <file_name>. For example, edi README.md.
• If you want to generate log output for edi, run edi -l. For example, edi -l README.md. To view this log output run fish run.fish log.

Build, run, test tasks

Prerequisites

🌠 The easiest way to get started is to use the bootstrap script:

./bootstrap.sh
fish run.fish install-cargo-tools
cargo install --path .

This script above automatically installs:

• Rust toolchain via rustup
• Fish shell
• File watchers (inotifywait/fswatch)
• All required cargo development tools
• The r3bl-cmdr binaries

For complete development setup and all available commands, see the repository README.

Binary Development Features

• Interactive binary selection: Choose which binary to run with fuzzy search
• Smart log monitoring: Automatically detects and manages log files from binaries
• Docker builds: Build release binaries in isolated Docker environment
• Cross-platform file watching: Uses inotifywait (Linux) or fswatch (macOS)

License: Apache-2.0