htlin222

Herdr Gamepad — AI skill for Claude Code

AI community

Drive Herdr with a game controller.

How to install Herdr Gamepad

This entry records only its repository, not the path inside it, so there is no exact command to give. Open htlin222/herdr-gamepad and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Herdr Gamepad does

Drive Herdr with a game controller. Patrol your AI agents, split panes and switch workspaces from the couch — any gamepad, mapped by you in 60 seconds.

Alternatives in AI

Claude Squad — by smtg-ai - Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents i 6.5k ★
Pebrel — AI-native, GPU-accelerated terminal emulator for Windows with SSH, persistent sessions, split panes, and first 670 ★
Nebula — AI-native, GPU-accelerated terminal emulator for Windows with SSH, persistent sessions, split panes, and first 587 ★

README

herdr-gamepad — drive Herdr with a game controller

herdr-gamepad

Drive Herdr with a game controller. Patrol your AI agents, split panes, and switch workspaces from the couch — any gamepad, mapped by you in 60 seconds.

Open the configurator — plug a pad in, press buttons, pick actions from a dropdown, copy the generated gamepad.toml.

The default layout

Annotated gamepad showing the default herdr-gamepad bindings: triggers cycle agents, bumpers cycle tabs, D-pad focuses panes, sticks scroll and send arrow keys, and holding BACK opens a prefix layer for zoom, splits and panels.

Install

Paste this at your coding agent (Claude Code, Codex, Cursor — anything with a shell):

Install the herdr-gamepad plugin from https://github.com/htlin222/herdr-gamepad
into my Herdr setup on macOS. Work through it step by step and stop to tell me
whenever you need something from me:

1. Check that `herdr` is on PATH and is version 0.7.0 or newer (`herdr --version`),
   and that `swiftc` exists (`swiftc --version`). If swiftc is missing, tell me to
   run `xcode-select --install` and wait.
2. Install the plugin: `herdr plugin install https://github.com/htlin222/herdr-gamepad`
   This runs build.sh, which compiles a single dependency-free Swift binary.
3. Copy the sample config into place:
   `cp config/gamepad.toml "$(herdr plugin config-dir gamepad)/gamepad.toml"`
4. Add a keybinding to ~/.config/herdr/config.toml so I can reach learn mode:
       [[keys.command]]
       key = "prefix+g"
       type = "plugin_action"
       command = "gamepad.learn"
       description = "Gamepad learn mode"
   then `herdr server reload-config`.
5. Start the