https://github.com/michenriksen/tmpl

Simple tmux session management.
https://github.com/michenriksen/tmpl

cli dotfiles productivity-tools tmux

Last synced: 3 months ago
JSON representation

Simple tmux session management.

• Host: GitHub
• URL: https://github.com/michenriksen/tmpl
• Owner: michenriksen
• License: mit
• Created: 2023-12-16T07:28:03.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-16T08:15:54.000Z (about 1 year ago)
• Last Synced: 2023-12-17T08:49:31.697Z (about 1 year ago)
• Topics: cli, dotfiles, productivity-tools, tmux
• Language: Go
• Homepage: https://michenriksen.com/tmpl/
• Size: 1.27 MB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        



  

    

    

    

  





  tmpl 

  

    

  

  

    

  

  

  

    

  



**Simple tmux session management.**


Tmpl streamlines your tmux workflow by letting you describe your sessions in simple YAML files and have them

launched with all the tools your workflow requires set up and ready to go. If you often set up the same windows and

panes for tasks like coding, running unit tests, tailing logs, and using other tools, tmpl can automate that for you.

## Highlights

- **Simple and versatile configuration:** easily set up your tmux sessions using straightforward YAML files, allowing

  you to create as many windows and panes as needed. Customize session and window names, working directories, and

  start-up commands.

- **Inheritable environment variables:** define environment variables for your entire session, a specific window, or a

  particular pane. These variables cascade from session to window to pane, enabling you to set a variable once and

  modify it at any level.

- **Custom hook commands:** customize your setup with on-window and on-pane hook commands that run when new windows,

  panes, or both are created. This feature is useful for initializing a virtual environment or switching between

  language runtime versions.

- **Non-intrusive workflow:** while there are many excellent session managers out there, some of them tend to be quite

  opinionated about how you should work with them. Tmpl allows configurations to live anywhere in your filesystem and

  focuses only on launching your session. It's intended as a secondary companion, and not a full workflow replacement.

- **Stand-alone binary:** Tmpl is a single, stand-alone binary with no external dependencies, except for tmux. It's easy

  to install and doesn't require you to have a specific language runtime or package manager on your system.

## Getting started

See the [Getting started guide](https://michenriksen.com/tmpl/getting-started/) for installation and usage instructions.