How wraithyy/herdr-waypoint works
herdr-waypoint is a herdr plugin for saving folders as named waypoints and reopening them as focused workspaces. The main workflow saves the current workspace folder and label, then lets a user choose a saved waypoint in a terminal picker and create a workspace from it. The README documents both fzf and fallback pickers, rename/delete, previews, direct CLI saving, and keybinding setup. Relationships below follow those documented behaviors; source excerpts were unavailable, so uncertain internal wiring is omitted.
Main entry points: pane-pick fzf Picker · lib.sh Waypoint Operations · pick-fallback Fallback Picker · action-add.sh Add Action
Components 18
Save Waypoints
- Add Action
bin/action-add.sh - CLI Add
bin/cli-add
Pick And Open
- Pick Action
bin/open-pick.sh - Pane Picker
bin/pane-pick - fzf Picker
bin/pane-pick - Fallback Picker
bin/pick-fallback
Waypoint Store
- Rename Command
bin/wp-rename - Remove Command
bin/wp-rm - Waypoint Operations
bin/lib.sh - Waypoints File
herdr Integration
- herdr Server
- Workspace Context
- Workspace Create
- Keybinding Setup
bin/install-keybinds.sh
Other components
- User
- fzf
- git status
- ls -la
Connections 26
- User → Add Action: save key
- herdr Server → Add Action: dispatches
- Add Action → Workspace Context: reads context
- Add Action → Waypoint Operations: adds waypoint
- User → CLI Add: runs command
- CLI Add → Waypoint Operations: adds waypoint
- Waypoint Operations → Waypoints File: reads and writes
- User → Pick Action: pick key
- herdr Server → Pick Action: dispatches
- Pick Action → Pane Picker: opens overlay
- Pane Picker → fzf Picker: uses when available
- Pane Picker → Fallback Picker: otherwise uses
- fzf Picker → Waypoints File: reads entries
- Fallback Picker → Waypoints File: reads entries
- fzf Picker → Rename Command: invokes
- fzf Picker → Remove Command: invokes
- Fallback Picker → Waypoint Operations: renames or removes
- Rename Command → Waypoint Operations: renames
- Remove Command → Waypoint Operations: removes
- fzf Picker → git status: previews status
- fzf Picker → ls -la: fallback preview
- fzf Picker → Workspace Create: opens selection
- Fallback Picker → Workspace Create: opens selection
- Workspace Create → herdr Server: creates focused workspace
- herdr Server → Keybinding Setup: runs startup hook
- Keybinding Setup → herdr Server: binds actions