srsh 0.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9e757aeabce3a17e17c7ffcf6c201abbc8345d9b75d349d879781902c2420351
+  data.tar.gz: 4f90b0e077c2eae3223bff3a6e9bf53c955b8bcfa9e64dcd43b201b3ecf445db
+SHA512:
+  metadata.gz: e34fa22368e54984df32590ff9cfb9ccc550e4a25d5ae6c827ba9d2651b6b8e942cae846e8249950a3576b88afd8c64e531d1b536a39ba140a63d6b9e7ce6dcc
+  data.tar.gz: 527072fa0f7f38e9e0358bfc70c57947e2c2dbcbc46ca2e78c713e9d5e5252d1a9ac005c199a90b60fb8ef60561387bc3ea59010c30da6765a76af44c0432b73

data/LICENSE

@@ -0,0 +1,17 @@
+Copyright (C) 2025 RobertFlexx
+
+  This software is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this software.
+
+  Permission is granted to anyone to use this software for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely, subject to the following restrictions:
+
+  1. The origin of this software must not be misrepresented; you must not
+     claim that you wrote the original software. If you use this software
+     in a product, an acknowledgment in the product documentation would be
+     appreciated but is not required.
+  2. Altered source versions must be plainly marked as such, and must not be
+     misrepresented as being the original software.
+  3. This notice may not be removed or altered from any source distribution.

data/README.md

@@ -0,0 +1,235 @@
+This is version 0.6.0, if things dont work, or work optimally. If you notice anything wrong, please consult me.
+(Fixed Control-C, fixed some bugs, added new features (check via help command)
+THIS IS A BETA RELEASE, IT MAY NOT WORK.
+
+The code itself is written by RobertFlexx, but the comments are written by ChatGPT.
+
+## Known Issues:
+
+* Flatpak chaining with 'and' doesn't work.
+* Running Shell Scripts might not always work. Sometimes it works, other times not so much.
+
+## Please Consult:
+
+* if you have any issues with this SRSh version, please post an issue.
+
+## How to Install:
+
+### Clone the repository
+
+```console
+git clone https://github.com/RobertFlexx/RSH
+```
+
+### Change the directory to where the Ruby Script is located
+
+```console
+cd RSH
+```
+
+### And finally run it
+
+```console
+./rsh
+```
+
+---
+
+## Requirements
+
+* Ruby installed (2.7+ is recommended; newer is better).
+* A POSIX-ish terminal (Linux, *BSD, macOS Terminal, iTerm2, etc).
+* `./rsh` needs the executable bit set:
+
+  ```console
+  chmod +x rsh
+  ```
+
+If `./rsh` complains or behaves oddly, **run it directly in the repo first** before messing with symlinks or PATH.
+
+---
+
+## Basic Usage
+
+Once you’re in the repo:
+
+```console
+./rsh
+```
+
+Inside `srsh` / `rsh` you can:
+
+* Use normal commands (`ls`, `cat`, `grep`, etc.).
+* Use built-ins:
+
+  * `help` – show builtin help with all srsh-specific commands.
+  * `systemfetch` – prints system info with nice bars.
+  * `hist` – view shell history.
+  * `clearhist` – clear history (memory + file).
+  * `alias` / `unalias` – manage aliases.
+* Enjoy:
+
+  * **Autosuggestions** (ghost text from history).
+  * **Smart Tab completion**:
+
+    * Completes commands, files, dirs.
+    * `cd` → only directories.
+    * `cat` → only files.
+
+---
+
+## Adding `rsh` / `srsh` to your PATH
+
+So you don’t have to always `cd` into the repo and run `./rsh`, you can either:
+
+1. Add the repo directory to your `PATH`, or
+2. Symlink the script into a directory that’s already on your `PATH`.
+
+> ⚠️ There is a *system* command called `rsh` on some systems.
+> To avoid conflict, using the name `srsh` for the installed command is usually safer.
+
+### Option 1 — Add the repo directory to PATH (Linux & macOS, bash/zsh)
+
+Assuming the repo is at `~/RSH`:
+
+```console
+chmod +x ~/RSH/rsh
+```
+
+#### For `bash` (Linux, older macOS)
+
+Add this line to `~/.bashrc` (or `~/.bash_profile` on macOS):
+
+```bash
+export PATH="$HOME/RSH:$PATH"
+```
+
+Then reload:
+
+```console
+source ~/.bashrc
+```
+
+#### For `zsh` (default on modern macOS)
+
+Add this line to `~/.zshrc`:
+
+```zsh
+export PATH="$HOME/RSH:$PATH"
+```
+
+Reload:
+
+```console
+source ~/.zshrc
+```
+
+Now you can just run:
+
+```console
+rsh
+# or if you prefer to rename it:
+srsh
+```
+
+---
+
+### Option 2 — Symlink into `/usr/local/bin` (Linux & macOS)
+
+This keeps your PATH clean and gives you a nice command name.
+
+From the repo directory:
+
+```console
+chmod +x rsh
+sudo ln -s "$(pwd)/rsh" /usr/local/bin/srsh
+```
+
+Now you can just type:
+
+```console
+srsh
+```
+
+from anywhere.
+
+If you really, really want to override the system `rsh` (not recommended):
+
+```console
+sudo ln -s "$(pwd)/rsh" /usr/local/bin/rsh
+```
+
+---
+
+### *BSD: Adding to PATH
+
+On *BSD, the default shell might be `sh`, `ksh`, `csh`, or `tcsh`. Same idea, different config files.
+
+Assuming repo at `~/RSH`:
+
+```console
+chmod +x ~/RSH/rsh
+```
+
+#### For `sh` / `ksh` / `ash` / `dash` style shells
+
+Add to `~/.profile`:
+
+```sh
+export PATH="$HOME/RSH:$PATH"
+```
+
+Then either log out and back in, or:
+
+```console
+. ~/.profile
+```
+
+#### For `csh` / `tcsh`
+
+Edit `~/.cshrc` (or `~/.tcshrc`) and add:
+
+```csh
+set path = ( $HOME/RSH $path )
+```
+
+Reload it:
+
+```console
+source ~/.cshrc
+```
+
+Now you should be able to run:
+
+```console
+rsh
+# or rename / symlink it as srsh if you want:
+srsh
+```
+
+---
+
+## Tips / Notes
+
+* If the command **isn’t found** after editing PATH:
+
+  * Check which shell you’re actually using:
+
+    ```console
+    echo $SHELL
+    ```
+  * Make sure you edited the correct rc file for that shell.
+  * Print your PATH to confirm:
+
+    ```console
+    echo "$PATH"
+    ```
+* If things feel off, run it directly from the repo with:
+
+  ```console
+  ./rsh
+  ```
+
+  to see if the issue is PATH-related or shell-related.
+
+And as i say : if anything looks cursed, **consult me and/or open an issue** :D

data/bin/srsh

@@ -0,0 +1,882 @@
+#!/usr/bin/env ruby
+require 'shellwords'
+require 'socket'
+require 'time'
+require 'etc'
+require 'rbconfig'
+require 'io/console'
+
+# ---------------- Version ----------------
+SRSH_VERSION = "0.6.0"
+
+$0 = "srsh-#{SRSH_VERSION}"
+ENV['SHELL'] = "srsh-#{SRSH_VERSION}"
+print "\033]0;srsh-#{SRSH_VERSION}\007"
+
+Dir.chdir(ENV['HOME']) if ENV['HOME']
+
+$child_pids = []
+$aliases = {}
+
+Signal.trap("INT", "IGNORE")
+
+# ---------------- History ----------------
+HISTORY_FILE = File.join(Dir.home, ".srsh_history")
+HISTORY = if File.exist?(HISTORY_FILE)
+File.readlines(HISTORY_FILE, chomp: true)
+else
+  []
+end
+
+at_exit do
+  begin
+    File.open(HISTORY_FILE, "w") do |f|
+      HISTORY.each { |line| f.puts line }
+    end
+  rescue
+  end
+end
+
+# ---------------- RC file (create if missing) ----------------
+RC_FILE = File.join(Dir.home, ".srshrc")
+begin
+  unless File.exist?(RC_FILE)
+  File.write(RC_FILE, <<~RC)
+  # ~/.srshrc — srsh configuration
+  # This file was created automatically by srsh v#{SRSH_VERSION}.
+  # You can keep personal notes or planned settings here.
+  # (Currently not sourced by srsh runtime.)
+  RC
+  end
+rescue
+end
+
+# ---------------- Utilities ----------------
+def color(text, code)
+  "\e[#{code}m#{text}\e[0m"
+end
+
+def random_color
+  [31,32,33,34,35,36,37].sample
+end
+
+def rainbow_codes
+  [31,33,32,36,34,35,91,93,92,96,94,95]
+end
+
+def expand_vars(str)
+  str.gsub(/\$([a-zA-Z_][a-zA-Z0-9_]*)/) { ENV[$1] || "" }
+end
+
+def parse_redirection(cmd)
+  stdin_file = nil
+  stdout_file = nil
+  append = false
+
+  if cmd =~ /(.*)>>\s*(\S+)/
+    cmd = $1.strip
+    stdout_file = $2.strip
+    append = true
+  elsif cmd =~ /(.*)>\s*(\S+)/
+    cmd = $1.strip
+    stdout_file = $2.strip
+  end
+
+  if cmd =~ /(.*)<\s*(\S+)/
+    cmd = $1.strip
+    stdin_file = $2.strip
+  end
+
+  [cmd, stdin_file, stdout_file, append]
+end
+
+def human_bytes(bytes)
+  units = ['B','KB','MB','GB','TB']
+  size = bytes.to_f
+  unit = units.shift
+  while size > 1024 && !units.empty?
+    size /= 1024
+    unit = units.shift
+  end
+  "#{format('%.2f', size)} #{unit}"
+end
+
+def nice_bar(p, w = 30, code = 32)
+  p = [[p, 0.0].max, 1.0].min
+  f = (p * w).round
+  b = "█" * f + "░" * (w - f)
+  pct = (p * 100).to_i
+  "#{color("[#{b}]", code)} #{color(sprintf("%3d%%", pct), 37)}"
+end
+
+def terminal_width
+  IO.console.winsize[1]
+rescue
+  80
+end
+
+def strip_ansi(str)
+  str.to_s.gsub(/\e\[[0-9;]*m/, '')
+                     end
+
+                    # ---------------- Aliases ----------------
+                    def expand_aliases(cmd, seen = [])
+                    return cmd if cmd.nil? || cmd.strip.empty?
+                    first_word, rest = cmd.strip.split(' ', 2)
+                    return cmd if seen.include?(first_word)
+                    seen << first_word
+
+                    if $aliases.key?(first_word)
+                    replacement = $aliases[first_word]
+                    expanded = expand_aliases(replacement, seen)
+                    rest ? "#{expanded} #{rest}" : expanded
+                    else
+                    cmd
+                    end
+                    end
+
+                    # ---------------- System Info ----------------
+                    def current_time
+                    Time.now.strftime("%Y-%m-%d %H:%M:%S %Z")
+                    end
+
+                    def detect_distro
+                    if File.exist?('/etc/os-release')
+                    line = File.read('/etc/os-release').lines.find { |l|
+                                                                     l.start_with?('PRETTY_NAME="') || l.start_with?('PRETTY_NAME=')
+                                                                   }
+                    return line.split('=').last.strip.delete('"') if line
+                    end
+                    "#{RbConfig::CONFIG['host_os']}"
+                    end
+
+                    # ---------------- Quotes ----------------
+                    QUOTES = [
+                              "Keep calm and code on.",
+                              "Did you try turning it off and on again?",
+                              "There’s no place like 127.0.0.1.",
+                              "To iterate is human, to recurse divine.",
+                              "sudo rm -rf / – Just kidding, don’t do that!",
+                              "The shell is mightier than the sword.",
+                              "A journey of a thousand commits begins with a single push.",
+                              "In case of fire: git commit, git push, leave building.",
+                              "Debugging is like being the detective in a crime movie where you are also the murderer.",
+                              "Unix is user-friendly. It's just selective about who its friends are.",
+                              "Old sysadmins never die, they just become daemons.",
+                              "Listen you flatpaker! – Totally Terry Davis",
+                              "How is #{detect_distro}? 🤔",
+                              "Life is short, but your command history is eternal.",
+                              "If at first you don’t succeed, git commit and push anyway.",
+                              "rm -rf: the ultimate trust exercise.",
+                              "Coding is like magic, but with more coffee.",
+                              "There’s no bug, only undocumented features.",
+                              "Keep your friends close and your aliases closer.",
+                              "Why wait for the future when you can Ctrl+Z it?",
+                              "A watched process never completes.",
+                              "When in doubt, make it a function.",
+                              "Some call it procrastination, we call it debugging curiosity.",
+                              "Life is like a terminal; some commands just don’t execute.",
+                              "Good code is like a good joke; it needs no explanation.",
+                              "sudo: because sometimes responsibility is overrated.",
+                              "Pipes make the world go round.",
+                              "In bash we trust, in Ruby we wonder.",
+                              "A system without errors is like a day without coffee.",
+                              "Keep your loops tight and your sleeps short.",
+                              "Stack traces are just life giving you directions.",
+                              "Your mom called, she wants her semicolons back."
+                             ]
+
+                    $current_quote = QUOTES.sample
+
+                    def dynamic_quote
+                    chars = $current_quote.chars
+                    rainbow = rainbow_codes.cycle
+                    chars.map { |c| color(c, rainbow.next) }.join
+                    end
+
+                    # ---------------- CPU / RAM / Storage ----------------
+                    def read_cpu_times
+                    return [] unless File.exist?('/proc/stat')
+                    cpu_line = File.readlines('/proc/stat').find { |line| line.start_with?('cpu ') }
+                    return [] unless cpu_line
+                    cpu_line.split[1..-1].map(&:to_i)
+                    end
+
+                    def calculate_cpu_usage(prev, current)
+                    return 0.0 if prev.empty? || current.empty?
+                    prev_idle = prev[3] + (prev[4] || 0)
+                    idle = current[3] + (current[4] || 0)
+                    prev_non_idle = prev[0] + prev[1] + prev[2] + (prev[5] || 0) + (prev[6] || 0) + (prev[7] || 0)
+                    non_idle = current[0] + current[1] + current[2] + (current[5] || 0) + (current[6] || 0) + (current[7] || 0)
+                    prev_total = prev_idle + prev_non_idle
+                    total = idle + non_idle
+                    totald = total - prev_total
+                    idled = idle - prev_idle
+                    return 0.0 if totald <= 0
+                    ((totald - idled).to_f / totald) * 100
+                    end
+
+                    def cpu_cores_and_freq
+                    return [0, []] unless File.exist?('/proc/cpuinfo')
+                    cores = 0
+                    freqs = []
+                    File.foreach('/proc/cpuinfo') do |line|
+                    cores += 1 if line =~ /^processor\s*:\s*\d+/
+                    if line =~ /^cpu MHz\s*:\s*([\d.]+)/
+                    freqs << $1.to_f
+                    end
+                    end
+                    [cores, freqs.first(cores)]
+                    end
+
+                    def cpu_info
+                    prev = read_cpu_times
+                    sleep 0.05
+                    current = read_cpu_times
+                    usage = calculate_cpu_usage(prev, current).round(1)
+                    cores, freqs = cpu_cores_and_freq
+                    freq_display = freqs.empty? ? "N/A" : freqs.map { |f| "#{f.round(0)}MHz" }.join(', ')
+                    "#{color("CPU Usage:",36)} #{color("#{usage}%",33)} | " \
+                    "#{color("Cores:",36)} #{color(cores.to_s,32)} | " \
+                    "#{color("Freqs:",36)} #{color(freq_display,35)}"
+                    end
+
+                    def ram_info
+                    if File.exist?('/proc/meminfo')
+                    meminfo = {}
+                    File.read('/proc/meminfo').each_line do |line|
+                    key, val = line.split(':')
+                    meminfo[key.strip] = val.strip.split.first.to_i * 1024 if key && val
+                    end
+                    total = meminfo['MemTotal'] || 0
+                    free = (meminfo['MemFree'] || 0) + (meminfo['Buffers'] || 0) + (meminfo['Cached'] || 0)
+                    used = total - free
+                    "#{color("RAM Usage:",36)} #{color(human_bytes(used),33)} / #{color(human_bytes(total),32)}"
+                    else
+                    "#{color("RAM Usage:",36)} Info not available"
+                    end
+                    end
+
+                    def storage_info
+                    begin
+                    require 'sys/filesystem'
+                    stat = Sys::Filesystem.stat(Dir.pwd)
+                    total = stat.bytes_total
+                    free = stat.bytes_available
+                    used = total - free
+                    "#{color("Storage Usage (#{Dir.pwd}):",36)} #{color(human_bytes(used),33)} / #{color(human_bytes(total),32)}"
+                    rescue LoadError
+                    "#{color("Install 'sys-filesystem' gem for storage info:",31)} #{color('gem install sys-filesystem',33)}"
+                    rescue
+                    "#{color("Storage Usage:",36)} Info not available"
+                    end
+                    end
+
+                    # ---------------- Builtin helpers ----------------
+                    def builtin_help
+                    puts color('=' * 60, "1;35")
+                    puts color("srsh #{SRSH_VERSION} - Builtin Commands", "1;33")
+                    puts color(sprintf("%-15s%-45s", "Command", "Description"), "1;36")
+                    puts color('-' * 60, "1;34")
+                    puts color(sprintf("%-15s", "cd"), "1;36")          + "Change directory"
+                    puts color(sprintf("%-15s", "pwd"), "1;36")         + "Print working directory"
+                    puts color(sprintf("%-15s", "exit / quit"), "1;36") + "Exit the shell"
+                    puts color(sprintf("%-15s", "alias"), "1;36")       + "Create or list aliases"
+                    puts color(sprintf("%-15s", "unalias"), "1;36")     + "Remove alias"
+                    puts color(sprintf("%-15s", "jobs"), "1;36")        + "Show background jobs (tracked pids)"
+                    puts color(sprintf("%-15s", "systemfetch"), "1;36") + "Display system information"
+                    puts color(sprintf("%-15s", "hist"), "1;36")        + "Show shell history"
+                    puts color(sprintf("%-15s", "clearhist"), "1;36")   + "Clear saved history (memory + file)"
+                    puts color(sprintf("%-15s", "help"), "1;36")        + "Show this help message"
+                    puts color('=' * 60, "1;35")
+                    end
+
+                    def builtin_systemfetch
+                    user = ENV['USER'] || Etc.getlogin || Etc.getpwuid.name rescue ENV['USER'] || Etc.getlogin
+                    host = Socket.gethostname
+                    os = detect_distro
+                    ruby_ver = RUBY_VERSION
+                    cpu_percent = begin
+                    prev = read_cpu_times
+                    sleep 0.05
+                    cur = read_cpu_times
+                    calculate_cpu_usage(prev, cur).round(1)
+                    rescue
+                    0.0
+                    end
+
+                    mem_percent = begin
+                    if File.exist?('/proc/meminfo')
+                    meminfo = {}
+                    File.read('/proc/meminfo').each_line do |line|
+                    k, v = line.split(':')
+                    meminfo[k.strip] = v.strip.split.first.to_i * 1024 if k && v
+                    end
+                    total = meminfo['MemTotal'] || 1
+                    free = (meminfo['MemAvailable'] || meminfo['MemFree'] || 0)
+                    used = total - free
+                    (used.to_f / total.to_f * 100).round(1)
+                    else
+                          0.0
+    end
+  rescue
+    0.0
+  end
+
+  puts color('=' * 60, "1;35")
+  puts color("srsh System Information", "1;33")
+  puts color("User:        ", "1;36") + color("#{user}@#{host}", "0;37")
+  puts color("OS:          ", "1;36") + color(os, "0;37")
+  puts color("Shell:       ", "1;36") + color("srsh v#{SRSH_VERSION}", "0;37")
+  puts color("Ruby:        ", "1;36") + color(ruby_ver, "0;37")
+  puts color("CPU Usage:   ", "1;36") + nice_bar(cpu_percent / 100.0, 30, 32)
+  puts color("RAM Usage:   ", "1;36") + nice_bar(mem_percent / 100.0, 30, 35)
+  puts color('=' * 60, "1;35")
+end
+
+def builtin_jobs
+  if $child_pids.empty?
+    puts color("No tracked child jobs.", 36)
+    return
+  end
+  $child_pids.each do |pid|
+    status = begin
+      Process.kill(0, pid)
+      'running'
+    rescue Errno::ESRCH
+      'done'
+    rescue Errno::EPERM
+      'running'
+    end
+    puts "[#{pid}] #{status}"
+  end
+end
+
+def builtin_hist
+  HISTORY.each_with_index do |h, i|
+    printf "%5d  %s\n", i + 1, h
+  end
+end
+
+def builtin_clearhist
+  HISTORY.clear
+  if File.exist?(HISTORY_FILE)
+    begin
+      File.delete(HISTORY_FILE)
+    rescue
+    end
+  end
+  puts color("History cleared (memory + file).", 32)
+end
+
+# -------- Pretty column printer for colored text (used by ls) --------
+def print_columns_colored(labels)
+  return if labels.nil? || labels.empty?
+
+  width = terminal_width
+  visible_lengths = labels.map { |s| strip_ansi(s).length }
+  max_len = visible_lengths.max || 0
+  col_width = [max_len + 2, 4].max
+  cols = [width / col_width, 1].max
+  rows = (labels.length.to_f / cols).ceil
+
+  rows.times do |r|
+    line = ""
+    cols.times do |c|
+      idx = c * rows + r
+      break if idx >= labels.length
+      label = labels[idx]
+      visible = strip_ansi(label).length
+      padding = col_width - visible
+      line << label << (" " * padding)
+    end
+    STDOUT.print("\r")
+    STDOUT.print(line.rstrip)
+    STDOUT.print("\n")
+  end
+end
+
+def builtin_ls(path = ".")
+  begin
+    entries = Dir.children(path).sort
+  rescue => e
+    puts color("ls: #{e.message}", 31)
+    return
+  end
+
+  labels = entries.map do |name|
+    full = File.join(path, name)
+    begin
+      if File.directory?(full)
+        color("#{name}/", 36)
+      elsif File.executable?(full)
+        color("#{name}*", 32)
+      else
+        color(name, 37)
+      end
+    rescue
+      name
+    end
+  end
+
+  print_columns_colored(labels)
+end
+
+# ---------------- External Execution Helper ----------------
+def exec_external(args, stdin_file, stdout_file, append)
+  command_path = args[0]
+  if command_path && (command_path.include?('/') || command_path.start_with?('.'))
+    begin
+      if File.directory?(command_path)
+        puts color("srsh: #{command_path}: is a directory", 31)
+        return
+      end
+    rescue
+    end
+  end
+
+  pid = fork do
+    Signal.trap("INT","DEFAULT")
+    if stdin_file
+      begin
+        STDIN.reopen(File.open(stdin_file,'r'))
+      rescue
+      end
+    end
+    if stdout_file
+      begin
+        STDOUT.reopen(File.open(stdout_file, append ? 'a' : 'w'))
+      rescue
+      end
+    end
+    begin
+      exec(*args)
+    rescue Errno::ENOENT
+      puts color("Command not found: #{args[0]}", rainbow_codes.sample)
+      exit 127
+    rescue Errno::EACCES
+      puts color("Permission denied: #{args[0]}", 31)
+      exit 126
+    end
+  end
+
+  $child_pids << pid
+  begin
+    Process.wait(pid)
+  rescue Interrupt
+  ensure
+    $child_pids.delete(pid)
+  end
+end
+
+# ---------------- Command Execution ----------------
+def run_command(cmd)
+  cmd = cmd.to_s
+  cmd = expand_aliases(cmd.strip)
+  cmd = expand_vars(cmd.strip)
+  cmd, stdin_file, stdout_file, append = parse_redirection(cmd)
+  args = Shellwords.shellsplit(cmd) rescue []
+  return if args.empty?
+
+  case args[0]
+  when 'ls'
+    if args.length == 1
+      builtin_ls(".")
+      return
+    elsif args.length == 2 && !args[1].start_with?("-")
+      builtin_ls(args[1])
+      return
+    end
+    exec_external(args, stdin_file, stdout_file, append)
+    return
+  when 'cd'
+    path = args[1] ? File.expand_path(args[1]) : ENV['HOME']
+    if !File.exist?(path)
+      puts color("cd: no such file or directory: #{args[1]}", 31)
+    elsif !File.directory?(path)
+      puts color("cd: not a directory: #{args[1]}", 31)
+    else
+      Dir.chdir(path)
+    end
+    return
+  when 'exit','quit'
+    $child_pids.each { |pid| Process.kill("TERM", pid) rescue nil }
+    exit 0
+  when 'alias'
+    if args[1].nil?
+      $aliases.each { |k,v| puts "#{k}='#{v}'" }
+    else
+      arg = args[1..].join(' ')
+      if arg =~ /^(\w+)=([\"']?)(.+?)\2$/
+        $aliases[$1] = $3
+      else
+        puts color("Invalid alias format", 31)
+      end
+    end
+    return
+  when 'unalias'
+    if args[1]
+      $aliases.delete(args[1])
+    else
+      puts color("unalias: usage: unalias name", 31)
+    end
+    return
+  when 'help'
+    builtin_help
+    return
+  when 'systemfetch'
+    builtin_systemfetch
+    return
+  when 'jobs'
+    builtin_jobs
+    return
+  when 'pwd'
+    puts color(Dir.pwd, 36)
+    return
+  when 'hist'
+    builtin_hist
+    return
+  when 'clearhist'
+    builtin_clearhist
+    return
+  end
+
+  exec_external(args, stdin_file, stdout_file, append)
+end
+
+# ---------------- Chained Commands ----------------
+def run_input_line(input)
+  commands = input.split(/&&|;/).map(&:strip)
+  commands.each do |cmd|
+    next if cmd.empty?
+    run_command(cmd)
+  end
+end
+
+# ---------------- Prompt ----------------
+hostname = Socket.gethostname
+prompt_color = random_color
+
+def prompt(hostname, prompt_color)
+  "#{color(Dir.pwd,33)} #{color(hostname,36)}#{color(' > ', prompt_color)}"
+end
+
+# ---------------- Ghost + Completion Helpers ----------------
+def history_ghost_for(line)
+  return nil if line.nil? || line.empty?
+  HISTORY.reverse_each do |h|
+    next if h.nil? || h.empty?
+    next if h.start_with?("[completions:")
+    next unless h.start_with?(line)
+    next if h == line
+    return h
+  end
+  nil
+end
+
+def tab_completions_for(prefix, first_word, at_first_word)
+  prefix ||= ""
+
+  dir = "."
+  base = prefix
+
+  if prefix.include?('/')
+    if prefix.end_with?('/')
+      dir = prefix.chomp('/')
+      base = ""
+    else
+      dir = File.dirname(prefix)
+      base = File.basename(prefix)
+    end
+    dir = "." if dir.nil? || dir.empty?
+  end
+
+  file_completions = []
+  if Dir.exist?(dir)
+    Dir.children(dir).each do |entry|
+      next unless entry.start_with?(base)
+      full = File.join(dir, entry)
+
+      rel =
+        if dir == "."
+          entry
+        else
+          File.join(File.dirname(prefix), entry)
+        end
+
+      case first_word
+      when "cd"
+        next unless File.directory?(full)
+        rel = rel + "/" unless rel.end_with?("/")
+        file_completions << rel
+      when "cat"
+        next unless File.file?(full)
+        file_completions << rel
+      else
+        rel = rel + "/" if File.directory?(full) && !rel.end_with?("/")
+        file_completions << rel
+      end
+    end
+  end
+
+  exec_completions = []
+  if first_word != "cat" && first_word != "cd" && at_first_word && !prefix.include?('/')
+    path_entries = (ENV['PATH'] || "").split(':')
+    execs = path_entries.flat_map do |p|
+      Dir.glob("#{p}/*").map { |f|
+        File.basename(f) if File.executable?(f) && !File.directory?(f)
+      }.compact rescue []
+    end
+    exec_completions = execs.grep(/^#{Regexp.escape(prefix)}/)
+  end
+
+  (file_completions + exec_completions).uniq
+end
+
+def longest_common_prefix(strings)
+  return "" if strings.empty?
+  shortest = strings.min_by(&:length)
+  shortest.length.times do |i|
+    c = shortest[i]
+    strings.each do |s|
+      return shortest[0...i] if s[i] != c
+    end
+  end
+  shortest
+end
+
+def render_line(prompt_str, buffer, cursor, show_ghost = true)
+  buffer ||= ""
+  cursor = [[cursor, 0].max, buffer.length].min
+
+  ghost_tail = ""
+  if show_ghost && cursor == buffer.length
+    suggestion = history_ghost_for(buffer)
+    ghost_tail = suggestion ? suggestion[buffer.length..-1].to_s : ""
+  end
+
+  STDOUT.print("\r")
+  STDOUT.print("\e[0K")
+  STDOUT.print(prompt_str)
+  STDOUT.print(buffer)
+  STDOUT.print(color(ghost_tail, "2")) unless ghost_tail.empty?
+
+  move_left = ghost_tail.length + (buffer.length - cursor)
+  STDOUT.print("\e[#{move_left}D") if move_left > 0
+  STDOUT.flush
+end
+
+# --------- NEAT MULTI-COLUMN TAB LIST (bash-style) ----------
+def print_tab_list(comps)
+  return if comps.empty?
+
+  width = terminal_width
+  max_len = comps.map { |s| s.length }.max || 0
+  col_width = [max_len + 2, 4].max
+  cols = [width / col_width, 1].max
+  rows = (comps.length.to_f / cols).ceil
+
+  STDOUT.print("\r\n")
+  rows.times do |r|
+    line = ""
+    cols.times do |c|
+      idx = c * rows + r
+      break if idx >= comps.length
+      item = comps[idx]
+      padding = col_width - item.length
+      line << item << (" " * padding)
+    end
+    STDOUT.print("\r")
+    STDOUT.print(line.rstrip)
+    STDOUT.print("\n")
+  end
+  STDOUT.print("\r\n")
+  STDOUT.flush
+end
+
+def handle_tab_completion(prompt_str, buffer, cursor, last_tab_prefix, tab_cycle)
+  buffer ||= ""
+  cursor = [[cursor, 0].max, buffer.length].min
+
+  wstart = buffer.rindex(/[ \t]/, cursor - 1) || -1
+  wstart += 1
+  prefix = buffer[wstart...cursor] || ""
+
+  before_word = buffer[0...wstart]
+  at_first_word = before_word.strip.empty?
+  first_word = buffer.strip.split(/\s+/, 2)[0] || ""
+
+  comps = tab_completions_for(prefix, first_word, at_first_word)
+  return [buffer, cursor, nil, 0, false] if comps.empty?
+
+  if comps.size == 1
+    new_word = comps.first
+    buffer = buffer[0...wstart] + new_word + buffer[cursor..-1].to_s
+    cursor = wstart + new_word.length
+    return [buffer, cursor, nil, 0, true]
+  end
+
+  if prefix != last_tab_prefix
+    lcp = longest_common_prefix(comps)
+    if lcp && lcp.length > prefix.length
+      buffer = buffer[0...wstart] + lcp + buffer[cursor..-1].to_s
+      cursor = wstart + lcp.length
+    else
+      STDOUT.print("\a")
+    end
+    last_tab_prefix = prefix
+    tab_cycle = 1
+    return [buffer, cursor, last_tab_prefix, tab_cycle, false]
+  else
+    # Second tab on same prefix: show list (after erasing ghost on current line)
+    render_line(prompt_str, buffer, cursor, false)
+    print_tab_list(comps)
+    last_tab_prefix = prefix
+    tab_cycle += 1
+    return [buffer, cursor, last_tab_prefix, tab_cycle, true]
+  end
+end
+
+def read_line_with_ghost(prompt_str)
+  buffer = ""
+  cursor = 0
+  hist_index = HISTORY.length
+  saved_line_for_history = ""
+  last_tab_prefix = nil
+  tab_cycle = 0
+
+  render_line(prompt_str, buffer, cursor)
+
+  status = :ok
+
+  IO.console.raw do |io|
+    loop do
+      ch = io.getch
+
+      case ch
+      when "\r", "\n"
+        cursor = buffer.length
+        render_line(prompt_str, buffer, cursor, false)
+        STDOUT.print("\r\n")
+        STDOUT.flush
+        break
+      when "\u0003" # Ctrl-C
+        STDOUT.print("^C\r\n")
+        STDOUT.flush
+        status = :interrupt
+        buffer = ""
+        break
+      when "\u0004" # Ctrl-D
+        if buffer.empty?
+          status = :eof
+          buffer = nil
+          STDOUT.print("\r\n")
+          STDOUT.flush
+          break
+        else
+          # ignore when line not empty
+        end
+      when "\u007F", "\b" # Backspace
+        if cursor > 0
+          buffer.slice!(cursor - 1)
+          cursor -= 1
+        end
+        last_tab_prefix = nil
+        tab_cycle = 0
+      when "\t" # Tab completion
+        buffer, cursor, last_tab_prefix, tab_cycle, _printed =
+          handle_tab_completion(prompt_str, buffer, cursor, last_tab_prefix, tab_cycle)
+      when "\e" # Escape sequences (arrows, home/end)
+        seq1 = io.getch
+        seq2 = io.getch
+        if seq1 == "[" && seq2
+          case seq2
+          when "A" # Up
+            if hist_index == HISTORY.length
+              saved_line_for_history = buffer.dup
+            end
+            if hist_index > 0
+              hist_index -= 1
+              buffer = HISTORY[hist_index] || ""
+              cursor = buffer.length
+            end
+          when "B" # Down
+            if hist_index < HISTORY.length - 1
+              hist_index += 1
+              buffer = HISTORY[hist_index] || ""
+              cursor = buffer.length
+            elsif hist_index == HISTORY.length - 1
+              hist_index = HISTORY.length
+              buffer = saved_line_for_history || ""
+              cursor = buffer.length
+            end
+          when "C" # Right
+            if cursor < buffer.length
+              cursor += 1
+            else
+              suggestion = history_ghost_for(buffer)
+              if suggestion
+                buffer = suggestion
+                cursor = buffer.length
+              end
+            end
+          when "D" # Left
+            cursor -= 1 if cursor > 0
+          when "H" # Home
+            cursor = 0
+          when "F" # End
+            cursor = buffer.length
+          end
+        end
+        last_tab_prefix = nil
+        tab_cycle = 0
+      else
+        if ch.ord >= 32 && ch.ord != 127
+          buffer.insert(cursor, ch)
+          cursor += 1
+          hist_index = HISTORY.length
+          last_tab_prefix = nil
+          tab_cycle = 0
+        end
+      end
+
+      render_line(prompt_str, buffer, cursor) if status == :ok
+    end
+  end
+
+  [status, buffer]
+end
+
+# ---------------- Welcome ----------------
+def print_welcome
+  puts color("Welcome to srsh #{SRSH_VERSION} - your simple Ruby shell!",36)
+  puts color("Current Time:",36) + " " + color(current_time,34)
+  puts cpu_info
+  puts ram_info
+  puts storage_info
+  puts dynamic_quote
+  puts
+  puts color("Coded with love by https://github.com/RobertFlexx",90)
+  puts
+end
+
+print_welcome
+
+# ---------------- Main Loop ----------------
+loop do
+  print "\033]0;srsh-#{SRSH_VERSION}\007"
+  prompt_str = prompt(hostname, prompt_color)
+
+  status, input = read_line_with_ghost(prompt_str)
+
+  break if status == :eof
+  next  if status == :interrupt
+
+  next if input.nil?
+  input = input.strip
+  next if input.empty?
+
+  HISTORY << input
+
+  run_input_line(input)
+end

data/lib/srsh/version.rb

@@ -0,0 +1,4 @@
+# lib/srsh/version.rb
+module Srsh
+    VERSION = "0.6.0"
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: srsh
+version: !ruby/object:Gem::Version
+  version: 0.6.0
+platform: ruby
+authors:
+- RobertFlexx
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: srsh is a small Ruby-written interactive shell. It is its own shell and
+  does not wrap bash or sh.
+email:
+- robertwilliamnelson2008@gmail.com
+executables:
+- srsh
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/srsh
+- lib/srsh/version.rb
+homepage: https://github.com/RobertFlexx/RSH
+licenses:
+- Zlib
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: srsh – a simple Ruby shell.
+test_files: []