An interactive REPL that eliminates build → source → run friction for ROS2 workspaces.

Note: RSh uses Nerd Font glyphs in the prompt and status bar. Install a Nerd Font patched terminal font for the best experience.

Note: RSh is in it's development phase and still has a lot of work and testing. If you're using this make sure it's for personal use because things can and will break! Report any bugs you find and I'll try and fix them!

• One-command workflow - run pkg node builds, sources, and runs automatically
• Launch file support - launch pkg bringup.launch.py use_sim:=true
• Tab completion - commands → packages → executables/launch files/topics
• Safe Ctrl+C - forwards SIGINT to child nodes, REPL stays alive
• ROS2 debugging - topics, nodes, hz, echo, info, search built in
• Package browser - pkgs --src / --system / --user with formatted tables
• Global search - search camera finds matching packages, nodes, topics, services
• Per-package clean - clean my_pkg wipes only that package's build artifacts
• Persistent config - auto-sources your workspaces on startup via ~/.config/rsh/config.json

git clone https://github.com/zerobx0/RosSh.git
cd RosSh
chmod +x install.sh
./install.sh

Or manually:

git clone https://github.com/zerobx0/RosSh.git
cd RosSh
pip install .

# Start the shell
rsh

# Start with a workspace pre-sourced
rsh -w ~/my_ros2_ws

Pass --ros-args just like the normal CLI:

rsh ~/ros2_ws
 ❯ run my_pkg my_node --ros-args -p frequency:=10.0 --remap /input:=/sensor

Launch file arguments:

 ❯ launch my_pkg bringup.launch.py use_sim:=true rviz:=false

The search command queries packages, nodes, topics, and services simultaneously:

 ❯ search camera

Produces a formatted table showing all matches across all categories.

On first run, RSh creates ~/.config/rsh/config.json:

{
  "version": 1,
  "default_workspaces": [],
  "symlink_install": true,
  "build_timeout": 300
}

Add your workspaces to default_workspaces to auto-source them on startup:

{
  "default_workspaces": [
    "~/ros2_ws",
    "~/nav_ws"
  ]
}

• Python 3.10+
• ROS2 Humble (or compatible distro)
• A Nerd Font for terminal icons
• Ubuntu / Arch Linux

pip uninstall rsh

MIT