Project Environment Executor
Go to file
Raj 11794e59a2
2024-01-17 22:44:55 +05:30
config fix: added option to auto select pane 2023-10-23 00:53:32 +05:30
controller fix: setup working dir properly 2024-01-17 21:23:03 +05:30
project-manager feat: added kill session command 2023-10-23 01:22:07 +05:30
ui updated colors 2023-10-26 19:50:15 +05:30
utils fix: default to nvim if available 2023-10-22 15:59:12 +05:30
.DS_Store fix: setup working dir properly 2024-01-17 21:23:03 +05:30
.gitignore v0.0.2 2023-10-22 11:13:04 +05:30 Update 2024-01-17 22:44:55 +05:30
go.mod updated mod name 2023-10-22 01:20:11 +05:30
go.sum init v0 2023-10-22 01:12:58 +05:30
main.go feat: experimental support for screen under scr command 2023-10-22 18:13:55 +05:30


Project Environment Executor, Define your project workspace as code and config.


Creating tmux sessions with preconfigured panes layouts and commands. inspired from tmuxinator

Get Started

Screen Recording 2023-10-22 at 2 11 11 PM


go install

Initialize a project

pee init myproject

Select a directory from the file picker by <space>, the directory that the init is run in will be the default starting directory for the file picker, you can go up and down directories by <backspace> and <enter>

Configure project

Config is similar to tmuxinator

name: ppec-ui
editor: nvim
root: /Users/raj.sharma/Documents/GitHub/ppec-ui
  - window_name: editor
    layout: 8070,202x58,0,0[202x46,0,0,89,202x11,0,47,92]
      - shell_command:
          - nvim "+SessionManager load_current_dir_session"
      - shell_command:
          - echo 'npm run dev'
  - window_name: hosts
    layout: even-horizontal
      - cd somewhere && activate env
      - shell_command:
          - ssh stg-host1
      - shell_command:
          - ssh stg-host2
  - window_name: git
      - shell_command:
          - lazygit
lastopened: 2023-10-22T14:03:54.071678+05:30
attach: true

editor here is used as the default editor for editing the config file. note: attach here does not tmux attach the new session, instead uses tmux switch-client for faster switching.

Run a project

For this example we have a project called ppec with the above config

pee ppec

and this should open up ppec tmux session

Edit or Run from list

Screen Recording 2023-10-22 at 2 12 41 PM

You can also run

pee ls

and select the project from table and click <enter> to open/create the session or <e> to edit the config of the project


  1. Supporting iTerm2 As of now this supports only tmux windows and panes, would want to add support for iterm and other terminals if they have api's to do so.
  2. Ability to save an opened session into a config or update a config
  3. Parse cli args to config
  4. Ability to save custom layouts as named layouts that can be used across multiple projects
  5. Sync configs across devices

All contributions are welcome