Terminal session persistence with scrollback. Nothing more.

Zig 100%

Find a file

Eric Seuret d49cecbdf5 Simple Relay mostly functional Added: - Barebones Buffer - Winsize management...		2025-12-19 14:43:21 +01:00
src	Simple Relay mostly functional	2025-12-19 14:43:21 +01:00
.gitignore	Initial commit	2025-10-18 15:10:55 +02:00
build.zig	First prototype	2025-12-16 15:10:26 +01:00
build.zig.zon	First prototype	2025-12-16 15:10:26 +01:00
LICENSE	Readme created as an intention and general requirements	2025-10-18 23:28:59 +02:00
README.md	Readme created as an intention and general requirements	2025-10-18 23:28:59 +02:00

README.md

attaché

Your terminal attaché.

Session persistence with scrollback. No magic.

What it does

Like dtach, but remembers what happened while you were away.

Maintains a circular buffer of your session's output. When you reconnect, you see the recent history. Everything else stays out of your way.

Usage

# Create or attach to a session
attache attach mywork

# List sessions
attache list

# Detach from inside a session
attache detach

That's it.

Keybindings Only two keybindings.

C-\ . -> detach from session
C-\ C-\ -> send literal C-\ to your session

Easy to learn. You know it already.

C-\ was chosen deliberately. It sends SIGQUIT in POSIX systems and that's actually perfect. Because it has special OS-level meaning, applications avoid binding it, giving us a stable prefix that won't conflict with shells, editors, or TUIs. Other prefix keys like C-a (screen, readline) or C-b (tmux, readline) break everyday shell editing. C-\ doesn't. And when you need the actual SIGQUIT? Just press C-\ C-\.

No configuration means consistency everywhere. Always. This matters especially on remote and embedded devices where multiple users connect to the same system. Everyone sees the same behavior, no surprises, no per-user configs to sync or troubleshoot.

Why Terminal multiplexers break modern terminal protocols. Minimal tools

like dtach don't keep history. This does both: minimal design, with memory.

Created with Zig as an excuse to learn it.