logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

kitten-@-set-enabled-layouts - Set the enabled layouts in tabs

Description

       Set  the  enabled layouts in the specified tabs (or the active tab if not specified). You can use special
       match value all to set the enabled layouts in all tabs. If the current layout of the tab is not  included
       in the enabled layouts, its layout is changed to the first enabled layout.

Global Options

--to   An  address  for  the  kitty  instance  to  control. Corresponds to the address given to the kitty
              instance via the --listen-onoptionorthelisten_onsettinginkitty.conf.Ifnotspecified,theenvironmentvariableKITTY_LISTEN_ONischecked.Ifthatisalsonotfound,messagesaresenttothecontrollingterminalforthisprocess,i.e.theywillonlyworkifthisprocessisrunwithinakittywindow.--password
              A  password  to use when contacting kitty. This will cause kitty to ask the user for permission to
              perform the specified action, unless the password has been accepted before or is pre-configured in
              kitty.conf.Touseablankpasswordspecify--use-passwordasalways.--password-file[=rc-pass]
              A file from which to read the  password.  Trailing  whitespace  is  ignored.  Relative  paths  are
              resolved from the kitty configuration directory. Use - to read from STDIN. Use fd:num to read from
              the  file  descriptor num. Used if no --passwordissupplied.Defaultstocheckingfortherc-passfileinthekittyconfigurationdirectory.--password-env[=KITTY_RC_PASSWORD]
              The name of an environment variable to read the password  from.  Used  if  no  --password-fileissupplied.DefaultstocheckingtheenvironmentvariableKITTY_RC_PASSWORD.--use-password[=if-available]
              If  no  password  is  available, kitty will usually just send the remote control command without a
              password. This option can be used to force it to always or never use the supplied password. If set
              to always and no password is provided, the blank password is used.

              Choices: if-available, always, never

0.39.1                                            Feb 16, 2025                   kitten-@-set-enabled-layouts(1)

Name

       kitten-@-set-enabled-layouts - Set the enabled layouts in tabs

Options

--match,-m
              The  tab  to  match. Match specifications are of the form: field:query. Where field can be one of:
              id, index, title, window_id, window_title, pid, cwd, cmdline env, var, state and recent. query  is
              the  expression  to  match. Expressions can be either a number or a regular expression, and can be
              combined using Boolean operators.

              The special value all matches all tabs.

              For numeric fields: id, index, window_id, pid and recent,  the  expression  is  interpreted  as  a
              number,  not  a  regular  expression.  Negative  values for id/window_id match from the highest id
              number down, in particular, -1 is the most recently created tab/window.

              When using title or id, first a matching tab is looked for, and if not found a matching window  is
              looked for, and the tab for that window is used.

              You  can  also  use  window_id and window_title to match the tab that contains the window with the
              specified id or title.

              The index number is used to match the nth tab in the currently active OS window. The recent number
              matches recently active tabs in the currently active OS window,  with  zero  being  the  currently
              active tab, one the previously active tab and so on.

              When  using  the env field to match on environment variables, you can specify only the environment
              variable name or a name and value, for example, env:MY_ENV_VAR=2. Tabs containing any window  with
              the specified environment variables are matched. Similarly, var matches tabs containing any window
              with the specified user variable.

              The  field  state  matches  on  the  state  of  the  tab.  Supported  states are: active, focused,
              needs_attention, parent_active and parent_focused. Active tabs are the tabs  that  are  active  in
              their  parent  OS window. There is only one focused tab and it is the tab to which keyboard events
              are delivered. If no tab is focused, the last focused tab is matched.

              Note that you can use the kitten @ ls command to get a list of tabs.

       --configured
              Change the default enabled layout value so that the new value takes effect for all  newly  created
              tabs as well.

       --help,-h
              Show help for this command

Usage

kitten@set-enabled-layoutsLAYOUT...

See Also