From 2eeea9a0cd8665bbe0e6c80f08603425498757e5 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Sun, 21 Jun 2026 17:24:17 +0300 Subject: feat: add plugin marketplace --- website/src/components/MarketingLayout.astro | 6 +- website/src/components/SiteTitle.astro | 2 +- website/src/content.config.ts | 11 - website/src/content/blog/herdr-0-6-3.md | 85 ++++ website/src/content/docs/marketplace.mdx | 54 ++- website/src/content/docs/plugins.mdx | 15 +- website/src/content/releases/v0-6-3.md | 86 ---- website/src/data/plugins-fixture.json | 139 +++++++ website/src/pages/compare.astro | 6 +- website/src/pages/plugins.astro | 601 +++++++++++++++++++++++++++ website/src/pages/releases/[...slug].astro | 89 ---- website/src/pages/releases/index.astro | 42 -- 12 files changed, 874 insertions(+), 262 deletions(-) create mode 100644 website/src/content/blog/herdr-0-6-3.md delete mode 100644 website/src/content/releases/v0-6-3.md create mode 100644 website/src/data/plugins-fixture.json create mode 100644 website/src/pages/plugins.astro delete mode 100644 website/src/pages/releases/[...slug].astro delete mode 100644 website/src/pages/releases/index.astro (limited to 'website/src') diff --git a/website/src/components/MarketingLayout.astro b/website/src/components/MarketingLayout.astro index a4df022f..381daf03 100644 --- a/website/src/components/MarketingLayout.astro +++ b/website/src/components/MarketingLayout.astro @@ -58,7 +58,7 @@ const ogImageUrl = new URL(ogImage, 'https://herdr.dev').toString(); document.documentElement.setAttribute("data-palette", saved || system); })(); - +
@@ -76,7 +76,7 @@ const ogImageUrl = new URL(ogImage, 'https://herdr.dev').toString();
Home Compare - Releases + Plugins Blog Quick start Docs @@ -88,7 +88,7 @@ const ogImageUrl = new URL(ogImage, 'https://herdr.dev').toString();
Home Compare - Releases + Plugins Blog Quick start Docs diff --git a/website/src/components/SiteTitle.astro b/website/src/components/SiteTitle.astro index d35da5d6..f6a3b7d0 100644 --- a/website/src/components/SiteTitle.astro +++ b/website/src/components/SiteTitle.astro @@ -11,7 +11,7 @@ const docsHref = isPreview ? '/docs/preview/' : '/docs/';
diff --git a/website/src/content.config.ts b/website/src/content.config.ts index ba0c83f8..bb0f2d8a 100644 --- a/website/src/content.config.ts +++ b/website/src/content.config.ts @@ -21,15 +21,4 @@ export const collections = { ogImage: z.string().optional(), }), }), - releases: defineCollection({ - loader: glob({ pattern: '*.md', base: './src/content/releases' }), - schema: z.object({ - title: z.string(), - version: z.string(), - path: z.string(), - description: z.string(), - date: z.coerce.date(), - draft: z.boolean().default(false), - }), - }), }; diff --git a/website/src/content/blog/herdr-0-6-3.md b/website/src/content/blog/herdr-0-6-3.md new file mode 100644 index 00000000..97bd2b28 --- /dev/null +++ b/website/src/content/blog/herdr-0-6-3.md @@ -0,0 +1,85 @@ +--- +title: "Herdr 0.6.3: session persistence, safer updates, and workspace navigation" +description: "This one adds new persistence paths for updates, server restarts, and larger sessions." +date: 2026-05-27 +draft: false +--- + +## Persistence for the hard parts + +Session persistence is not one feature. A detached client, a stopped server, a terminal history replay, an agent conversation restore, and an update handoff all protect different parts of the workspace. + +Herdr 0.6.3 pushes on three of those boundaries. + +### Agent restore after server restart + +When a Herdr server stops, normal pane processes stop with it. Native agent restore is the path for getting supported agent conversations back after that kind of restart. + +With `[session] resume_agents_on_restore = true`, Herdr can use official session references from supported integrations to relaunch Pi, Claude Code, Codex, OpenCode, and Hermes panes into their previous conversations. + +[Read the session restore docs](/docs/session-state/#native-agent-session-restore). + +### Pane screen history + +Pane screen history solves the visual half of restart recovery. When enabled, Herdr saves recent pane output and replays it into restored panes so the workspace does not come back as a set of empty terminals. + +It is useful for shells, logs, dev servers, and agent panes where recent output explains what was happening before the server stopped. + +[Read how pane history differs from live persistence](/docs/session-state/#what-survives). + +### Live handoff for updates + +Live handoff is the update path for supported running sessions. Instead of stopping the old server and killing pane processes, Herdr can ask the old server to transfer live PTY ownership to the updated server. + +It is currently experimental and opt-in with `herdr update --handoff` and `herdr --remote --handoff`. That keeps the default path conservative while the feature gets more real-world coverage. + +[Read the live handoff docs](/docs/session-state/#live-handoff). + +For the technical background, read the deep dive: [Live updates without killing your terminal processes](/blog/live-updates-without-killing-your-terminal-processes/). + +## Session navigator + +Large Herdr sessions need fast movement. The new session navigator opens with `prefix+g` and gives you a searchable workspace, tab, and pane tree. + +At a glance, you can see the full tree of workspaces, tabs, and panes. Press `/` to fuzzy find by text. Press `b`, `w`, `i`, or `d` to filter by blocked, working, idle, or done panes. Press `a` or Backspace to clear the state filter. + +Use it to jump straight to the pane that needs attention without manually scanning the sidebar. + +
+ +
+ The session navigator shows workspaces, tabs, panes, and agent states in one searchable tree. +
+
+ +## More terminal workflow polish + +Direct agent terminal attaches now have scrollback, so PageUp, PageDown, and mouse wheel scrolling work in the attach viewport when the running terminal app has not requested that input for itself. + +Herdr also gained better update and remote-bootstrap behavior for package-manager installs, more reliable event delivery under load, and fixes across agent detection, terminal colors, sound alerts, and integration lifecycle handling. + +## Pane metadata reporting + +The new `pane.report_metadata` socket method and `herdr pane report-metadata` CLI command let integrations and local hooks customize what Herdr shows for a pane. + +After installing an integration, the integration can report a title, visible agent name, compact status label, state label, and native session metadata without taking over unrelated lifecycle behavior. + +You can also use it from your own scripts. For example, a hook can mark a pane as running a deploy, rename a long-lived task, or ask an agent to report a more specific state for the work it is doing. + +```bash +herdr pane report-metadata \ + --title "api deploy" \ + --agent-name "codex" \ + --state-label "reviewing logs" \ + --compact-status "deploy" +``` + +This gives integrations a supported way to make panes more readable while keeping Herdr's session and agent ownership rules intact. + +[Read the socket API docs](/docs/socket-api/). + +## Full notes + +This page highlights the product changes. The complete release notes remain on GitHub. + +[Open the 0.6.3 GitHub release](https://github.com/ogulcancelik/herdr/releases/tag/v0.6.3). diff --git a/website/src/content/docs/marketplace.mdx b/website/src/content/docs/marketplace.mdx index f07b8f87..09a27b2d 100644 --- a/website/src/content/docs/marketplace.mdx +++ b/website/src/content/docs/marketplace.mdx @@ -1,39 +1,53 @@ --- title: Marketplace -description: Publish and share Herdr plugins, and get listed when the marketplace launches. +description: Discover community Herdr plugins on GitHub, and get your own plugin listed. --- -The Herdr plugin marketplace is a discoverable index of installable plugins. It -is not live yet. This page is how to be ready for it. +The Herdr plugin marketplace is a discoverable index of community plugins. +Browse it at [herdr.dev/plugins](/plugins/). It is an automatic index of public +GitHub repositories, not a reviewed catalog. -## Share a plugin today +## Browse plugins + +The [marketplace](/plugins/) lists every public repository tagged with the +GitHub topic `herdr-plugin`. Search by name, owner, description, or language, +and sort by popularity, recent activity, or newest. Each listing links straight +to its source repository on GitHub. + +Discovery is automatic and unreviewed. A listing means a repository tagged +itself, not that Herdr vetted it, so the +[trust guidance](/docs/plugins/#trust-and-security) applies before you install +anything. + +## Install a plugin The marketplace adds discovery on top of installation; it does not replace it. -Anyone can already install your plugin straight from GitHub: +Install any plugin straight from GitHub: ```bash herdr plugin install owner/repo[/subdir...] ``` Publish a normal public GitHub repository with a `herdr-plugin.toml` manifest at -its root, or in a subdirectory, and that command works now. See +its root, or in a subdirectory, and that command works. See [Plugins](/docs/plugins/) for the manifest and authoring reference. -## Get listed when it launches +## Get your plugin listed -If you want your plugin to appear in the website marketplace when discovery -launches, add the GitHub topic `herdr-plugin` to your repository now. That -topic is the signal the future index will use for discovery, so tagging a -public plugin today means it can be listed when the marketplace goes live. +Add the GitHub topic `herdr-plugin` to a public repository. That topic is the +only signal the index uses, so tagging a public plugin is all it takes. The +index refreshes automatically every 30 minutes, so a newly tagged repository +shows up shortly after, and one that drops the topic disappears on the next +refresh. -## What a listing will show +## What a listing shows -A marketplace card will surface your plugin's `id`, `name`, `description`, -declared `platforms`, and a link back to the source repository. Getting that -manifest metadata right today is what makes your listing accurate later. Declare -`platforms` honestly, because the index will use it to show where a plugin runs. +Each card shows GitHub repository metadata: the repository name and owner, its +description, star count, primary language, and the time it was last pushed, with +a link back to the source. The index reads this from GitHub's repository search, +so keeping your repository description and topics accurate is what makes your +listing useful. -Plugins stay ordinary GitHub repositories. The marketplace is a discovery layer -on top of the same `herdr plugin install` path you can use now. A listing makes a -plugin easier to find; it does not mean Herdr has reviewed it, so the -[trust guidance](/docs/plugins/#trust-and-security) still applies. +The index does not parse `herdr-plugin.toml` yet, so manifest fields like the +plugin `id`, declared `platforms`, and `min_herdr_version` are not shown in v1. +Forks and archived repositories are excluded from the list. diff --git a/website/src/content/docs/plugins.mdx b/website/src/content/docs/plugins.mdx index 9f069fdf..9f57ff47 100644 --- a/website/src/content/docs/plugins.mdx +++ b/website/src/content/docs/plugins.mdx @@ -304,10 +304,11 @@ state should own their files or database. ## Marketplace -A plugin marketplace is coming. Plugins are already shareable today: publish a -GitHub repository with `herdr-plugin.toml`, then share -`herdr plugin install owner/repo[/subdir]`. - -If you want the plugin to appear in the website marketplace when discovery -launches, add the GitHub topic `herdr-plugin` to the repository now. See -[Marketplace](/docs/marketplace/) for how publishing and discovery will work. +Community plugins are discoverable in the [marketplace](/plugins/), an automatic +index of public GitHub repositories tagged with the topic `herdr-plugin`. +Plugins stay ordinary GitHub repositories: publish one with `herdr-plugin.toml`, +then share `herdr plugin install owner/repo[/subdir]`. + +To get a plugin listed, add the GitHub topic `herdr-plugin` to its public +repository. The index refreshes every 30 minutes. See +[Marketplace](/docs/marketplace/) for how discovery works. diff --git a/website/src/content/releases/v0-6-3.md b/website/src/content/releases/v0-6-3.md deleted file mode 100644 index 23514cc6..00000000 --- a/website/src/content/releases/v0-6-3.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: "session persistence, safer updates, and workspace navigation" -version: "0.6.3" -path: "0.6.3/session-persistence-safer-updates-and-workspace-navigation" -description: "This one adds new persistence paths for updates, server restarts, and larger sessions." -date: 2026-05-27 ---- - -## Persistence for the hard parts - -Session persistence is not one feature. A detached client, a stopped server, a terminal history replay, an agent conversation restore, and an update handoff all protect different parts of the workspace. - -Herdr 0.6.3 pushes on three of those boundaries. - -### Agent restore after server restart - -When a Herdr server stops, normal pane processes stop with it. Native agent restore is the path for getting supported agent conversations back after that kind of restart. - -With `[session] resume_agents_on_restore = true`, Herdr can use official session references from supported integrations to relaunch Pi, Claude Code, Codex, OpenCode, and Hermes panes into their previous conversations. - -[Read the session restore docs](/docs/session-state/#native-agent-session-restore). - -### Pane screen history - -Pane screen history solves the visual half of restart recovery. When enabled, Herdr saves recent pane output and replays it into restored panes so the workspace does not come back as a set of empty terminals. - -It is useful for shells, logs, dev servers, and agent panes where recent output explains what was happening before the server stopped. - -[Read how pane history differs from live persistence](/docs/session-state/#what-survives). - -### Live handoff for updates - -Live handoff is the update path for supported running sessions. Instead of stopping the old server and killing pane processes, Herdr can ask the old server to transfer live PTY ownership to the updated server. - -It is currently experimental and opt-in with `herdr update --handoff` and `herdr --remote --handoff`. That keeps the default path conservative while the feature gets more real-world coverage. - -[Read the live handoff docs](/docs/session-state/#live-handoff). - -For the technical background, read the deep dive: [Live updates without killing your terminal processes](/blog/live-updates-without-killing-your-terminal-processes/). - -## Session navigator - -Large Herdr sessions need fast movement. The new session navigator opens with `prefix+g` and gives you a searchable workspace, tab, and pane tree. - -At a glance, you can see the full tree of workspaces, tabs, and panes. Press `/` to fuzzy find by text. Press `b`, `w`, `i`, or `d` to filter by blocked, working, idle, or done panes. Press `a` or Backspace to clear the state filter. - -Use it to jump straight to the pane that needs attention without manually scanning the sidebar. - -
- -
- The session navigator shows workspaces, tabs, panes, and agent states in one searchable tree. -
-
- -## More terminal workflow polish - -Direct agent terminal attaches now have scrollback, so PageUp, PageDown, and mouse wheel scrolling work in the attach viewport when the running terminal app has not requested that input for itself. - -Herdr also gained better update and remote-bootstrap behavior for package-manager installs, more reliable event delivery under load, and fixes across agent detection, terminal colors, sound alerts, and integration lifecycle handling. - -## Pane metadata reporting - -The new `pane.report_metadata` socket method and `herdr pane report-metadata` CLI command let integrations and local hooks customize what Herdr shows for a pane. - -After installing an integration, the integration can report a title, visible agent name, compact status label, state label, and native session metadata without taking over unrelated lifecycle behavior. - -You can also use it from your own scripts. For example, a hook can mark a pane as running a deploy, rename a long-lived task, or ask an agent to report a more specific state for the work it is doing. - -```bash -herdr pane report-metadata \ - --title "api deploy" \ - --agent-name "codex" \ - --state-label "reviewing logs" \ - --compact-status "deploy" -``` - -This gives integrations a supported way to make panes more readable while keeping Herdr's session and agent ownership rules intact. - -[Read the socket API docs](/docs/socket-api/). - -## Full notes - -This page highlights the product changes. The complete release notes remain on GitHub. - -[Open the 0.6.3 GitHub release](https://github.com/ogulcancelik/herdr/releases/tag/v0.6.3). diff --git a/website/src/data/plugins-fixture.json b/website/src/data/plugins-fixture.json new file mode 100644 index 00000000..27a9c265 --- /dev/null +++ b/website/src/data/plugins-fixture.json @@ -0,0 +1,139 @@ +{ + "schemaVersion": 1, + "generatedAt": "2026-06-20T12:00:00.000Z", + "source": { + "provider": "github", + "query": "topic:herdr-plugin", + "totalCount": 7, + "collectedCount": 7, + "truncated": false + }, + "plugins": [ + { + "id": 123456789, + "fullName": "ogulcancelik/herdr-plugin-github-start", + "owner": "ogulcancelik", + "name": "herdr-plugin-github-start", + "description": "Start Codex or Claude from a GitHub issue, PR, or discussion without leaving the terminal.", + "url": "https://github.com/ogulcancelik/herdr-plugin-github-start", + "stars": 42, + "forks": 3, + "openIssues": 1, + "language": "TypeScript", + "topics": ["herdr-plugin", "github", "agents"], + "createdAt": "2026-05-01T00:00:00Z", + "updatedAt": "2026-06-19T19:58:26Z", + "pushedAt": "2026-06-19T19:58:26Z", + "archived": false, + "fork": false + }, + { + "id": 223456789, + "fullName": "ogulcancelik/herdr-plugin-examples", + "owner": "ogulcancelik", + "name": "herdr-plugin-examples", + "description": "Cookbook of example Herdr plugins: telegram notify, link preview, dev layout bootstrap.", + "url": "https://github.com/ogulcancelik/herdr-plugin-examples", + "stars": 28, + "forks": 6, + "openIssues": 0, + "language": "JavaScript", + "topics": ["herdr-plugin", "examples"], + "createdAt": "2026-04-12T00:00:00Z", + "updatedAt": "2026-06-18T08:10:00Z", + "pushedAt": "2026-06-18T08:10:00Z", + "archived": false, + "fork": false + }, + { + "id": 323456789, + "fullName": "lindqvist/herdr-board", + "owner": "lindqvist", + "name": "herdr-board", + "description": "A live project board pane for Herdr that tracks agent tasks across worktrees.", + "url": "https://github.com/lindqvist/herdr-board", + "stars": 19, + "forks": 1, + "openIssues": 4, + "language": "Rust", + "topics": ["herdr-plugin", "pane", "kanban"], + "createdAt": "2026-05-20T00:00:00Z", + "updatedAt": "2026-06-17T14:02:00Z", + "pushedAt": "2026-06-17T14:02:00Z", + "archived": false, + "fork": false + }, + { + "id": 423456789, + "fullName": "mira-dev/herdr-layout-presets", + "owner": "mira-dev", + "name": "herdr-layout-presets", + "description": "Apply opinionated split-pane layouts per project with one keybinding.", + "url": "https://github.com/mira-dev/herdr-layout-presets", + "stars": 11, + "forks": 0, + "openIssues": 2, + "language": "Lua", + "topics": ["herdr-plugin", "layout"], + "createdAt": "2026-06-01T00:00:00Z", + "updatedAt": "2026-06-15T09:30:00Z", + "pushedAt": "2026-06-15T09:30:00Z", + "archived": false, + "fork": false + }, + { + "id": 523456789, + "fullName": "okabe/herdr-jira-bridge", + "owner": "okabe", + "name": "herdr-jira-bridge", + "description": "Open Jira tickets as Herdr workspaces and push agent summaries back as comments.", + "url": "https://github.com/okabe/herdr-jira-bridge", + "stars": 7, + "forks": 2, + "openIssues": 0, + "language": "Python", + "topics": ["herdr-plugin", "jira", "integration"], + "createdAt": "2026-05-28T00:00:00Z", + "updatedAt": "2026-06-10T11:45:00Z", + "pushedAt": "2026-06-10T11:45:00Z", + "archived": false, + "fork": false + }, + { + "id": 623456789, + "fullName": "noor/herdr-notify", + "owner": "noor", + "name": "herdr-notify", + "description": "Desktop and mobile notifications when an agent finishes, blocks, or needs input.", + "url": "https://github.com/noor/herdr-notify", + "stars": 4, + "forks": 0, + "openIssues": 1, + "language": "Go", + "topics": ["herdr-plugin", "notifications"], + "createdAt": "2026-06-05T00:00:00Z", + "updatedAt": "2026-06-08T16:20:00Z", + "pushedAt": "2026-06-08T16:20:00Z", + "archived": false, + "fork": false + }, + { + "id": 723456789, + "fullName": "small-tools/herdr-snippet-runner", + "owner": "small-tools", + "name": "herdr-snippet-runner", + "description": null, + "url": "https://github.com/small-tools/herdr-snippet-runner", + "stars": 0, + "forks": 0, + "openIssues": 0, + "language": null, + "topics": ["herdr-plugin"], + "createdAt": "2026-06-14T00:00:00Z", + "updatedAt": "2026-06-14T10:00:00Z", + "pushedAt": "2026-06-14T10:00:00Z", + "archived": false, + "fork": false + } + ] +} diff --git a/website/src/pages/compare.astro b/website/src/pages/compare.astro index 0825ea68..f120ac59 100644 --- a/website/src/pages/compare.astro +++ b/website/src/pages/compare.astro @@ -45,7 +45,7 @@ document.documentElement.setAttribute("data-palette", saved || system); })(); - +
@@ -63,7 +63,7 @@
Home Compare - Releases + Plugins Blog Quick start Docs @@ -75,7 +75,7 @@
Home Compare - Releases + Plugins Blog Quick start Docs diff --git a/website/src/pages/plugins.astro b/website/src/pages/plugins.astro new file mode 100644 index 00000000..6e96a132 --- /dev/null +++ b/website/src/pages/plugins.astro @@ -0,0 +1,601 @@ +--- +import MarketingLayout from '../components/MarketingLayout.astro'; +import fixture from '../data/plugins-fixture.json'; + +const snapshotUrl = 'https://assets.herdr.dev/plugins/index.json'; + +// Seed the page server-side from the public R2 snapshot so `bun run dev` and +// the production build both render real data immediately. If the live fetch +// fails, dev falls back to a local fixture for offline design; production seeds +// empty and lets the client fetch fill it (never fake data). +let liveData = null; +try { + const res = await fetch(snapshotUrl); + if (res.ok) liveData = await res.json(); +} catch { + // ignore: handled by the fallbacks below +} +const initialData = liveData ?? (import.meta.env.DEV ? fixture : null); +const initialIsFixture = !liveData && import.meta.env.DEV; +const apiUrl = import.meta.env.DEV ? null : snapshotUrl; +--- + + +
+
+

