repos / zmx

session persistence for terminal processes
git clone https://github.com/neurosnap/zmx.git

zmx / docs
Eric Bower  ·  2025-12-10

index.html

 1<!DOCTYPE html>
 2<html>
 3  <head>
 4    <title>zmx - session persistence for terminal processes</title>
 5    <meta charset="utf-8">
 6    <meta name="viewport" content="width=device-width, initial-scale=1">
 7    <meta name="keywords" content="pico, pico.sh, hacker, labs, services">
 8    <meta name="description" content="session persistence for terminal processes">
 9    <link rel="stylesheet" href="https://pico.sh/smol.css">
10  </head>
11  <body class="container" style="max-width: 35rem;">
12    <nav style="padding: 1.3rem;">
13      <div class="flex flex-wrap items-center justify-center gap-2" style="margin-right: 20px;">
14        <div class="group-h" style="gap: 0.25rem;">
15          <svg width="22" height="22" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg">
16            <line x1="18" y1="83.0002" x2="84" y2="83.0002" stroke="white" stroke-width="12" stroke-linecap="round"/>
17            <line x1="18" y1="16" x2="84" y2="16" stroke="white" stroke-width="12" stroke-linecap="round"/>
18            <path d="M83 16.8901L18 83.0731" stroke="white" stroke-width="12" stroke-linecap="round"/>
19            <line x1="6" y1="-6" x2="100.118" y2="-6" transform="matrix(-0.706762 -0.707452 0.716069 -0.698029 93 83.0735)" stroke="white" stroke-width="12" stroke-linecap="round"/>
20          </svg>
21          <a href="/" class="link-alt">
22            zmx
23          </a>
24        </div>
25        <a href="https://github.com/neurosnap/zmx" class="link-alt">
26          src
27        </a>
28        <a href="https://bower.sh/?tag=zmx" class="link-alt">
29          blog
30        </a>
31        <a href="https://web.libera.chat/gamja?autojoin=#pico.sh" class="link-alt">
32          irc
33        </a>
34      </div>
35    </nav>
36
37    <div class="text-center my-4">
38      <h1 class="text-2xl">zmx</h1>
39      <div>session persistence for terminal processes</div>
40    </div>
41
42    <h2 class="text-lg">features</h2>
43    <ul>
44      <li>Persist terminal shell sessions (pty processes)</li>
45      <li>Ability to attach and detach from a shell session without killing it</li>
46      <li>Native terminal scrollback</li>
47      <li>Mlitiple clients can connect to the same session</li>
48      <li>Re-attaching to a session restores previous terminal state and output</li>
49      <li>Works on mac and linux</li>
50      <li>This project does NOT provide windows, tabs, or splits</li>
51    </ul>
52
53    <h2 class="text-lg">install</h2>
54
55    <h3 class="text-md">binaries</h3>
56    <ul>
57      <li><a href="/a/zmx-0.1.0-linux-aarch64.tar.gz" download>zmx-0.1.0-linux-aarch64.tar.gz</a></li>
58      <li><a href="/a/zmx-0.1.0-linux-x86_64.tar.gz" download>zmx-0.1.0-linux-x86_64.tar.gz</a></li>
59      <li><a href="/a/zmx-0.1.0-macos-aarch64.tar.gz" download>zmx-0.1.0-macos-aarch64.tar.gz</a></li>
60      <li><a href="/a/zmx-0.1.0-macos-x86_64.tar.gz" download>zmx-0.1.0-macos-x86_64.tar.gz</a></li>
61    </ul>
62
63    <h3 class="text-md">homebrew</h3>
64    <pre>brew tap neurosnap/tap
65brew install zmx</pre>
66
67    <h2 class="text-lg">posts</h2>
68    <ul>
69      <li><a href="https://bower.sh/zmx-session-persistence">zmx - session persistence for terminal processes</a></li>
70      <li><a href="https://bower.sh/you-might-not-need-tmux">You might not need tmux</a></li>
71    </ul>
72  </body>
73</html>