Python-Native Automation Platform
PySH is not a Bash clone. It is a complete Python automation platform combining an interactive shell, scripting environment, plugin runtime, and DevOps tooling.
What Is PySH
PySH is a Python-native automation platform designed for developers, system administrators, and DevOps engineers. It provides an interactive shell where Python is the primary automation language.
PySH 0.8.2 | Python 3.13.5 | GPL-2.0-only
System: Debian GNU/Linux 13 | Kernel 6.12.90
Type 'exit' or press Ctrl+D to quit.
🐍 ssobol@sun – [~]
py3.13 · uv0.11.17 · ruff0.15.15
╰─❯ #py
PySH Python Command Execution Layer
Python 3.13.5
>>> from pathlib import Path
>>> list(Path('.').iterdir())
[PosixPath('scripts'), PosixPath('.env'), ...]
Real PySH in Action
PySH shell prompt
Python Command Execution Layer
Block execution mode
PyPI package page
TOML Configuration
PySH is configured with readable TOML. Control your prompt theme, plugin list, history settings, and environment in one clean file.
[prompt]
theme = "modern"
show_python = true
show_tools = true
show_directory = true
[history]
size = 10000
deduplicate = true
[plugins]
enabled = [
"git",
"docker",
"python"
]
Platform Capabilities
Interactive Shell
Full-featured interactive shell with history, completion, and modern prompt design.
Python Execution Layer
Enter Python-mode from the shell. Interactive REPL or multi-line block execution.
Plugin System
Extend PySH with Python packages. Git, Docker, AWS, monitoring — each as a clean module.
TOML Configuration
One readable TOML file controls the entire platform. No cryptic dotfiles.
Safe Automation
Python scripts are readable, testable, and auditable. Built-in safety patterns.
ECLI Integration
Integrates with ECLI engineering workspace for editing, navigation, and AI-assisted workflows.