PySH Documentation

What PySH is and when to use it.

Install PySH with pip or uv on Linux, macOS, and WSL2.

Your first PySH session — interactive shell and #py mode.

Set up .pysh.toml for prompt, history, and plugin preferences.

How the Python Command Execution Layer works inside PySH.

Enter #py to switch to a Python REPL inside PySH.

Write and run multi-line Python blocks with #pyblock.

Run Python scripts directly from the PySH command line.

Complete reference for all PySH configuration options.

Customize the PySH shell prompt with themes and settings.

Configure history size, deduplication, and storage.

Prompt theme options and custom theme configuration.

How the PySH plugin system works.

Structure and anatomy of a PySH plugin package.

Step-by-step guide to building a PySH plugin.

Publish your PySH plugin to PyPI.

Common Python scripting patterns used in PySH.

pathlib, shutil, and os patterns for file operations.

subprocess, asyncio, and process control patterns.

Python replacements for grep, sed, and awk.

Python scripts for git workflows and release management.

Docker container and image management with Python.

HTTP requests, API calls, and REST automation patterns.

Use PySH scripts in CI/CD pipeline automation.

Introduction to the ECLI engineering workspace.

Integrated development workflow with PySH and ECLI.

Frequently encountered issues and their resolutions.

Running PySH on Windows via WSL2.

Diagnosing and fixing plugin load and runtime errors.