# marketplace

+

Plugins built on Herdr.

+

+ Community plugins published on GitHub. Install any of them with + herdr plugin install, or publish your own and get listed. +

+

+ + Listings are discovered automatically from the GitHub topic + herdr-plugin. They are not reviewed by Herdr, so install at + your own discretion. Trust guidance. +

+
+ +
+
+ + +
+ +

+
+ +
+
+
Loading plugins…
+
+ +
+
+

# publish

+

Want your plugin listed?

+

+ Add the GitHub topic herdr-plugin to a public repository + with a herdr-plugin.toml manifest. The index picks it up + on the next refresh. No submission, no review queue. +

+
+ How publishing works + Author a plugin +
+
+
+
+ + + + + diff --git a/website/src/pages/releases/[...slug].astro b/website/src/pages/releases/[...slug].astro deleted file mode 100644 index 420d4b9e..00000000 --- a/website/src/pages/releases/[...slug].astro +++ /dev/null @@ -1,89 +0,0 @@ ---- -import { getCollection, render } from 'astro:content'; -import MarketingLayout from '../../components/MarketingLayout.astro'; - -export async function getStaticPaths() { - const releases = await getCollection('releases'); - return releases - .filter((release) => !release.data.draft) - .map((release) => { - const slug = release.data.path; - return { - params: { slug }, - props: { release, slug }, - }; - }); -} - -const { release, slug } = Astro.props; -const { Content, headings } = await render(release); -const sectionHeadings = headings.filter((heading) => heading.depth === 2); ---- - - -
-
- - -
-
-

- Releases - {release.data.version} - -

-

{release.data.title}

-

{release.data.description}

-
-
- -
-
-
-
- - - diff --git a/website/src/pages/releases/index.astro b/website/src/pages/releases/index.astro deleted file mode 100644 index 48263ab9..00000000 --- a/website/src/pages/releases/index.astro +++ /dev/null @@ -1,42 +0,0 @@ ---- -import { getCollection } from 'astro:content'; -import MarketingLayout from '../../components/MarketingLayout.astro'; - -const releases = (await getCollection('releases')) - .filter((release) => !release.data.draft) - .map((release) => ({ ...release, slug: release.data.path })) - .sort((a, b) => b.data.date.valueOf() - a.data.date.valueOf()); ---- - - -
-
-

Releases

-

What changed in Herdr.

-

- See what the herd has been working on. -

-
- -
-
- {releases.map((release) => ( - - ))} -
-
-
- -- cgit v1.2.3