Declarative layouts

Describe the tabs, splits and commands of a project in YAML. The files are in ~/.config/macterm/projects/, one file for each project. Macterm matches a file to a project by path. The file name does not matter.

~/.config/macterm/projects/myapp.yaml

name: "MyApp"
path: "~/dev/myapp"
tabs:
  - run: "npm run dev"
  - name: "Dev"
    split:
      direction: horizontal
      ratio: 0.6
      first:  { cwd: "./api", run: "npm run dev" }
      second: {} # plain shell pane

Each tab is a leaf pane (cwd, run and shell) or a split. A split has a direction, a ratio, and the children first and second. A bare {} is a plain shell.

Applying and saving

Command palette	Effect
Save layout	Writes your current workspace to the file.
Apply layout	Changes the live workspace to match the file. Macterm keeps the panes that match. It starts again the panes that are different.

When you select a project or start Macterm again, Macterm restores your last session. It does not read the file. The file has an effect only when you run Apply layout.

Remote projects

Set path to a remote spec. The tabs then start on that host. Add zmxPath only if Macterm cannot find zmx by itself.

path: "devbox:~/dev/api"
zmxPath: "~/bin/zmx"

See remote projects.