Question 1

How do I install the modal.wezterm plugin?

Accepted Answer

Add Lua code to your WezTerm config file to require the plugin from GitHub, then apply it with modal.apply_to_config(config). Follow the preset or customization steps in the README for setup.

Question 2

modal.wezterm vs wezmode: which one should I use?

Accepted Answer

modal.wezterm is a Lua-based alternative to wezmode, offering better integration with WezTerm's native config system. Choose modal.wezterm if you prefer Lua scripting and extensibility, while wezmode might suit those comfortable with TypeScript.

Question 3

How can I customize keybindings in modal.wezterm?

Accepted Answer

Create custom modes by defining key tables and status text in Lua, then add them via modal.add_mode(). Reference the examples in the /defaults directory for inspiration and modify config.keys accordingly.

Question 4

Does modal.wezterm work with terminal emulators other than WezTerm?

Accepted Answer

No, it's specifically designed for WezTerm and relies on its plugin API. Users of other emulators like iTerm2 or Kitty will need to seek alternative solutions or stick to built-in features.

Question 5

How to add a new mode in modal.wezterm?

Accepted Answer

Define a Lua key table and status text, then use modal.add_mode() to register it. Update config.key_tables and add an entry in config.keys to activate it, as detailed in the customization section of the README.

Question 6

Can I use modal.wezterm without knowing Vim keybindings?

Accepted Answer

It's possible but not ideal, as the plugin is built around Vim conventions. Users unfamiliar with Vim will face a steep learning curve and may find the modal approach confusing compared to traditional terminal shortcuts.

modal.wezterm

What is modal.wezterm?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions