Terminal panes, instantly.
Zero-config terminal multiplexer with session persistence and tmux-compatible keys.

English | 한국어 | 日本語 | 中文 | Español | Français

$ ezpn                # split your terminal, instantly
$ ezpn 2 3            # 2x3 grid of shells
$ ezpn -l dev         # preset layout

No config files, no setup, no learning curve. Sessions persist in the background — Ctrl+B d to detach, ezpn a to come back.

In a project, drop .ezpn.toml in your repo and run ezpn — everyone gets the same workspace:

[workspace]
layout = "7:3/1:1"

[[pane]]
name = "editor"
command = "nvim ."

[[pane]]
name = "server"
command = "npm run dev"
restart = "on_failure"

[[pane]]
name = "tests"
command = "npm test -- --watch"

[[pane]]
name = "logs"
command = "tail -f logs/app.log"

$ ezpn   # reads .ezpn.toml, starts everything

No tmuxinator. No YAML. Just a TOML file in your repo.

cargo install ezpn

git clone https://github.com/subinium/ezpn
cd ezpn && cargo install --path .

ezpn                  # 2 panes (or load .ezpn.toml if present)
ezpn 2 3              # 2x3 grid
ezpn -l dev           # Layout preset (dev, monitor, quad, stack, trio...)
ezpn -e 'cmd1' -e 'cmd2'   # Per-pane commands

Ctrl+B d               # Detach (session keeps running)
ezpn a                 # Reattach to most recent session
ezpn a myproject       # Reattach by name
ezpn ls                # List active sessions
ezpn kill myproject    # Kill a session

Ctrl+B c               # New tab
Ctrl+B n / p           # Next / previous tab
Ctrl+B 0-9             # Jump to tab

All tmux keys work — Ctrl+B % to split, Ctrl+B x to close, Ctrl+B [ for copy mode.

ezpn -l dev       # 7:3 — main + side
ezpn -l ide       # 7:3/1:1 — editor + sidebar + 2 bottom
ezpn -l monitor   # 1:1:1 — 3 equal columns
ezpn -l quad      # 2x2 grid
ezpn -l stack     # 1/1/1 — 3 stacked rows
ezpn -l main      # 6:4/1 — wide top pair + full bottom
ezpn -l trio      # 1/1:1 — full top + 2 bottom

Custom ratios: ezpn -l '7:3/5:5'

Drop .ezpn.toml in your project root and run ezpn. That's it.

Per-pane options: command, cwd, name, env, restart (never/on_failure/always), shell

ezpn init              # Generate .ezpn.toml template
ezpn from Procfile     # Import from Procfile

border = rounded        # single | rounded | heavy | double | none
shell = /bin/zsh
scrollback = 10000
status_bar = true
tab_bar = true
prefix = b              # prefix key (Ctrl+<key>)

Direct shortcuts:

Prefix mode (Ctrl+B, then):

split / split-window         Split horizontally
split -v                     Split vertically
new-tab / new-window         Create new tab
next-tab / prev-tab          Switch tabs
close-pane / kill-pane       Close active pane
close-tab / kill-window      Close current tab
rename-tab <name>            Rename tab
layout <spec>                Change layout
equalize / even              Equalize pane sizes
zoom                         Toggle zoom
broadcast                    Toggle broadcast mode

Three claims, each measurable in an afternoon. Reproduce them on your own workload before you trust them.

Beyond the numbers:

• Zero-config defaults. Every tmux key works on a fresh install. No .tmux.conf, no plugin manager.
• TOML, not a YAML satellite. .ezpn.toml lives in your repo; everyone gets the same workspace without gem install tmuxinator.
• OSC 52 paste-injection guard. cat hostile.log cannot silently overwrite your clipboard (clipboard.md, security.md).
• Frozen wire protocol. docs/protocol/v1.md commits to SemVer on the IPC surface — your scripts won't break across a minor bump.

Trade-offs you should weigh before switching:

• No plugin system. tmux's plugin ecosystem is 10+ years deep; ezpn's is empty.
• No pipe-pane, no command-alias, no if-shell. Use [[hooks]] and the event bus instead.
• Linux + macOS only. No Windows.

Full migration walkthrough: docs/migration-from-tmux.md.

Choose ezpn if you want terminal splits that just work. Choose tmux if you need deep scripting and plugin ecosystem. Choose Zellij if you want a modern UI with WASM plugins.

ezpn [ROWS COLS]         Start with grid layout
ezpn -l <PRESET>         Start with layout preset
ezpn -e <CMD> [-e ...]   Per-pane commands
ezpn -S <NAME>           Named session
ezpn -b <STYLE>          Border style (single/rounded/heavy/double/none)
ezpn a [NAME]            Attach to session
ezpn ls                  List sessions
ezpn kill [NAME]         Kill session
ezpn rename OLD NEW      Rename session
ezpn init                Generate .ezpn.toml template
ezpn from <FILE>         Import from Procfile

• Getting started — 5-minute tour
• Migration from tmux — key-by-key, command-by-command
• Configuration — full config.toml + .ezpn.toml reference
• Scripting — ezpn-ctl, events, ls --json
• Clipboard — OSC 52, fallback chain, SSH gotcha
• Terminal protocol — what ezpn passes through, intercepts, modifies
• Security — threat model and defaults
• IPC wire protocol v1 — frozen at v1.0

MIT