mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-07-10 06:05:26 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'feature-save-as-session' of https://github.com/jackielii/kitty

Browse Source
This commit is contained in:
Kovid Goyal
2025-10-27 08:39:31 +05:30
parent 9e94ff28f6 eedd56ff93
commit 5e366cb5a3
3 changed files with 26 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/changelog.rst
View File

@@ -189,6 +189,10 @@ Detailed list of changes
or a match expression for flexible tab selection, allowing sessions to preserve
the active tab state (:doc:`sessions`)
- :ac:`save_as_session`: Add ``--base-dir`` option to specify a base directory
for saving session files with relative paths, useful when the current working
directory is not the desired location (:doc:`sessions`)
0.43.1 [2025-10-01]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

11
docs/sessions.rst
View File

@@ -102,6 +102,17 @@ for a path at which to save the session file. Specify the path and the session
will be saved there with the exact setup you created. The saved file will even
be opened in your editor for you to review, automatically.
.. tip::
If you want session files to be saved to a specific directory regardless of
your current working directory, use the ``--base-dir`` option. For example::
map f7>s save_as_session --use-foreground-process --base-dir ~/.local/share/kitty/sessions
This is particularly useful when kitty is launched from system-wide shortcuts
where the working directory might not be your home directory. Note that
``--relocatable`` is typically not used with ``--base-dir``, since relocatable
is meant for session files that are co-located with their project directories.
If instead, you want to create these by hand, see the example below which shows
all the major keywords you can use in kitty session files: