emre şahin's digital garden 🍃
airmux.
Posted on :: Tags: tools, tmux, cli, rust, airmux, terminal
  • Airmux is a session manager for tmux that allows defining and managing multiple tmux sessions through project configuration files.
  • Projects are defined in YAML or JSON files that specify settings such as commands to run, window/pane layouts, and other session settings.
  • The start command loads and attaches to an existing project, while edit creates or modifies project files.
  • Projects support environment variable expansion, and command-line arguments passed to start are available as $1, $2, etc., in the project file.
  • Local project files can be used without specifying a name if they are found by searching parent directories.
  • Commands like list, remove, and freeze can manage existing projects.
  • Debug prints the tmux commands to create a session without attaching, which is useful for troubleshooting.
  • Fields like on_start and on_stop allow running commands before or after session startup/shutdown.
  • Windows and panes have their own settings, such as layouts and commands to run, and they can be nested in the project file.
  • Airmux aims to provide an easy and organized way to define and manage multiple related tmux sessions through project files.