Skip to content

docs(plugins): consolidate plugins into five pages - #312

Merged
arrry-hydraDB merged 10 commits into
mainfrom
docs/consolidate-plugins
Oct 8, 2026
Merged

arrry-hydraDB merged 10 commits into
mainfrom
docs/consolidate-plugins

Conversation

@arrry-hydraDB

Copy link
Copy Markdown
Contributor

What

Restructures the Plugins nav so newly rolled-out integrations are housed on shared pages instead of one page per plugin.

Final Plugins group (both v2 and v1):

Page Change
Claude Code / Codex (plugins/claude-code) Renamed from "Claude Code"; added a Codex section (same shared engine, identical config/modes/commands, Codex-specific install)
MCP (plugins/mcp) Title renamed from "HydraDB MCP" → "MCP"
CLI (plugins/cli) Title renamed from "HydraDB CLI" → "CLI"
Hermes (plugins/hermes) New — Hermes Agent memory provider
Ecosystem (plugins/ecosystem) New single page: OpenClaw, Cursor, Muse Code, Grok Build, OpenCode (coding agents/editors) + CrewAI, LangChain (framework integrations)

The standalone OpenClaw page is removed and folded into Ecosystem; /plugins/openclaw now 301-redirects to /plugins/ecosystem.

Notes

  • Content for the new pages was written against each plugin repo's README in hydra-db/*.
  • npx mint broken-links passes for all plugin pages (the 3 reported links are pre-existing in API_SHAPE_AUDIT.md, unrelated to this change).

🤖 Generated with Claude Code

@mintlify

mintlify Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
cortex-ai 🟢 Ready View Preview Oct 8, 2026, 8:45 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@github-actions

github-actions Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

✅ Mintlify Hygiene

No issues found.

@openhack-agent

openhack-agent Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

✅ OpenHack Summary

Security review of docs(plugins): consolidate plugins into five pages. 14 changed files; 0 findings at or above the low reporting threshold.

P1: Critical 0   P2: High 0   P3: Medium 0   P4: Low 0

Confidence Score: 5/5

No reportable security findings were detected in this scan.

Security merge-readiness rubric: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = no reportable findings. This score reflects scan findings, not a guarantee of correctness or complete coverage.

Files Needing Attention: None

Important Files Changed
  • docs.json (modified)
  • images/plugins/crewai.svg (added)
  • images/plugins/cursor.svg (added)
  • images/plugins/grok.svg (added)
  • images/plugins/langchain.svg (added)
  • images/plugins/meta.svg (added)
  • images/plugins/openclaw.svg (added)
  • images/plugins/opencode.svg (added)
  • plugins/claude-code.mdx (modified)
  • plugins/cli.mdx (modified)
  • plugins/ecosystem.mdx (added)
  • plugins/hermes.mdx (added)
  • plugins/mcp.mdx (modified)
  • plugins/openclaw.mdx (removed)

Last reviewed commit: f08364a · View review on OpenHack


TIP: Mention @openhack-agent in a PR comment to request a review or ask a question. Use @openhack-agent fix all for every finding, or @openhack-agent fix unresolved threads for open review threads only.

@openhack-agent openhack-agent Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OpenHack reviewed this commit. See the OpenHack Summary for the confidence score and fix actions.

@greptile-apps

greptile-apps Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 5/5

[Low impact] The PR appears safe to merge, with two previously reported, non-blocking documentation and icon issues still outstanding.

Findings

  1. P2 OpenClaw configuration guidance lost ▶
  2. P2 Icons disappear in mismatched themes ▶

Summary

The PR consolidates plugin documentation into five pages, adds Hermes and Ecosystem guidance, and redirects the former OpenClaw page.

  • The change since the previous review corrects the Hermes drop-in installation command by creating the destination directory and copying the provider’s contents into it.
  • Greptile automatically discovered a related ticket that helped explain the purpose of this PR: consolidate plugin documentation into five pages rather than adding a page for each integration.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  P[Plugins navigation] --> C[Claude Code / Codex]
  P --> M[MCP]
  P --> L[CLI]
  P --> H[Hermes]
  P --> E[Ecosystem]
  O["/plugins/openclaw"] -->|permanent redirect| E
