Home

🐚 Pysh

Pysh is a cross-platform shell and Python REPL hybrid supporting tab completion, concurrent pipeline chaining, redirection, and more.

It behaves like a basic shell and a live Python interpreter, all in one terminal.

CodeBerg: Mirror

---

🔀 Dual Nature

🖥 Pysh as a Shell

$ cd
$ pwd
/home/user

$ echo \
> hi \
> out

$ tail -f out |
> head -n 1 |
> wc
      1       1       3

$ ls | 
> grep "p" &&
> echo "done"
Pipfile
Pipfile.lock
pysh
done

Note: On Windows, tab completion should always be used with commands because executables do not work without their file extensions.

---

🐍 Pysh as Python

$ import os

$ 2 + 2
4

$ def greet(name):
>     print("Hello", name)
> 
$ greet("World")
Hello World

$ l = [i * i for i in range(input("n: ")]
n: 5
$ l
[0, 1, 4, 9, 16]

$ path = os.path.join(os.getcwd(), "test.txt")
$ path
/home/user/test.txt

---

✨ Features & Traits

Feature	Description
Tab Completion	Auto-completes commands and builtins; supports Windows cmdlets and aliases
Multiline Input	Supports input continuation using quotes, brackets, line-end \, and colons
Command Chaining	Pipeline (|) support with proper tokenization and cross-command piping
Logical Operators	Supports \&\&, ||, and background \& operations
Persistent History	Session history saved and loaded via readline
Output Redirection	Supports >, 2>, \&>, >> and variations for redirection and append
Quoted Argument Parsing	Custom tokenizer preserves quotes and handles escape sequences
Variable Substitution	Expands $VAR and ${VAR} within commands using current environment
Built-in Commands	Implements shell builtins: cd, pwd, echo, exit, history, type, etc.
Synchronous Execution	Avoids subprocess/thread complexity; all commands run in a single event loop
Portable Architecture	Uses only os, readline, and subprocess; no third-party libraries
Windows Compatibility	Recognizes and runs PowerShell cmdlets and aliases natively via $PATH

---

⚙️ Built-in Shell Commands

Command	Description
cd	Change directory
echo	Print text
exit	Exit shell
pwd	Print current working directory
history	View or manage command history
type	Identify command type (builtin, bin)
env	Show environment variables
unset	Remove environment variables

---

📦 Installation

Option 1: Via pip (Recommended)

pip install git+https://codeberg.org/zz/PySh

Option 2: Manual

• Download pysh/main.py
• Double-click to run it, or launch via terminal:

python pysh/script.py

---

🤝 Contributions

Pull requests, suggestions, and issue reports are welcome!