# Import from tmuxinator

Source: https://libtmux.org/en/ts/latest/workspace/cli/import-tmuxinator/

> Translate a tmuxinator project into a workspace document.

**Workspace Manager concept example** A working example of the core library. It can change without notice.



Import a saved tmuxinator project without starting tmux. Save this source as
`tmuxinator.yaml`:

```yaml title="tmuxinator.yaml"
name: imported-project
windows:
  - editor:
      - printf ready
      - printf second
```

## Preview the translation

```console
$ tmux-workspace import tmuxinator --json ./tmuxinator.yaml
```

The window's command list remains sequential commands in one pane. Use an
explicit source `panes` list when the project needs separate panes.

## Save the workspace

```console
$ tmux-workspace import tmuxinator \
    --json \
    --workspace-format yaml \
    --save-to imported-tmuxinator.yaml \
    ./tmuxinator.yaml
```

Existing destinations require `--force`. The importer rejects unexpanded ERB
templates and unsupported lifecycle or runtime fields before writing. It does
not evaluate Ruby. Review the translated commands and absolute directories
before [loading](https://libtmux.org/en/ts/latest/workspace/cli/load/) the file.

[CLI source](https://github.com/libtmux/libtmux-ts/blob/f36d692552bb9a373b45338bb5fece854e57cc3d/packages/workspace-cli/README.md).