Transitioning from tmux to Herdr: Setting Up an AI-Native Workspace Manager

Table of Contents

For years, tmux has been the undisputed king of my terminal workflow. It kept my sessions alive, let me manage tabs, and split panes effortlessly. But as AI coding agents like Claude Code and Antigravity became a daily part of my development lifecycle, I found myself needing a workspace manager that understands these agents.

Enter Herdr, a terminal-native workspace manager designed specifically for developers working alongside AI coding agents. It offers persistent sessions, workspace isolation, and native agent status tracking.

However, moving to a new tool shouldn’t mean discarding years of muscle memory. Here is how I configured Herdr to behave exactly like my tmux setup, from shortcuts to themes.

The Configuration: Mapping tmux to Herdr

Herdr’s configuration is managed via a simple TOML file located at ~/.config/herdr/config.toml. To align it with my tmux conventions, I mapped the keys under the [keys] section.

1. The Prefix Key

By default, Herdr uses ctrl+b. Just like in my .tmux.conf, I remapped this to ctrl+a:

[keys]
prefix = "ctrl+a"

2. Splitting Panes Visually

I prefer using | for splitting panes vertically (side-by-side) and - for horizontal splits (top-to-bottom) because they are much easier to remember than the defaults:

split_vertical = "prefix+|"
split_horizontal = "prefix+minus"

To move around quickly without interrupting my flow, I set up a combination of arrow keys and direct shortcuts:

Pane Switching: Focus panes using arrow keys with the prefix (ctrl-a + Up/Down/Left/Right):

focus_pane_left = "prefix+left"
focus_pane_down = "prefix+down"
focus_pane_up = "prefix+up"
focus_pane_right = "prefix+right"

Direct Tab Switching: Using direct OS-like keyboard chords to cycle tabs without pressing the prefix:
```
previous_tab = "ctrl+alt+h"
next_tab = "ctrl+alt+l"
```

4. Interactive Lists (choose-tree equivalent)

In tmux, pressing prefix + w opens a session/window list (choose-tree). In Herdr, the equivalent fuzzy finder is the goto search. I swapped the default keys to map goto to my tmux shortcut:

goto = "prefix+w"
workspace_picker = "prefix+g"

Now pressing ctrl-a + w opens a search across all workspaces, tabs, and active panes.

5. Managing Workspaces on the Fly

Renaming workspaces helps keep my active projects organized. I enabled the interactive workspace rename shortcut:

rename_workspace = "prefix+shift+w"

Pressing ctrl-a + W prompts me to rename the active space.

6. Config Reloads

To test configuration changes without stopping the server, I mapped the reload command:

reload_config = "prefix+r"
resize_mode = "prefix+shift+r" # Shifted resize_mode to avoid conflicts

Aesthetic Harmony: Bringing Nord Theme to Herdr

One of my favorite things about tmux was my Nord theme setup. Luckily, Herdr comes with a built-in Nord theme out of the box. Setting it up was as simple as changing one line in the [theme] block:

[theme]
name = "nord"

This updates the borders, status bar, highlighting, and search menus to match the clean, ice-cold Nord aesthetic.

The Verdict

Switching from tmux to Herdr didn’t require sacrificing my workflow. By mapping the configurations in config.toml, I got the best of both worlds:

My muscle memory remains intact.
I now have a workspace manager that natively tracks my AI coding agents, runs them in persistent background sessions, and integrates seamlessly with my terminal.

If you are looking to update your terminal multitasking for the AI era, I highly recommend giving Herdr a try!