# Import a workspace

Source: https://libtmux.org/en/rs/latest/workspace/cli/import/

> Choose a source format and translate it into a workspace document.

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



Translate a saved Teamocil or tmuxinator configuration into a native workspace
document. Import reads and translates the file without creating tmux sessions
or running its pane commands.

- [Teamocil](https://libtmux.org/en/rs/latest/workspace/cli/import-teamocil/) translates a session with named windows and panes.
- [tmuxinator](https://libtmux.org/en/rs/latest/workspace/cli/import-tmuxinator/) translates a project with ordered windows.

```console
$ tmux-workspace import --help
```

Select a child command and an explicit source path. Preview with `--json` before
choosing `--save-to`. An existing destination requires `--force`.

Review commands, directories and layout in the translated document before
loading it. Source features the importer cannot preserve fail visibly. Use
[convert](https://libtmux.org/en/rs/latest/workspace/cli/convert/) to change YAML/JSON encoding without translating fields.

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