HomeToolszy shell live · sandbox
Disconnected
user@ubuntu · pty (sandbox)

Launch a sandboxed shell.

A real zy process boots in an ephemeral Debian container. No persistence. No outbound network. Up to 10 minutes per session.

Checking sign-in…
Live · Cloud Run · Sandboxed

zy shell

A modern shell runtime written in C. POSIX scripting, structured data pipelines, policy/audit controls, and 370+ built-ins, running for real in a Debian sandbox. Sessions cap at 10 minutes; each one is ephemeral.

Releasesiskandarputra/zyshellDocsproject / zy-shell
Run it locallyLinux · amd64

The sandbox here is throttled. For unlimited use, install the .deb on your Linux machine.

curl -L github.com/iskandarputra/zyshell/releases/latest/download/zy_amd64.deb -o zy.debsudo apt install ./zy.debzy
Download from GitHub
Cheatsheet

Customize the shell

customize
Interactive setup wizard
config
Manage shell configuration
set-theme <name>
Apply a color theme
alias l = ls -al
Define a shortcut
unalias l
Remove an alias

Pipelines & filters

ls | where size > 1mb
Filter rows by predicate
ls | sort-by size
Sort table by column
ls | first 5
Take first N rows
ls | select name size
Pick columns
ls | length
Count rows
[1 2 3] | each { $it * 2 }
Apply closure per item
ls | reduce { $acc + $it }
Fold with accumulator

Data formats

open file.json
Auto-parse JSON / CSV / TOML
ls | to-json
Convert table to JSON
$x | from-csv
Parse CSV from a string
$x | describe
What type is this?

Environment

env-list
All env vars as a table
$env.HOME
Structured env access
with-env { PATH: $p } { … }
Scoped environment block
env-save dev
Snapshot current env as 'dev'
env-restore dev
Restore a snapshot

Navigation

cd <dir>
Change directory
cd ...
Up two levels (… = ../..)
z <query>
Smart jump (frecency + fuzzy)
z @<name>
Jump to a bookmark
z --pin <name>
Bookmark current dir as @name
zi [query]
Interactive fuzzy picker

Variables

let x = 5
Bind value (records, lists, spread)
mut y = 1
Mutable bind
const PI = 3.14
Immutable constant
$in
Pipeline input value
$it
Current item in a closure

Help & meta

help
Categorised list of all built-ins
help <cmd>
Detail page for one command
zy --version
Build info
debug-info
Diagnostic dump for issues

Type help in the shell for the full catalogue.