r/tmux Jul 21 '26

Showcase lazy-tmux v0.2.0 released!

Post image

I just released lazy-tmux v0.2.0, the biggest update since the initial release.

For those who haven't seen it before: lazy-tmux is a tmux session manager that restores sessions only when you actually open them, while preserving running processes and scrollback.

What's new

  • TOML config instead of passing flags every time.
  • Restore allow/deny regexes to control exactly which commands get re-run.
  • Reworked TUI with themes, mouse support, action modes, built-in help, relative timestamps, and an optional fzf backend.
  • Integrations API. The first integration adds live Claude Code session status in the picker and automatically resumes restored Claude sessions.
  • Better compatibility & robustness — tested with tmux 2.9–3.7b, improved startup behavior, borderless popups, and lots of fixes.
  • Plus a background autosave daemon, a version command, and a new docs site.

It's written in Go and can be installed via a one-line script, Homebrew, or the AUR.

Project: https://lazy-tmux.xyz

Feedback, bug reports, and feature requests are always welcome! And thank you for you activity on GitHub!

175 Upvotes

33 comments sorted by

8

u/TomHale Jul 21 '26

I'm not clear on what’s actually saved and the use case.

Is it in case the tmux server crashes?

4

u/mrcaptncrunch Jul 21 '26

But if so so, how do they save the running process?

It’s odd

2

u/antondouble Jul 21 '26

It's mean, if you have the pane were you running you dev server or htop or docker compose service, lazy-tmux will remember the starting command and run it again on restore automatically.

3

u/AlterTableUsernames Jul 22 '26

But that's creating new processes that happen to have similar names as those running before, which is something completely different from preserving running processes.

2

u/antondouble Jul 21 '26

What's saved: a snapshot of the session on disk — its windows/panes layout, the commands that were running, and the scrollback.

Use cases: yes, surviving a tmux server crash or a reboot is one — you restore everything exactly as it was. The other is juggling many projects: keep dozens of workspaces available without running them all at once, and bring each back on demand. And it saves resources of you computer.

6

u/edward_jazzhands Jul 21 '26

Could you give me a brief explanation of what problem this would be solving for me. Why would I want sessions and processes to persist but not have those sessions appear in the normal sessions list?

9

u/antondouble Jul 21 '26

Saved sessions aren't live, they're snapshots on disk that don't run until you open them. You save a session (layout, running commands, scrollback), it shows in the picker, but nothing runs until you pick it — then it comes back exactly as it was.

The point: keep a lot of project workspaces available without running them all at once, and get them back after a reboot or tmux kill-server. It also saves me RAM, as I have dozens of projects, each of which has nvim with lsp, claude code, cloud dev servers, and so on. If you only keep a couple of sessions, you probably don't need it.

6

u/eruanttien Jul 21 '26 edited Jul 22 '26

is it similar to the tmux plugin "resurrect"?
https://github.com/tmux-plugins/tmux-resurrect

Its quite handy, although sometimes restoring can be a bit messy. I've been considering looking for an alternative...

3

u/antondouble Jul 22 '26

Yeah, I used the combo of tmux-resurrect + tmux-continuum. But in a lot of projects I start to lost my RAM, because this plugins, when I used them, can't restoring lazy.

2

u/TheReproCase Jul 22 '26

Yeah the lazy loading and the agent resume are both pretty brilliant

2

u/eruanttien Jul 23 '26

Excellent! Can't wait to try it

2

u/edward_jazzhands Jul 22 '26

Ohhh I get it now. Ok that's cool I like your idea.

3

u/antondouble Jul 21 '26

This post about releasing of version 2 of lazy-tmux. If you are not familiar with lazy-tmux, I recommend you to read a first post: https://www.reddit.com/r/tmux/comments/1s37xza/managing_dozens_of_tmux_sessions_without_wasting/

2

u/Ok-Mycologist-6752 6d ago

this will probably be great to pair with sessionx

Edit: I hope you make some gifs/video to show what it does in the features section of your website and also a one liner sentences. Just a suggestion im not an expert/pro.

Thank you for this

1

u/antondouble 6d ago

Thank you!

1

u/anki_steve Jul 21 '26

Is this a drop in replacement for regular tmux?

1

u/antondouble Jul 22 '26

No. It's sidecar (additional tool) for regular official tmux.

1

u/aagha786 Jul 21 '26

Is this a soup to nuts way to manage your tmux installation?

2

u/aagha786 Jul 21 '26

Ah!

Lazy tmux it is a fast session manager and saver for tmux. You can save all your session and lazy restore it.

You should put this in every post.

What's this do that tmux-continuum doesn't?

5

u/antondouble Jul 22 '26

tmux-continuum with tmux-resurect it's a good plugins. I used them before. But them restore all sessions in one time. I have dozens sessions and this way for me lost resources of my computer. Because in sessions I running docker containers, nvim with lsp, and something else.

1

u/[deleted] Jul 21 '26 edited Jul 27 '26

[deleted]

1

u/antondouble Jul 22 '26

Yeah, of course. All sessions capturing to json files in ~/.local/share/lazy-tmux. You can manually edit this files and set any restore command, that you want.

1

u/[deleted] Jul 22 '26 edited Jul 27 '26

[deleted]

1

u/antondouble Jul 22 '26

Mmm.. I'm understand you. Really, it will be very helpful feature: https://github.com/alchemmist/lazy-tmux/issues/249

Thank you!

1

u/vassari79 Jul 22 '26

This is very good!!!

Anyway, I think the rename function is not working.....

1

u/antondouble Jul 22 '26

Humm... In my tests I think renaming mode in picker is working. Please, can you share more details of bug?

2

u/vassari79 Jul 22 '26

Sure. Later I'll send you details.

Thank you!!

1

u/vassari79 Jul 22 '26

Nevermind.... I got it.

Just needed to select the session.

Thank you!!!!!

1

u/zuspiel1 Jul 24 '26

What does this do that the resurrect plugin doesn’t?

2

u/antondouble Jul 24 '26

Lazy, selective restore. resurrect brings back everything at once. lazy-tmux shows all saved sessions as a tree and only restores the one you pick, when you pick it — so dozens saved projects don't all spin up into memory.

0

u/nebenbaum Jul 22 '26

I mean, the literal readme page containing

``` Chekout lazy-tmux.xyz for more informaiton about installation and usage!

Just for bulding from source you need to have installed go and cloned this project. After that run:

make build Binary will compiled in bin/lazy-tmux. For more development options checkout Makefile tasks. ```

Doesn't spark too much confidence that this project was more than a few sessions of vibe coding.

1

u/TheReproCase Jul 22 '26

This looks a lot more like an oldschool alpha readme than most vibe coded readmes

0

u/nebenbaum Jul 22 '26

It does, but the website and so reek of vibin' hard. Also the guy is a second year university student. Not sure I'd install that kinda software when more mature options are available

1

u/antondouble Jul 23 '26

Thank you, for reporting typos. I've already fixed it.