#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

51KB
1.5K SLoC

Rusmux - tmux automation

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

Example

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

Install

  • 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
    

Commands

  • Run a project

      rusmux [project]
    

    or

      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.

Dependencies

~3.5–9MB
~158K SLoC