r3bl-cmdr: Suite of TUI apps focused on developer productivity

• Install the apps on your system using cargo
• Run giti binary target
• Run edi binary target
• Build, run, test tasks
  • Prerequisites
  • Nu shell scripts to build, run, test etc.

Install the apps on your system using cargo

Two apps, edi and giti, that comprise r3bl-cmdr will put a smile on your face and make you more productive:

• giti - an interactive git CLI app designed to give you more confidence and a better experience when working with git.
• edi - a TUI Markdown editor that lets you edit Markdown files in your terminal in style.

To install r3bl-cmdr on your system, run the following command:

cargo install r3bl-cmdr

You will need cargo installed on your system. If you don't have it, follow the instructions here.

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.
• Go to the cmdr folder in your terminal.
• Run nu run install 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 nu run log.

Run edi binary target

To run from binary:

• Run cargo install r3bl-cmdr (detailed instructions above). This will install giti 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.
• Go to the cmdr folder in your terminal.
• Run nu run install 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 nu run log.

Build, run, test tasks

Prerequisites

🌠 In order for these to work you have to install the Rust toolchain, nu, cargo-watch, bat, and flamegraph on your system. Here are the instructions:

1. Install the Rust toolchain using rustup by following the instructions here.
2. Install cargo-watch using cargo install cargo-watch.
3. Install flamegraph using cargo install flamegraph.
4. Install bat using cargo install bat.
5. Install nu shell on your system using cargo install nu. It is available for Linux, macOS, and Windows.

Nu shell scripts to build, run, test etc.

The following commands will watch for changes in the source folder and re-run:

There's also a run script at the top level folder of the repo. It is intended to be used in a CI/CD environment w/ all the required arguments supplied or in interactive mode, where the user will be prompted for input.