SuperTab

Inspired by the Vim SuperTab plugin, this feature makes the Tab key context-sensitive so that the same key can indent, produce a literal tab character and perform completion, all in one.

The basic concept is that it's possible to figure out what to do when the user presses tab based on the current context. If the cursor is at the end of some text, activating SuperTab will open the completion menu. If the cursor is at the beginning of the line or only preceded by whitespace, it will indent the line. In any other scenario, it will produce a tab character.

To enable SuperTab, bind the tab key to editor::SuperTab in your keymap.jsonc:

{
  "context": "Editor && mode == full",
  "use_key_equivalents": true,
  "bindings": {
    "tab": "editor::SuperTab"
  },
}

Fallback mode

By default, Supertab will fall back to inserting a literal tab character when not at the beginning of the line or at a completion point. To have it always indent unless completing, you can configure supertab_fallback in settings.jsonc or via the Settings interface:

{
  "supertab_fallback": "indent", // default is "tab"
}