HiveHub API

HiveHub answers at https://hivehub.griiken.workers.dev. Every response is JSON, except the command itself. Reading needs no sign-in. Publishing needs a GitHub sign-in: Signing in to HiveHub.

Using HiveHub's public API, write a small script that lists its plugins of one kind.

1. Ask me which kind I want: agent, view, widget or tool.
2. Call `GET https://hivehub.griiken.workers.dev/api/v1/plugins?type=<kind>&sort=new`. It needs no sign-in.
3. For each plugin in `plugins`, print its `id`, `version`, `publisher`, `installs` and `description`, and every line of `does` indented below it.
4. Do not call `/resolve`: it counts an install.
5. Run it and show me the output.

REFERENCE https://hivemind.griiken.com/guide/hivehub-api.md

RoutesCopy Anchor Link

<id> is a view's or widget's @owner/name, a tool's owner/name, or an agent's name, such as gemini. The GET routes under /api/v1/plugins and the index allow any origin, so a web page can call them.

The indexCopy Anchor Link

GET /api/v1/index.json. Every plugin of every kind, in the shape Hivemind installs from. Hivemind reads it from Settings → Plugins, or from the address in HIVEMIND_PLUGIN_INDEX.

curl -s https://hivehub.griiken.workers.dev/api/v1/index.json

{
  "version": 1,
  "plugins": [
    {
      "id": "dip497/worktrees",
      "type": "tool",
      "name": "Worktrees",
      "description": "Every git worktree of the repository: its branch, uncommitted changes and how far it is from the base; review one with an agent, remove the merged ones.",
      "author": "dip497",
      "version": "1.0.0",
      "path": "tools/worktrees",
      "source": "https://raw.githubusercontent.com/dip497/hivemind-plugins/71363c7903321e43dec78d9e97e085020e1e40a7/",
      "files": [{ "path": "hivemind-tool.json", "sha256": "b4743098…" }],
      "homepage": "https://github.com/dip497/hivemind-plugins",
      "minAppVersion": "2026.10.3",
      "category": "git"
    }
  ]
}

The index format itself is defined by Hivemind's hub kit; this table is what HiveHub serves today. Packages, several plugins of one owner installed as one (type: "package" with members), arrive with the packages release.

• At most 500 plugins, sorted by name. A plugin taken down is left out.
• A plugin whose id no longer fits its kind's rule is left out, because Hivemind refuses an index with one id it cannot read.
• It may be cached for 5 minutes.

SearchCopy Anchor Link

GET /api/v1/plugins. What the site and hivehub search call.

curl -s 'https://hivehub.griiken.workers.dev/api/v1/plugins?q=board&type=view&sort=new'

It returns {"plugins": [...]}, each in the shape of one plugin. A plugin taken down is left out.

One pluginCopy Anchor Link

GET /api/v1/plugins/<id>. Everything a person needs to decide whether to install it.

curl -s https://hivehub.griiken.workers.dev/api/v1/plugins/dip497/worktrees

It returns every field of the index entry, and these:

InstallCopy Anchor Link

GET /api/v1/plugins/<id>/resolve. Hivemind calls it once it has downloaded and checked a plugin's files. It returns the plugin's index entry and counts one install.

curl -s https://hivehub.griiken.workers.dev/api/v1/plugins/gemini/resolve

How it counts: HiveHub makes a keyed hash of the day, the plugin and the caller's network address, and stores only the hash. The same address counts once a day for each plugin. A hash holds the day, so it cannot be matched with tomorrow's, and the hashes are deleted after two days. Nothing else is sent or kept. What Hivemind sends: What you install from HiveHub.

Its errors are those of one plugin.

PublishCopy Anchor Link

POST /api/publish. Two steps: send the request without confirm to see what would be listed, then again with "confirm": true to list it. The web form and hivehub publish both do this.

HiveHub reads about 30 files of a folder in one request. With "steps": true, a larger folder is read over several, about 30 files or 2 MB each: until it is read and checked, each answer is a reading, and you send the same request again with that reading added. The preview carries a reading too. Send it with "confirm": true to publish what you were shown, without the folder being read again; HiveHub still asks GitHub that you can push.

curl -s https://hivehub.griiken.workers.dev/api/publish \
  -H "authorization: Bearer $HIVEHUB_TOKEN" -H 'content-type: application/json' \
  -d '{"repo": "you/plugins", "path": "widgets/counter", "ref": "main"}'

Auth, one of:

Body:

Response: {"preview": {...}, "reading": "…"} without confirm, with the fields of one plugin that describe it (id, type, name, description, version, repo, ref, path, source, files, does, manifest, category and the rest). {"published": "<id>"} with it. With steps, until the folder is read: {"reading": "…", "read": 30, "of": 50}, the files read so far and how many there are.

What it checks, in order: that you can push to the repository (asked of GitHub), the folder against the limits, the manifest by Hivemind's own rules, and that the id is yours. Only with confirm does it check that nobody else has the id.

Errors:

What to do about each: If it didn't.

LimitsCopy Anchor Link

The repository must be public: HiveHub reads its files from raw.githubusercontent.com without a token.

Sign-in for the commandCopy Anchor Link

GET /api/v1/cli. What hivehub login needs to start a sign-in with GitHub.

curl -s https://hivehub.griiken.workers.dev/api/v1/cli

It returns {"clientId": "<the GitHub app's public id>", "scope": "read:user"}. If sign-in is not set up on that registry: 503, sign-in is not set up on this registry.

Renew a loginCopy Anchor Link

POST /api/cli/refresh. Renews a hivehub login token. HiveHub adds the GitHub app's secret, which the command never holds.

curl -s https://hivehub.griiken.workers.dev/api/cli/refresh \
  -H 'content-type: application/json' -d '{"refresh_token": "<refresh token>"}'

It returns GitHub's answer as GitHub sent it: access_token, refresh_token, expires_in and refresh_token_expires_in (seconds).

The command itselfCopy Anchor Link

GET /hivehub.mjs. The hivehub command, as JavaScript for Node 20 or newer: The hivehub command.

curl -fsSL https://hivehub.griiken.workers.dev/hivehub.mjs -o ~/.local/bin/hivehub && chmod +x ~/.local/bin/hivehub

Pages on the siteCopy Anchor Link

Last validated for Hivemind 2026.10.3.