General Computing
tmux rename
Updated Thu, 21 Jul 2022 16:05:02 GMT

How do I rename a session in tmux?

When I first started using tmux, I didn't give my first session a name. Then, as I started creating different sessions for different tasks (work, play, etc), I started naming my sessions.

Now I have a bunch of different sessions, but the first one doesn't have a name. How can I name (or rename) it, both from within tmux and from a shell prompt?


From within tmux

Short way: prefix, then dollar sign:

Ctrl + B, $


Long way: prefix, then colon:

Ctrl + B, :

Then type this command at the prompt:

rename-session [-t current-name] [new-name]

If the current session name (-t current-name) is not specified, the currently attached session will be renamed.

By default the session name will be in brackets in the lower left corner of tmux. You can list all sessions and switch between them with:

Ctrl + B, s

From shell prompt

You can rename tmux sessions with

tmux rename-session [-t current-name] [new-name]

To find your session names, do tmux list-sessions -- it will be in the left-most column.

If the current session name (-t current-name) is not specified, the most recently used session will be renamed.

Comments (5)

  • +1 – I'm trying to create a canonical answer. Can you also tell me how to do this from within tmux? And also how I would find out what my session is currently named? — May 23, 2012 at 17:35  
  • +2 – Hmm.. C-b $ doesn't seem to be set by default in my tmux on Ubuntu 10.04. At any rate, you can find the name of your current session with tmux list-sessions, it'll be the left-most item. Will probably be '0' if it was the first session you created. Then tmux rename-session -t 0 renamed_session. Both commands should work from within tmux. — May 23, 2012 at 18:15  
  • +1 – It'd be better if you flesh out your answer with a comprehensive edit instead of back and forth comments — May 23, 2012 at 18:54  
  • +8 – Note that rename-session [new-name] is enough if you want to rename current session within tmux. — Nov 07, 2012 at 19:13  
  • +0tmux new -s myname to start a new named session. so you don't run into this predicament next time. — Nov 29, 2014 at 18:34