# Import from tmuxinator

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

> Translate a tmuxinator project into a workspace document.

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/csharp/latest/workspace/cli/load/) the file.

[CLI source](https://github.com/libtmux/libtmux-dotnet/blob/f77fe776ba67a04abb20ddbbc26cf4a000d63b74/src/LibTmux.Workspace.Cli/README.md).
