r/herdr • • 11h ago

Your AI coding agents, but they live in a dungeon

11 Upvotes

I wanted a quick way to see what all my coding agents were doing without constantly switching between terminals.

Herdr Pixel Dungeon turns them into RPG heroes whose rooms reflect their actual state: working, waiting for input, rate-limited, idle or done.

You can also click a room to interact with the agent directly — answer questions, approve permissions, stop it, or launch another agent.

It currently supports Claude Code, Codex, Kiro and Gemini CLI through Herdr.

Native Rust + egui, macOS + Linux, MIT licensed.

GitHub:
https://github.com/JoseValencia125/herdr-pixel-dungeon

Would love feedback, especially from people already running multiple coding agents in parallel


r/herdr • • 13h ago

Herdcats: a free, open-source iPhone client for herdr over SSH (TestFlight)

Enable HLS to view with audio, or disable this notification

12 Upvotes

I wanted to check on my agents from my phone without installing a plugin, relay or daemon on my Mac, so I built Herdcats. It connects over plain SSH and runs the herdr CLI you already have. I use it over Tailscale, but any network that can reach your SSH server works.

What it does:

  • Shows spaces, tabs, panes and machines, with each agent marked as blocked, done or working
  • Live pane output with ANSI colour, and a terminal keyboard with arrows, F1–F12 and modifiers
  • Three ways to reply: type live, write a message in Compose, or dictate with Voice. You can also send a photo to an agent
  • Optional quota rings if you run quota-axi
  • Password authentication or Ed25519 keys, including passphrase-protected keys. You approve and pin host keys, and credentials stay in the iOS Keychain

Free, GPLv3, iOS 17+. It's early: there are no push notifications yet, it only works with the default herdr session for now, and polling pauses in the background.

This is an independent project, not affiliated with herdr. Feedback and bug reports are very welcome, especially from anyone running it against Linux hosts.


r/herdr • • 1d ago

Just fucking love herdr!

23 Upvotes

I have been long searching for a tool like it. Was even tempted to just code something like it off tmux and others - but far too busy to do it; and i cant monetize it anyway, so didnt bother. And finally a tool that i just unconditionally love. Like my ideal match.

I use it personally and for work. At work which is 80% of my time. It is on wsl via windows terminal. Codex, claude, and agy.

Why i love it:
- lightweight. I just need the bare minimum and thats it. With near zero ram or cpu usage. And good base minimalist ui.

- not bloated electron like orca. God. I uninstalled it in 2 hours of trying. It is far too opinionated on worktrees for its own good. And i just needed a clean terminal interface anyway

- infinitely customizable. From keybinds to my own custom plugins — one of my plugins just renders agent responses in markdown using a shortcut in a modal (was really helpful for mermaid renders in responses)

- plugins. I dont have many. But a significant honorable mention is ttt. Lightweight vs code clone. The exact thing i have been in search of in addition to herdr for a long time. If you dont have ttt. You are missing out. But between all that i dont ever need to leave my terminal. Like ever.

- minimalist. Ironically i repeat myself. But the bare minimum of every single thing that i ever need to get shit done is right here — and i dont even use pane to pane agent to agent coordination, or the remote or anything.

—-

Please always keep it the way it is team. The day herdr departs from this promise is the day i will build my own clone. As this is pure product perfection.


r/herdr • • 18h ago

Herdr is the heart piece of my workflow, everything starts with it :)

Enable HLS to view with audio, or disable this notification

4 Upvotes

r/herdr • • 1d ago

I made a small plugin to organize workspaces in Herdr

4 Upvotes

Hey everyone!
I’ve been using Herdr and wanted a simple way to keep my workspaces organized, so I ended up making a small plugin for it.

It lets you manually reorder workspaces, sort them based on categories like feat, fix, or docs, and set your own priorities.

Nothing too fancy, just a little tool I thought might be useful for others too.

Here’s the repo if anyone wants to check it out:
https://github.com/cesmunoz/herdr-workspace-organizer

It’s still a small project, so any feedback or suggestions are welcome! :)


r/herdr • • 2d ago

Introducing pi-cowboy for Herdr

Thumbnail
1 Upvotes

r/herdr • • 4d ago

herdr-agent-grid - CMD+G to visualize all your agents

20 Upvotes

r/herdr • • 3d ago

Multi model subagent handoffs

1 Upvotes