Loading

Reviews (11) · Last reviewed commit: "docs(hermes): make drop-in copy robust (..." · Reviewed by Greptile

Comment thread plugins/ecosystem.mdx
Comment thread plugins/ecosystem.mdx Outdated
Comment thread plugins/claude-code.mdx Outdated
Comment thread plugins/claude-code.mdx
Comment thread plugins/ecosystem.mdx Outdated
Comment thread plugins/hermes.mdx Outdated
Comment thread plugins/hermes.mdx Outdated
Comment thread images/plugins/cursor.svg
jaywyawhare and others added 8 commits October 9, 2026 00:56
Restructure the Plugins nav so new integrations live on shared pages instead
of one page per plugin:

- Claude Code -> "Claude Code / Codex": add a Codex section (same engine/config)
- "HydraDB MCP" -> "MCP" (title only)
- "HydraDB CLI" -> "CLI" (title only)
- Hermes: new page for the Hermes Agent memory provider
- Ecosystem: new single page for OpenClaw, Cursor, Muse Code, Grok Build,
  OpenCode, plus the CrewAI and LangChain framework integrations
- Remove the standalone OpenClaw page; redirect /plugins/openclaw -> /plugins/ecosystem

Nav updated in both v2 and v1 versions.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
- Codex: clarify API-key env var differs (HYDRADB_API_KEY vs HYDRA_DB_API_KEY),
  add HYDRADB_SUB_TENANT_ID, and add the git clone step before make bootstrap
- Cursor: add the git clone/cd step before make bootstrap
- Muse Code: add the required X-HydraDB-Database header to the MCP snippet and
  a caution that --yolo should only be used in trusted workspaces
- Hermes: show the git clone + cp command and source for the drop-in install
- OpenClaw: add a manual (no-wizard) config pointer with env vars and keys

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
Replace the generic arrow-down icon on the Coding agents & editors and
Framework integrations cards with each tool's brand logo, committed locally
under images/plugins/. The monochrome marks (Cursor, Grok, OpenCode) embed a
prefers-color-scheme style so they stay visible in both dark and light themes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
…add Hermes catalog install

Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
… PyPI

Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
…n published)

Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
…owner/repo git install)

Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
… provider dir)

Signed-off-by: arrry-hydraDB <278531244+arrry-hydraDB@users.noreply.github.com>
@arrry-hydraDB
arrry-hydraDB merged commit 307c240 into main Oct 8, 2026
8 checks passed
@arrry-hydraDB
arrry-hydraDB deleted the docs/consolidate-plugins branch October 8, 2026 20:52
SohamRatnaparkhi added a commit that referenced this pull request Oct 9, 2026
Main consolidated the plugin pages (#312). Resolved by taking main's
plugin pages and keeping this branch's verified fixes: Claude Code reads
HYDRADB_API_KEY (HYDRA_DB_API_KEY is a deprecated alias, per the plugin's
config.mjs and README), so the Codex section no longer says the two
plugins use different key names. The OpenClaw page moved to Ecosystem;
the Introduction links there.

Refs PRO-2457

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: SohamRatnaparkhi <soham@hydradb.com>
SohamRatnaparkhi added a commit that referenced this pull request Oct 9, 2026
Main consolidated the plugin pages (#312). Resolved by taking main's
plugin pages and keeping this branch's verified fixes: Claude Code reads
HYDRADB_API_KEY (HYDRA_DB_API_KEY is a deprecated alias, per the plugin's
config.mjs and README), so the Codex section no longer says the two
plugins use different key names. The OpenClaw page moved to Ecosystem;
the Introduction links there.

Refs PRO-2457

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: SohamRatnaparkhi <soham@hydradb.com>

This branch was successfully deployed

1 active deployment
staging — f08364a6 Deployed Oct 8, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants