Available Layers » ctrlspace

• Description
• Install
• Layer Options
• Keybindings: CtrlSpace Defaults
• Keybindings: SpaceVim Styled

Description

This layer is a customized wrapper for CtrlSpace, a plugin dedicated to project navigation and workflow management, rather than a traditional fuzzy finder like Denite or FZF. CtrlSpace strictly manages 5 source lists only:

• Buffers
• Files
• Tabs
• Workspaces (vim session for current project)
• Bookmarks (projects)

CtrlSpace has the unique property of allowing users to stay within it after it has been invoked once (similar to SpaceVim’s own Transient Modes). Thereby granting you the ability to open multiple files, move/copy many buffers to new tabs, change to your various project bookmarks, and any combinations of its various actions, all without needing to reinvoke it.

Install

To use the CtrlSpace layer, add the following to your configuration file.

[[layers]]
name = "ctrlspace"

Layer Options

• home-mapping-key (default: <C-Space>) - keybinding to enter CtrlSpace’s home menu, which displays the buffers list
• autosave-workspaces (default: true) - enable this to autosave current workspace on switching WS and exiting SpaceVim
• autoload-workspaces (default: false) - enable this to autoload last workspace when starting SpaceVim

• For more granular CtrlSpace options, refer to the plugin’s GitHub page.

• enable-spacevim-styled-keys (default: false) - enable this to use SpaceVim styled keybindings.

Note: when disabled, another traditional fuzzy finder layer (such as Denite or FZF) may still be used without concerns of keybinding conflicts.

Keybindings: CtrlSpace Defaults

From Vim’s Normal mode, <home-mapping-key> enters CtrlSpace in its home (buffers) list. Then using the following key shortcuts, all 5 lists can be accessed via any of the other 4. Press ? to show key reference for the current list and mode (ex. search mode of files list).

To exit CtrlSpace, press <Esc>, <C-c> or <home-mapping-key> at anytime.

For more comprehensive documentation of CtrlSpace’s keys, features and functionalities, refer to this guide.

Keybindings: SpaceVim Styled

For those who prefer to use SpaceVim’s style of fuzzy finding buffers/files/projects, the following keybindings can be optionally enabled with enable-spacevim-styled-keys = true.

Note: to be consistent with other fuzzy finder layers in SpaceVim, uppercased final keys will list the source, while lowercased ones will search. This is opposite to CtrlSpace’s default shortcuts.