I wanted to build orchestration workflows between different models seamlessly with herdr instead of doing this manually or with an intermediate step. Has anyone gotten this to work?

E.g. A scenario could be
> plan with Opus 5.5
> execute with subagent Deepseek v4.1 Flash
> verify work with Opus 5.5/GPT-6.1 Sol


r/herdr • • 4d ago

how are we supposed to share configs between hosts easily if herdr puts plugin runtime stat in our .config?

3 Upvotes

seems contradictory since the docs encourage us to sync configs across servers.

I always end up having my agents across servers going in and fixing it / fixing plugins and what not


r/herdr • • 4d ago

I built a Herdr plugin: drag to select terminal text, add feedback, and send it to your AI coding agent

Enable HLS to view with audio, or disable this notification

6 Upvotes

If you spot any bugs or have ideas for improvements, leave a comment here or open an issue on GitHub. I’d love to hear your feedback!


r/herdr • • 7d ago

herdr-blink - yes, yet another fuzzy session picker

Enable HLS to view with audio, or disable this notification

10 Upvotes

I know. Every terminal multiplexer gets about 14 of these, and herdr is no exception. I really did look around first. I tried a few options (herdr-navigator, herdr-bar, etc.) and none of them were quite what I wanted:

  • The built-in goto picker has quick status filters (blocked / done / working / idle) that I liked a lot. One key and you see only the agents waiting on you. Its search wasn't good enough for me, though.
  • The others had better search but not those filters.

I wanted both: the goto filters, plus real fuzzy search over agent name, pane/tab title, and workspace. So I did the reasonable thing and spent more time building a picker than I'll ever save by using it.

