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

powerline - Powerline prompt and statusline script.

Author

       Written  by Kim Silkebækken, Nikolay Pavlov, Kovid Goyal and contributors. The glyphs in the font patcher
       are created by Fabrizio Schiavi.

Description

EXT    Extension:  application  for  which  powerline  command  is launched (usually shell or tmux). Also
              supports wm. extensions: wm.awesome.

       SIDE   Side: left and right represent left and right  side  respectively,  above  emits  lines  that  are
              supposed  to  be printed just above the prompt and aboveleft is like concatenating above with left
              with the exception that only one Python instance is used in this case. May  be  omitted  for  wm.*
              extensions.

       -r, --renderer-moduleMODULE
              Renderer   module.   Usually   something   like   .bash  or  .zsh  (with  leading  dot)  which  is
              powerline.renderers.{ext}{MODULE}, may also be full module name (must contain at least one dot  or
              end with a dot in case it is top-level module) or powerline.renderers submodule (in case there are
              no dots).

       -w, --widthWIDTH
              Maximum prompt with. Triggers truncation of some segments.

       --last-exit-codeINT
              Last exit code.

       --last-pipe-statusLIST
              Like  above,  but  is  supposed  to  contain  space-separated array of statuses, representing exit
              statuses of commands in one pipe.

       --jobnumINT
              Number of jobs.

       -c, --config-overrideKEY.KEY=VALUE
              Configuration overrides for config.json. Is  translated  to  a  dictionary  and  merged  with  the
              dictionary obtained from actual JSON configuration: KEY.KEY=VALUE is translated to {"KEY":{"KEY":VALUE}}  and then merged recursively. VALUE may be any JSON value, values that are not null, true,
              false, start with digit, {, [ are treated like strings. If VALUE is omitted then corresponding key
              is removed.

       -t, --theme-overrideTHEME.KEY.KEY=VALUE
              Like above, but theme-specific. THEME should point to an existing  and  used  theme  to  have  any
              effect, but it is fine to use any theme here.

       -R, --renderer-argKEY=VAL
              Like  above,  but provides argument for renderer. Is supposed to be used only by shell bindings to
              provide various data like last-exit-code or last-pipe-status (they are  not  using  --renderer-arg
              for historical reasons: --renderer-arg was added later).

       -p, --config-pathPATH
              Path  to configuration directory. If it is present then configuration files will only be sought in
              the provided path. May be provided multiple times to search in a list of directories.

       --socketADDRESS
              Socket address to use in daemon clients. Is always UNIX domain socket on linux and file socket  on
              Mac  OS  X.  Not  used  here,  present  only  for compatibility with other powerline clients. This
              argument must always be the first one and be in a form  --socketADDRESS:  no  =  or  short  form
              allowed (in other powerline clients, not here).

       -h, --help
              Display help and exit.

Name

       powerline - Powerline prompt and statusline script.

Reporting Bugs

       Report powerline bugs to https://github.com/powerline/powerline/issues.

See Also

powerline-daemon(1), powerline-config(1)

beta                                            January 22, 2025                                    POWERLINE(1)

Synopsis

powerlineEXT [SIDE] [-rMODULE] [-wWIDTH] [--last-exit-code=INT]
                    [--last-pipe-status=LIST] [--jobnum=INT]
                    [-cKEY.KEY=VALUE]… [-tTHEME.KEY.KEY=VALUE]… [-RKEY=VAL]…
                    [-pPATH]… [--socket=ADDRESS]

See Also