Termy → Tutorial → Sessions & tabs

Sessions & tabs

Every tab is a real terminal in a real folder. Termy's job is making sure the right ones exist and none of them are lost.

Where tabs come from

• Your editors. Every project open in Xcode, VS Code or Cursor becomes a tab. Close the project and the tab stays until you close it.
• Drag and drop. Drop a folder on the notch or on the menu bar icon.
• From Finder. Right-click a folder → Services → Open in Termy. From a terminal: open -a Termy ~/Projects/app.
• By hand. ⌘T for a plain terminal, or Open Folder… in the menu.

Above the terminal, a links bar lists the local servers a session started (click to open) and the files its agent edited (Quick Look, open, or show in Finder). Hover a path in the terminal for its Quick Look and Finder buttons.

The dot on each tab tells you whether the project is still open in your editor. Right-click a tab to rename it, restart it, open it in split view, or close it.

Conversations that survive

Termy remembers which conversation each tab was running, in Claude Code or Codex. Quit Termy, restart your Mac, install an update — when the tab comes back, it runs claude --resume (or codex resume) and picks the conversation up where it stopped.

The same applies when things go wrong. If the agent crashes, Termy restarts it with the conversation intact rather than leaving you a dead tab. It tries up to three times, then leaves it alone so a broken setup doesn't restart forever. Turn it off in Settings → Agent.

When a session really has ended, the tab offers two buttons: Resume conversation, which continues where you were, and Start fresh, which begins a new one in the same folder.

Every Claude session on your Mac, not just Termy's

You don't only run Claude in Termy. There's the one in iTerm, the one your editor started, the one you kicked off from your phone. Termy watches those too.

Right-click the menu bar icon and they're listed in the Sessions tab under Running elsewhere, each with its folder, a dot showing whether it's working, and a phone icon if it's connected to Claude's remote control. Click one and Termy takes it over in a tab, resuming the conversation.

Because Termy knows about them, the notch tells the truth: if any agent on your Mac is working, the notch is spinning — not just Termy's own. Turn it off in Settings → General → Detection.

Finding an old conversation

Right-click the menu bar icon and choose Check Available Sessions… for every Claude conversation on your Mac, newest first. Each row shows its title, the folder it ran in, and the exact claude --resume command.

• Resume opens it in a Termy tab.
• Copy puts cd <folder> && claude --resume <id> on your clipboard, for your own terminal.
• A green or orange dot means that conversation is running right now; the phone badge means you can drive it from the Claude app.

Can't remember what you called it? Tick Search inside conversations and type a few words you remember saying. Termy searches the full text of every transcript and shows you the matching line. It takes a few seconds over a large history — worth it when you're hunting for that one fix from three weeks ago.

Split view

Press ⌘D to put two sessions side by side, or right-click a tab and choose Open in Split View. Click a pane to give it the keyboard. ⌘⇧D closes the split. (Pro.)