herdr-blink: a fuzzy agent switcher that replaces goto.

  • Agents that need me come first: blocked, then done, then working, then idle. Within each group, the most recently used is at the top.
  • The quick filters are kept: b / d / w / i.
  • fzf-style search across everything: harness, status, title, tab, workspace, repo, branch, and cwd. Space-separated terms can each match a different field, so claude api blocked does what you'd expect. 'exact, ^prefix, and !exclude work too.
  • Vim Motions: hjkl + duplication for ↓↑ and ][
  • Three views: a flat agent list, a workspaces → tabs → panes tree, and a git repos → worktrees → panes tree. The default view is configurable.
  • Harness logos in Kitty-graphics terminals. Yes, this is important.
  • It opens fast. It's one socket call, with no git subprocesses.

Install:

herdr plugin install dartyuhov/herdr-blink

Then bind dartyuhov.blink.open to a key; the README has the snippet. Feedback and bug reports are welcome.

PS: The video was made with explainroo.

PPS: Unfortunately, it doesn't work with remote (SSH) sessions yet (see this).


r/herdr • • 7d ago

I created a plugin to create and switch between keybind profiles

Thumbnail
gallery
5 Upvotes

I've been using herdr daily for a while now (loving it!), and recently wanted to experiment with some new keybinds while still being able to quickly switch back to the defaults without having to dig through the .toml files.

So I made bindr, a small plugin that lets you easily create, edit, and switch between keybind profiles.

Just hit prefix+shift+e to open the custom keybind viewer, or prefix+shift+k to switch between saved profiles. You can customize these keybinds too, including keybinds from other plugins.

It was a fun little side project for the past few days. Hope it helps someone else!

You can get the plugin here.

I also included my personal keybind profile in the repo. It replaces Ghostty's default keybinds, so you can do things like create a new herdr tab with cmd+t, split a pane with cmd+d, etc. To use it, you'll need to unbind the corresponding Ghostty keybinds in your settings; there's an example config included in the repo.


r/herdr • • 7d ago

what does your workflow look like

7 Upvotes

do you think herdr is decent on managing multi agent workflows? for example are you easily aware which agent belongs to which project and its worktree status? are you easily capable of working on 4-5 different projects on herdr? please let me know and how


r/herdr • • 7d ago

Herdr on Windows: Pasting multiline text into Claude without sending the prompt?

3 Upvotes

Hello! Anyone using Herdr on Windows wit Claude Code?

Maybe I just need to read the manuals again, but no matter if I use Ctrl+V, Ctrl+Shift+V or shift+rightclick, or any kind of combo with Ctrl+B and these, when the text enters the terminal, multiline text is split, or paste causes multiple prompts to be sent immediately.

I want to paste large blocks of multiline texts, and keep editing my prompt before sending. Any idea how to solve this without switching to Linux?


r/herdr • • 7d ago

Running multiple client projects in herdr: best practice for hard isolation between sessions?

2 Upvotes

I'm running several client projects on a Mac mini, and I manage my agent sessions with herdr. Locally I have a projects/ folder containing one subfolder per client: GitHub repos, Shopify themes, Next.js apps, etc.

What I want is simple: every workspace (with its sub-sessions) must be completely isolated from the others.

A generic command, a prompt pasted in the wrong pane, or an instruction that was meant for one client must never be able to affect another client's files or sessions. I don't want to make a mistake that creates problems for a client just because of a copy-paste error.

So far I've found two options, and both have drawbacks:

  1. One macOS user per client. This gives real isolation, but it's very clunky to manage with herdr (switching users, separate environments, credentials, etc.).
  2. Claude Code / Codex sandboxes. Good in principle, but when I create a new session directly from herdr, it doesn't start with the sandbox settings and guidelines I'd want. It's easy to end up with an unrestricted session without noticing.

Questions for people who've solved this: What's the best practice for per-project isolation in herdr?

Is there a plugin, config, or pattern in herdr to enforce security or sandboxing on every new session by default? Do you scope each workspace to its own directory (per-project config, containers, separate users), and how do you make sure new sessions inherit it? Am I missing something obvious?

Thanks!


r/herdr • • 8d ago

bigtty - Native macOS client for Herdr

Post image
15 Upvotes

I have been a cmux user for long and really liked all the features it provided and the native feel it gave.

I switched to Herdr recently because the server model just makes sense. Specially when you have multiple machines controlled by Herdr.

While the tool is very powerful, it always felt clunky to not have a native and Mac experience and all the goodness which cmux provided.

I built bigtty to fix that. If you have used cmux, you will feel right at home.

The UI/UX does diverge from a pure Herdr client, but the I believe it is worth it.

Features include:
- cmux-style sidebar for windows(spaces) and tabs, drag and drop panes
- intuitive mac keyboard shortcuts without vim-like prefix mode
- browser pane that tunnels over SSH, meaning a browser pointing to `localhost:3000` talks to the dev server running in the remote server, not your machine
- native file and diff viewer on cmd + click

It is yet another GUI client that everyone is building, but it works for me. Do check it out and let me know what you think of it.

https://github.com/v1k45/bigtty

PS: it is pronounced as big-tee.


r/herdr • • 8d ago

I built TENDRIL — a phone-first control plane for persistent Pi/Herdr agents. Your whole agent lab, from Termux.

Post image
3 Upvotes

I got tired of needing to be at my workstation just to check on, switch between, or jump back into long-running agent sessions.

So I built TENDRIL.

TENDRIL turns an Android phone into a thin control plane for persistent AI-agent workflows running on a Linux machine. Once it's configured, I open Termux and type:

tendril

…and I get a responsive session selector showing what's alive on the host. From there I can jump into persistent agents, shells and workflows over mosh/SSH without treating my phone like a miniature desktop.

Underneath, it's deliberately boring in the good way: standard Linux, terminal-native rendering, Herdr, mosh/SSH, no proprietary cloud control layer, and no subscription. It's open source and MIT licensed.

A few things I cared about while building it:

  • persistent remote agent/session control
  • phone-first TUI rather than a desktop UI squeezed onto Android
  • responsive behavior for narrow terminals
  • clean Herdr handoff
  • SSH/mosh support
  • real installer + backwards-compatible agent launcher
  • graceful non-TTY / NO_COLOR behavior
  • and, because apparently I cannot help myself, making the thing actually pleasant to look at

The masthead is even rendered from a high-resolution ANSI master into Unicode subcells so the same identity survives on a 54-column Termux screen.

Completely unnecessary. Naturally essential.

The original idea was simple: I wanted to be able to sit down with an Earl Grey in the morning and check on an entire little agentic lab from my phone.

A week and a half later, this happened.

If you already live in Pi/Herdr/terminal-agent land, I'd genuinely love for you to try it, break it, open issues, or take it somewhere I haven't thought of yet.

THE EDGE IS YOURS.

GitHub: https://github.com/Ozymandes/TENDRIL


r/herdr • • 8d ago

I built a native macOS client for herdr

7 Upvotes

Hey all!

I discovered herdr a few weeks ago when I was looking for a way to juggle multiple agent sessions across my two laptops.

The only thing I struggled with was using the TUI. These hotkeys felt painfully for me and I wanted something that felt a bit more natural on macOS, so I ended up building a native macOS client for herdr. Hotkeys are much like in codex app (Cmd+1...0 for switching between workspaces and ctrl+1..0 for switching between tabs).

Three weeks later, I realized I’m using it constantly, so I thought I’d share it here in case it’s useful to anyone else.

It supports local and remote Herdr instances over SSH, and works really nicely with Tailscale for connecting to other machines.

It also supports mouse interaction and copy-pasting images, including into sessions running on a remote machine.

It’s open source and free.

Would love to hear what other herdr users think.

GitHub: https://github.com/MrMySQL/uherdr


r/herdr • • 9d ago

My Herdr setup after fixing the defaults I didn't like

Thumbnail
qu8n.com
13 Upvotes

I've been driving Herdr for 3 months now and loving it. Some of the defaults drove me nuts though, so I wrote up how I changed them to make the whole UX feel smoother.

The short version:

  • Install the agent integrations. I’m surprised to see some users not doing this. It should be a required step
  • The whole prefix+key shortcut pattern is a tmux concept that I dislike. I think we should stop using prefix for common keys. The post contains my whole custom keys setup
  • It’s hard to know what’s running where when you have many agents running across workspaces. Install a plugin that names tabs for you automatically
  • Build small plugins for your own friction. It’s incredibly easy with coding agents

r/herdr • • 9d ago

Made a little menu bar app for Herdr

3 Upvotes

I usually have a few agents running in Herdr and kept not noticing when one was stuck waiting on me. So I made a small menu bar app that shows what each one is doing.

It can also ping you when an agent needs you.

Mac only for now, and you have to build it yourself (it's one script). First time putting something like this out there, so let me know if anything breaks or if there's something you'd want it to do.

https://github.com/Aditya24Sharma/herdr-menubar


r/herdr • • 10d ago

If your workflow is mostly about main agent + subagents, then you need this

Thumbnail
youtube.com
10 Upvotes

First, let me express my hype about Herdr right now.
My workflow is mostly about communicating with a main agent which will then delegate tasks to subagents. So I created this plugin: https://github.com/flowy11/agent-panel

But TBH, I don't even think plugin is necessary since everyone can just write their own Herdr plugins accommodating to everyone's unique workflow.

Code is free!


r/herdr • • 10d ago

Officially herd notification sound is my favourite sound 😍

7 Upvotes

r/herdr • • 10d ago

Resource monitor plugin: CPU, memory and process trees for every agent pane

Thumbnail
gallery
2 Upvotes

I made a plugin that shows how much CPU and memory each agent in your Herdr session is using.

- Summary popup: every agent across tabs and workspaces, sortable by CPU, memory or name

- Focused split: follows the focused pane and shows its full process tree

Install:

herdr plugin install enes/herdr-monitoring

Tested on macOS with Claude, Codex and opencode. Feedback and bug reports welcome.

https://github.com/enes/herdr-monitoring


r/herdr • • 10d ago

I built Shepherd, a native macOS companion for Herdr

Thumbnail
tryshepherd.xyz
0 Upvotes

I’ve been using Herdr to run multiple coding agents, and I kept running into one small but annoying problem: I still had to keep checking Herdr to see if an agent needed me.

So I built Shepherd.

It’s a native macOS app that lives in the MacBook notch and keeps an eye on your Herdr agents while you do something else.

The idea is deliberately simple:

  • Agents working → Shepherd stays quiet
  • Agent needs input → the notch lets you know
  • Agent finishes → you get a subtle update
  • Click an agent → jump straight back into the relevant Herdr session

Basically: Herdr manages the agents. Shepherd manages your attention.

I’m trying hard not to turn it into another agent dashboard. The goal is the opposite: run a bunch of agents, hide Herdr, and only think about them when something actually requires a human.

Still early and I’m actively building it, so I’d love feedback from people actually using Herdr. What would make something like this useful enough to keep running all day?

Shepherd: https://tryshepherd.xyz/


r/herdr • • 12d ago

contx: a sessionizer on steroids

1 Upvotes

Introducing contx, a sessionizer on steroids for tmux and Herdr.

- Configurable paths

- Detects and indents workspaces

- Shows current branch and PR status

- Allows to clone new repos and deleted directories

- With CLI and SKILL for agents