{"id":51726683,"url":"https://github.com/agustinvalencia/herdr-jump","last_synced_at":"2026-07-17T20:06:32.266Z","repository":{"id":368880612,"uuid":"1287253906","full_name":"agustinvalencia/herdr-jump","owner":"agustinvalencia","description":"Separate overlay pickers for herdr spaces and agents — jump to any workspace or agent, with live status colours","archived":false,"fork":false,"pushed_at":"2026-07-02T15:18:19.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-02T17:25:25.925Z","etag":null,"topics":["herdr-plugin"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agustinvalencia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-02T14:14:47.000Z","updated_at":"2026-07-02T15:19:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/agustinvalencia/herdr-jump","commit_stats":null,"previous_names":["agustinvalencia/herdr-jump"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/agustinvalencia/herdr-jump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agustinvalencia%2Fherdr-jump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agustinvalencia%2Fherdr-jump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agustinvalencia%2Fherdr-jump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agustinvalencia%2Fherdr-jump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agustinvalencia","download_url":"https://codeload.github.com/agustinvalencia/herdr-jump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agustinvalencia%2Fherdr-jump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35594121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-17T02:00:06.162Z","response_time":116,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["herdr-plugin"],"created_at":"2026-07-17T20:06:29.245Z","updated_at":"2026-07-17T20:06:32.254Z","avatar_url":"https://github.com/agustinvalencia.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# herdr-jump\n\nTwo [herdr](https://herdr.dev) overlay pickers that browse **spaces** and\n**agents** *separately* — unlike the built-in session navigator, which shows\neverything together.\n\n- **Agents picker** — every detected agent, grouped by space in the same order as\n  herdr's sidebar (workspace order, tab order preserved), with a status dot\n  coloured by state (green idle · yellow working · red blocked · teal done). Pick\n  one to focus it.\n- **Spaces picker** — every workspace with its status and pane/tab counts. Pick\n  one to switch to it.\n\nBoth open as temporary **overlay** pop-ups; herdr restores your previous focus\nwhen you dismiss them.\n\n## How it works\n\nherdr exposes pop-ups as plugin **panes** with `placement = \"overlay\"`. Each\naction (`agents`, `spaces`) asks herdr to open its picker pane via\n`herdr plugin pane open --placement overlay`; the picker is a small\n[bubbletea](https://github.com/charmbracelet/bubbletea) TUI that reads\n`herdr agent list` / `herdr workspace list` (over `$HERDR_BIN_PATH`) and calls\n`herdr agent focus` / `herdr workspace focus` on your selection.\n\n## Install\n\nRequires **herdr ≥ 0.7.0**.\n\n```bash\nherdr plugin install agustinvalencia/herdr-jump\n```\n\nherdr clones the repo, runs `scripts/build.sh`, and registers the actions. The\nbuild step **prefers a local Go toolchain** (an exact build of the source) and\n**falls back to downloading the latest prebuilt release binary** — so it works\n**with or without Go**.\n\n**Local development:** build and link a checkout in place:\n\n```bash\nsh scripts/build.sh\nherdr plugin link /path/to/herdr-jump\n```\n\n## Keybindings\n\nBound in `~/.config/herdr/config.toml` (reload with `herdr server reload-config`):\n\n```toml\n[[keys.command]]\nkey = \"prefix+a\"\ntype = \"plugin_action\"\ncommand = \"agustinvalencia.herdr-jump.agents\"\n\n[[keys.command]]\nkey = \"prefix+A\"\ntype = \"plugin_action\"\ncommand = \"agustinvalencia.herdr-jump.spaces\"\n```\n\n## Keys inside a picker\n\nModal (lazygit-style):\n\n- **nav mode** (default): `j`/`k` or `↑`/`↓` (or `Ctrl+n`/`Ctrl+p`) move · `1`–`9`\n  jump to and select that item directly · `g`/`G` top/bottom · `Enter` focuses\n  the highlighted item · `/` starts filtering · `q`/`Esc` cancel.\n- **filter mode** (after `/`): type to fuzzy-filter · `Enter` focuses · `Esc`\n  clears the filter and returns to nav mode.\n\n## Configuration\n\nSettings live in `config.toml` in the plugin config dir (survives upgrades):\n\n```bash\n\"$(herdr plugin config-dir agustinvalencia.herdr-jump)/config.toml\"\n```\n\nSee [`config.example.toml`](config.example.toml). Keys:\n\n```toml\n# Where the picker card sits in the overlay pane.\n# Horizontal: left | center | right   Vertical: top | middle | bottom\n# Combine them, e.g. \"center\", \"top-left\", \"bottom right\", \"top\".\nalign = \"center\"\n\n# Cap the card width in columns so it reads as a centered card on wide panes.\n# 0 disables the cap.\nmax_width = 96\n```\n\nThe card is centered by default, so on a large multi-pane window it stays under\nyour eyes rather than pinned to the top-left corner. (`HERDR_JUMP_ALIGN` still\noverrides `align` at runtime if set — handy for quick testing.)\n\n## Debugging\n\n`HERDR_BIN_PATH=$(command -v herdr) ./bin/herdr-jump dump` prints the agents and\nspaces the pickers would show, as plain text (no TUI) — handy for checking the\nherdr CLI integration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagustinvalencia%2Fherdr-jump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagustinvalencia%2Fherdr-jump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagustinvalencia%2Fherdr-jump/lists"}