Extension Icon

Tmux Sessioner

Quick Tmux Session Switcher
AvatarLouis
3,592 Installs
Overview

Tmux Sessioner

Description

This is a extension for raycast to manage tmux sessions.

Features

  • Switch between sessions ๐Ÿ”„
  • Switch between windows ๐Ÿ”„
  • Attach to sessions/windows automatically with setup terminal ๐Ÿ–ฅ
  • Attach to sessions automatically with setup terminal ๐Ÿ–ฅ
  • Open sessions in a new terminal tab or window ๐ŸชŸ
  • Create new sessions ๐Ÿ†•
  • Bootstrap project sessions: create a folder and run a startup command in one go ๐Ÿš€
  • Delete sessions ๐Ÿ—‘
  • Kill multiple sessions at once ๐Ÿงน
  • Search commands and output across all sessions' scrollback ๐Ÿ”
  • Save all sessions on demand for tmux-resurrect / continuum ๐Ÿ’พ
  • Rename sessions ๐Ÿ“

Saving sessions on demand

The Save Tmux Sessions command forces a tmux-resurrect save immediately โ€” handy when you want to be sure everything is persisted before shutting down. It runs the same save as prefix + Ctrl-s, reading the script path from resurrect's own @resurrect-save-script-path option, so there is nothing to configure here. tmux-resurrect must be installed and configured; if you also run tmux-continuum this command is the way to save on demand without waiting for its next interval, and it never conflicts with continuum's automatic saves (it's the same save). If resurrect isn't set up, the command says so instead of failing.

Searching session output

Search Session Output greps the scrollback of every pane in every session, so you can find that command you ran or error you saw without remembering which session it was in. Matches are grouped by session with surrounding context; press โŽ to switch there, or open it in a new terminal tab. Tip: raise tmux's history-limit (e.g. set -g history-limit 50000) to search further back.

Bootstrapping project sessions

Create New Session can go beyond switching directories:

  • Create New Folder: creates <New Session Default Directory>/<name> and starts the session inside it. Enable it per-launch in the form, or permanently with the Create New Folder by Default preference.
  • Startup Command: any shell line typed into the fresh session (so the session survives when the command exits). Set a default once in the New Session Startup Command preference โ€” e.g. npm run dev, claude, or compose steps like git init && claude โ€” and tweak it per-launch when needed.
  • The command accepts the session name as an argument, so Create New Session myproject from the Raycast root search prefills everything: press โŒ˜โŽ and you get a new terminal tab, in a new folder, with your startup command already running.
  • With the Open in Terminal After Create preference enabled, opening the session in a new tab/window becomes the default submit action โ€” plain โŽ does it all.

How to use

  1. Install Raycast ๐Ÿ“ฆ
  2. Install Tmux ๐Ÿ“ฆ
  3. Install Extension ๐Ÿ“ฆ
  4. Open Raycast and type Tmux Sessioner to see all commands ๐Ÿ“Ÿ
  5. First time you need to setup your terminal to attach to sessions automatically ๐Ÿ–ฅ Setup Terminal
  6. Enjoy Mangaging your sessions ๐ŸŽ‰ Manage Session
  7. You can create a new session with type Create New Session ๐Ÿ†• Create Terminal

TODO

  • Label sessions ๐Ÿท
  • Prioritize sessions ๐Ÿ“ˆ
  • Allow Creating Session with predefined windows ๐Ÿ–ผ
  • Create Windows