CommandLine

Glide provides a commandline for executing excmds, switching tabs, and as an arbitrary picker.

Press : in normal mode to open the commandline, you can then start typing to filter the displayed options, select a specific option with <Up> / <Down>, and press <Enter> to execute the selected option.

You can press <Esc> to close the commandline.

Glide provides a tab switcher through the commandline that can be activated by pressing <leader><leader> in normal mode, or typing tab + <space> while the commandline is open.

In this view, all tabs in the current window will be shown, selecting a tab will switch to it. You can also delete the selected tab with <C-d>.

You can use the commandline as a picker by providing your own options to glide.commandline.show().

For example:

glide.commandline.show({
  options: ["foo", "bar", "baz"].map((label) => ({
    label,
    execute() {
      console.log(`label ${label} was selected`);
    },
  })),
});

  
  

When options are provided, they replace the default excmds and tabs. Input fuzzy-filters against option.label and option.description.

You can also customise how each option is displayed by providing a render() function on each option that returns a HTMLElement:

{
  label: bookmark.title,
  render() {
    return DOM.create_element("div", {
      style: {
        display: "flex",
        alignItems: "center",
        gap: "8px",
      },
      children: [
        DOM.create_element("span", [bookmark.title]),
        DOM.create_element("span", [bookmark.url!], {
          style: { color: "#777", fontSize: "0.9em" },
        }),
      ],
    });
  },
};

  
  

See the bookmarks picker for a more complete example.

This autocmd is fired whenever the commandline UI is closed, regardless of whether a command was executed or if it was just closed without taking any action.

glide.autocmds.create("CommandLineExit", () => {
  // ...
});

  
  

These key mappings apply in command mode, while the commandline is focused.

This example shows how you could create a custom bookmarks picker that displays the 10 most recent bookmarks, and either creates a new tab with the selected entry, or switches to the corresponding tab if it already exists.

glide.keymaps.set("normal", "<leader>o", async () => {
  const bookmarks = await browser.bookmarks.getRecent(10);

  glide.commandline.show({
    title: "bookmarks",
    options: bookmarks.map((bookmark) => ({
      label: bookmark.title,
      async execute() {
        const tab = await glide.tabs.get_first({
          url: bookmark.url,
        });
        if (tab) {
          await browser.tabs.update(tab.id, {
            active: true,
          });
        } else {
          await browser.tabs.create({
            active: true,
            url: bookmark.url,
          });
        }
      },
    })),
  });
}, { description: "Open the bookmarks picker" });