Workspace ManagerconceptCLI Manual

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

Edit this page on GitHub

Import from Teamocil

@libtmux/workspace 0.1.0-alpha.12 · Source

Import a Teamocil file without starting tmux. Save this source as teamocil.yaml:

teamocil.yaml
session:
name: imported-team
windows:
- name: editor
layout: even-horizontal
panes:
- commands: [printf ready]
- commands: [printf second]

Preview the translation

Terminal window
$ tmux-workspace import teamocil --json ./teamocil.yaml

The translated document preserves window and pane order. Several commands in one Teamocil commands list become one semicolon-separated shell input in that pane. Review the absolute working directories selected by the import.

Save the workspace

Terminal window
$ tmux-workspace import teamocil \
--json \
--workspace-format yaml \
--save-to imported-teamocil.yaml \
./teamocil.yaml

Use --force only to replace an existing destination deliberately. Unsupported fields, such as pane widths and filters, fail before saving. Conversion does not prove that a command or directory will be available when you load the result.

CLI source.

Esc

Type to search.

Reference previewOpen reference