#tmux #tmuxinator

app rusmux

Automate tmux sessions configuration

4 releases

0.3.7 Apr 23, 2023
0.3.6 Mar 28, 2023
0.3.5 Mar 21, 2023
0.3.4 Mar 7, 2023

#307 in Command line utilities

25 downloads per month

MIT license

1.5K SLoC

Rusmux - tmux automation

Built primarily to replace tmuxinator while using it's yaml files.


cat ~/.config/rusmux/demo.yml
project_name: demo
project_root: ~/src/demo
  - sudo systemctl start postgresql
  - sudo systemctl start mysqld
# on_project_stop: 
  - workon demo
  - cd demo
  - editor: vim
  - shells:
      layout: main-vertical
        - #
        - grunt serve
  - mail: python -m smtpd -n -c DebuggingServer localhost:1025


  • Arch Linux users can install rusmux from AUR, e.g. (using paru):

      paru -S rusmux
  • Get a compiled binary from the Releases page and place it in your $PATH.

  • With cargo:

      cargo install rusmux


  • Run a project

      rusmux [project]


      rusmux run [project]
  • List all existing projects

      rusmux list
  • Output shell commands for a project

      rusmux debug [project]
  • Edit an existing project ($EDITOR should be set)

      rusmux edit [project]
  • Stop project's session

      rusmux stop [project]
  • Delete an existing project (after confirmation)

      rusmux delete [project]
  • Create a new project, and open it in an editor ($EDITOR should be set)

      rusmux new [project]

    This creates the project from default template. To create one with just the project name:

      rusmux new [project] --blank
  • Copy an existing project to a new one and edit it ($EDITOR should be set)

      rusmux copy [existing] [new]
  • Check your environment for potential issues

      rusmux doctor

    Checks for tmux in $PATH and $SHELL & $EDITOR are set.


~158K SLoC