docs/config/lua/pane/get_current_working_dir.md
pane:get_current_working_dir(){{since('20201031-154415-9614e117')}}
Returns the current working directory of the pane, if known. The current directory can be specified by an application sending OSC 7.
If OSC 7 was never sent to a pane, and the pane represents a locally spawned process, then wezterm will:
With the process identified, wezterm will then try to determine the current working directory using operating system dependent code:
| OS | Supported? |
|---|---|
| macOS | Yes, {{since('20201031-154415-9614e117', inline=True)}} |
| Linux | Yes, {{since('20201031-154415-9614e117', inline=True)}} |
| Windows | Yes, {{since('20220101-133340-7edc5b5a', inline=True)}} |
If the current working directory is not known then this method returns nil.
Otherwise, it returns the current working directory as a URI string.
Note that while the current working directory is usually a file path, it is possible for an application to set it to an FTP URL or some other kind of URL, which is why this method doesn't simply return a file path string.
{{since('20240127-113634-bbcac864')}}
This method now returns a Url object which provides a convenient way to decode and operate on the URL.