SpaceVim/docs/layers/shell.md

title	description
SpaceVim shell layer	This layer provide shell support in SpaceVim

Available Layers >> shell

• Description
• Install
• Configuration
  • Default shell
  • Default shell position and height
• Key bindings

Description

This layer provide shell support in SpaceVim.

Install

To use this configuration layer, add following snippet to your custom configuration file.

[[layers]]
  name = "shell"

Configuration

Default shell

Vim support these kinds of shell:

To define the default shell you can set the layer variable default_shell to the following variables:

• terminal
• VimShell

The default shell is quickly accessible via a the default shortcut key SPC '.

Default shell position and height

It is possible to choose where the shell should pop up by setting the variable default_position to either top, bottom, left, right, or full. Default value is top. It is also possible to set the default height in percents with the variable default_height. Default value is 30.

[[layers]]
  name = "shell"
  default_position = "top"
  default_height = 30

Key bindings

Key Binding	Description
SPC '	Open or switch to the terminal windows
Ctrl-d	Close terminal windows in terminal mode
q	Hide terminal windows in Normal mode
<Esc>	Switch to Normal mode from terminal mode
Ctrl-h	Switch to the windows on the left
Ctrl-j	Switch to the windows below
Ctrl-k	Switch to the windows on the top
Ctrl-l	Switch to the windows on the right