# Edit a workspace

Source: https://libtmux.org/en/ts/latest/workspace/cli/edit/

> Resolve a workspace file or saved name and open it in an editor.

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



Resolve a workspace file or saved name and open it in an editor. Use an explicit
path when editing a particular file.

## Open the file

With `vi` installed and [`workspace.yaml`](https://libtmux.org/en/ts/latest/workspace/guides/installation/#create-the-input) saved:

```console
$ EDITOR=vi tmux-workspace edit workspace.yaml
```

The CLI waits for the editor and reports a failed child through its exit status.
Editor values can contain quoted arguments. They are parsed as an argument list;
shell pipelines and redirection require an explicit shell or wrapper.

[Discovery](https://libtmux.org/en/ts/latest/workspace/guides/discovery/) explains saved workspace names.

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