# Import from tmuxinator

Source: https://libtmux.org/en/rs/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`](<https://libtmux.org/en/rs/latest/workspace/reference/config-windowconfig-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/rs/latest/workspace/cli/load/) the file.

[CLI source](https://github.com/libtmux/libtmux-rs/blob/e9be0b6f6d22cd2eb79b0ec08964f82e717e5fe4/crates/tmux-workspace/docs/cli.md).