pyshell --version
Shows current PyShell version, Python version and host info.
$
pyshell --versionPYSHELL v0.3.3-alpha • TERMINAL HELP
>_ PyShell commands
Fast, Python-powered shell — native on Windows, Linux & macOS. 24 cross-platform built-ins with powerlevel10k themes + format presets, pipes, redirections, and history. Unix-only tools removed — here’s everything that works everywhere.
24CROSS-PLATFORM COMMANDS
100%WINDOWS • LINUX • MACOS
2FUN BUILT-INS (rps, world)
PyShell core
Meta commands — themes like powerlevel10k, format presets, config, version
11 commandspyshell quit
Quits PyShell cleanly. Aliases: quit, exit, q.
$
pyshell quitpyshell config
Opens pyshell_config.json in your default editor (or prints its path).
$
pyshell configpyshell --refresh / -r
Reloads pyshell_config.json after manual edit — like source for config. Syncs preset→format & theme→banner_color. Aliases: pyshell refresh, refresh, ref, reload.
$
pyshell --refreshpyshell -rrefrefresh
help
Shows this help listing. Aliases: ?, h.
$
helphistory
Shows last 100 commands from ~/.pyshell_history.
$
historytheme [list|set|preview]
Manage themes — 13 presets: dark, light, dracula, nord, monokai, solarized, matrix, ocean, sunset, neon, p10k, p10k_lean, p10k_rainbow — powerlevel10k-like. Custom via appearance.custom_colors.
$
theme listtheme set draculatheme set p10ktheme preview p10k_rainbow
pyshell theme [list|set]
Same as theme but via pyshell prefix. Persists to pyshell_config.json (appearance.theme + banner_color).
$
pyshell theme set p10kp10k configure
Powerlevel10k wizard — like p10k configure. Asks powerline, style (classic/lean/rainbow), icons, then sets p10k family. Aliases: p10k, powerlevel10k, theme configure.
$
p10k configurep10k — wizardtheme set p10k_lean
format [list|set|preview]
Prompt format presets — classic ({user}@{host} {cwd} $>), pure ({cwd} ❯), minimal, two-line, git, nerd, compact, full, p10k ({p10k}), powerline. Placeholders: {user} {host} {cwd} {git} {p10k}.
$
format set pureformat preview pureformat set two-lineprompt alias
prompt / pyshell prompt
Aliases for format. prompt, pyshell prompt, pyshell format all manage prompt.format + git_branch. Custom: format set "{user}@{host} {cwd} $> ".
$
prompt set nerdNavigation & system
Move around and inspect the system — works on Windows, Linux & macOS
7 commandsls [path]
List directory contents. Colors dirs in cyan, executables in green. Supports ~, -, and quoted paths.
$
ls ~/Documentsls .ls "My Folder"
cd [path]
Change directory. No args → home (~ on Linux, C:\ on Windows). Supports ~, -, and /home/$USER.
$
cd ~/Projectscdcd -cd ~
pwd
Print working directory.
$
pwdclear
Clear the terminal screen. Alias: cls.
$
cleartime
Show current time, date, weekday and timezone.
$
timewhoami
Print current logged-in user.
$
whoamihostname
Print system hostname.
$
hostnameFile operations
Cross-platform tools — pipes & redirections fully supported
4 commandscat <file>
Show file contents. Works with pipes: cat file | grep pat.
$
cat notes.txtecho [-neE] [text]
GNU echo. Use "" to print. Supports \n \t \\ \xHH \0NNN with -e. Redirections: > >>.
$
echo -e "line1\nline2"-n no newline-e escapes-E no escapes-- end opts
mkdir [-pv] <dir>
Create directory. -p creates parents, -v prints creation.
$
mkdir -p projects/demo-p parents-v verbose
rmdir <dir>
Remove empty directory only. For non-empty use rm -r.
$
rmdir empty_dirFun & extras
Built-ins for when you’re bored
2 commandsrps
Play Rock Paper Scissors against PyShell. Runs until you type quit.
$
rpsworld
CLI Open World — 6 maps unlock by LVL: plains0 8×6, desert1 12×7, islands2 14×6, forest3 10×10, mountain4 9×8, dungeon5 6×6. Auto-saves to world_save.dat (encoded, hidden, game-only) on Q. Controls WASD/arrows (fixed right arrow), J stats, L look, M maps, N/P next/prev, 1-6 travel, Q quit. Edge walk → N prompt. Aliases: openworld, cli-open-world, ow.
$
world --map desertworld --list-mapsworld --map forestworld --statsM mapsN/P travel
No commands found
Try a different term — e.g. cp or grep
Real .sh power — themes, chaining, pipes & redirections
Try theme list, theme set dracula, theme preview nord, pyshell --refresh/ref after editing pyshell_config.json. Shell: ls | grep py > out.txt, echo "hi" >> log, VAR=hello echo $VAR,
cat file | grep TODO -n, cmd && echo ok || echo fail and source script.sh. Use $? $$ $HOME ${VAR:-default} and globs like *.py.