/wezl.fish

Easily create and manage WezTerm terminal layouts with a simple yet powerful syntax using wezl.

Primary LanguageShellMIT LicenseMIT

Wezl - A simple wezterm layout manager for fish

Important

This fish plugin is now a standalone shell script that lives in my dotfiles repository. Please check it out here.

TL;DR: This fish plugin is made by GPT4!

Introducing wezl, a powerful and user-friendly command for the WezTerm terminal emulator that simplifies the process of creating and managing terminal layouts. With an easy-to-understand syntax using just three symbols - |, /, and =, wezl enables you to create and configure multiple tabs and split panes in your terminal. Whether you want to spawn new windows, tabs, or apply layouts to your existing WezTerm session, wezl has got you covered. This versatile command also includes built-in shell completion and help documentation, ensuring a smooth user experience.

Demo

wezl_demo.mp4

Installation

fisher install Yukaii/wezl.fish

Usage

wezl - A simple layout manager for Wezterm.

Usage:
  wezl [OPTIONS] LAYOUT_STRING

Options:
  --new-window        Create layout in a new window
  --cwd <DIRECTORY>   Specify the current working directory
  --help              Show this help message

Layout string syntax:
  |  - New tab
  /  - Vertical split
  =  - Horizontal split

The layout string is executed in sequence, meaning each character is applied sequentially to create the desired layout.

Examples:
  wezl '||=//='
  wezl --new-window --cwd /path/to/directory '||=//='

For the example given:

Tab 1:

+---------------------+
|        Pane 1       |
+---------------------+

Tab 2:

+---------------------+
|        Pane 2       |
+---------------------+
|          |    |  5  |
|  Pane 3  | 4  |-----|
|          |    |  6  |
+----------+----------+

License

MIT

Credits

  • WezTerm - The terminal emulator that everyone should be using
  • fish - The friendly interactive shell
  • ChatGPT - Most of the code is generated by it. Including the help message and this README(excluding this part). You can read my prompt at https://shareg.pt/UFBSNrN