lmux docs

lmux is a light, native macOS terminal for living in Claude Code and Codex all day. It's a 25 MB app on libghostty with a sidebar of workspaces and splits in any direction. It shows which agent is running, done or waiting for you, lets you take back a prompt you sent to the wrong session, and brings every session back after a relaunch. It never wraps claude or codex. It only listens to their hooks and reads the files they already write.

Pick your path#

New to lmuxInstall it, say yes to the hooks, run claude in a pane.Install → Coming from cmuxOne click brings over your theme, fonts, shortcuts and open workspaces.Switching from cmux → Coming from Ghostty or tmuxYour Ghostty config is read as is. Workspaces and splits replace tmux sessions.Configuration →

Let your agent set it up#

Already in Claude Code or Codex? Paste this, and it reads the agent guide (one plain Markdown file) and walks you through installing and setting up lmux:

Help me set up lmux. Read https://lmux.dev/agent-guide.md first, then walk me through it step by step.

What's in here#

Start: Install, then Quick start for the first launch and five things to try.
Using lmux: Workspaces & panes, every shortcut, configuration and Korean input.
Moving in: how lmux compares to cmux, and moving over from cmux in one click.
Agents: Claude Code (status, rewind, History), Codex, other agents and the lmux CLI.
Reference: performance, privacy and every file lmux writes, troubleshooting and the FAQ.