Question 1

How do I set up custom keybindings for smart workspace switcher in Wezterm?

Accepted Answer

Define custom keybindings in your Wezterm config.lua by using actions like workspace_switcher.switch_workspace(), as shown in the README with examples for LEADER mods. You can adjust keys to fit your preferred shortcuts.

Question 2

smart workspace switcher vs default Wezterm workspace manager: which is better?

Accepted Answer

Smart workspace switcher adds fuzzy finding and zoxide integration for faster, more intelligent navigation, while default Wezterm workspaces are basic. Choose this plugin if you need rapid switching with suggestions; stick with default if you prefer simplicity without dependencies.

Question 3

Can I use smart workspace switcher without zoxide?

Accepted Answer

No, zoxide is a required dependency for the plugin to function, as it relies on zoxide for directory suggestions. You must install and configure zoxide first, or the plugin won't provide intelligent path recommendations.

Question 4

How to filter workspace suggestions to only my projects?

Accepted Answer

Use the extra_args option in switch_workspace, such as piping zoxide results through rg to match a predefined project list (e.g., ' | rg -Fxf ~/.projects'), as explained in the Additional Filtering section of the README.

Question 5

What are the available events and how to use them?

Accepted Answer

Events like 'chosen', 'created', and 'canceled' are emitted; hook into them with wezterm.on() to trigger custom Lua code, such as updating the status bar. Note that some events emit MuxWindow objects while others emit GuiWindow, which requires careful handling.

Question 6

Is smart workspace switcher compatible with tmux sessions?

Accepted Answer

While inspired by tmux session managers, this plugin is specifically for Wezterm workspaces and does not directly integrate with tmux. It focuses on enhancing Wezterm's native workspace system, not tmux session management.

smart_workspace_switcher.wezterm

What is smart_workspace_switcher.wezterm?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions