Skip to content

docs: add Hermes Agent integration guide#449

Merged
rgarcia merged 1 commit into
mainfrom
hypeship/hermes-agent-integration
Jul 16, 2026
Merged

docs: add Hermes Agent integration guide#449
rgarcia merged 1 commit into
mainfrom
hypeship/hermes-agent-integration

Conversation

@rgarcia

@rgarcia rgarcia commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add a Hermes Agent integration guide covering plugin installation and Desktop/CLI setup
  • document profile, proxy, timeout, cleanup, verification, and update workflows
  • add the guide to Integrations navigation and the framework overview

Validation

  • python3 -m json.tool docs.json
  • started Mintlify locally and loaded /integrations/hermes-agent successfully

Note

Low Risk
Documentation-only changes with no application code, auth, or runtime behavior impact.

Overview
Adds a new Hermes Agent integration doc that explains routing Hermes browser_* tools through the Kernel browser plugin, including plugin install, Desktop/CLI configuration (KERNEL_API_KEY, optional profile/proxy), aligning browser.inactivity_timeout with the plugin’s 10-minute Kernel timeout, cleanup/standby behavior, verification steps, and plugin updates.

Wires the page into Integrations navigation in docs.json and lists it on the integrations overview alongside other framework guides.

Reviewed by Cursor Bugbot for commit b6ec6b7. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Jul 16, 2026, 8:51 PM

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

@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Kernel 🟡 Building Jul 16, 2026, 8:50 PM

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

@rgarcia
rgarcia marked this pull request as ready for review July 16, 2026 21:56

@cursor cursor 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.

Risk assessment: Very Low

The diff adds one integration guide and links it from the Mintlify navigation and integrations overview. It doesn't modify executable code, runtime configuration, prompts consumed by a model, infrastructure, authentication, permissions, or other production logic. The changed surface is limited to documentation, and the broken-link check passes. No CODEOWNERS file is present, and this PR has no existing approval, so I'm approving it.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@cursor cursor 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.

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

Fix All in Cursor

Bugbot Autofix prepared fixes for both issues found in the latest run.

  • ✅ Fixed: Logins omit Managed Auth link
    • Added Managed Auth guidance where login/session persistence is described and in Next steps alongside Profiles.
  • ✅ Fixed: Intro lists four dense features
    • Rewrote the intro as a short lead-in sentence followed by bullets for Hermes capabilities to improve scannability.

Create PR

Or push these changes by commenting:

@cursor push 70cf6b3716
Preview (70cf6b3716)
diff --git a/integrations/hermes-agent.mdx b/integrations/hermes-agent.mdx
--- a/integrations/hermes-agent.mdx
+++ b/integrations/hermes-agent.mdx
@@ -3,8 +3,15 @@
 description: "Run Hermes Agent browser tools on Kernel cloud browsers"
 ---
 
-[Hermes Agent](https://github.com/NousResearch/hermes-agent) is an AI agent with browser automation, terminal access, skills, and messaging integrations. The [Kernel browser plugin](https://github.com/kernel/hermes-browser-plugin) routes Hermes's `browser_*` tools through Kernel cloud browsers and handles browser creation and cleanup for you.
+[Hermes Agent](https://github.com/NousResearch/hermes-agent) is an AI agent with several built-in capabilities:
 
+- Browser automation
+- Terminal access
+- Skills
+- Messaging integrations
+
+The [Kernel browser plugin](https://github.com/kernel/hermes-browser-plugin) routes Hermes's `browser_*` tools through Kernel cloud browsers and handles browser creation and cleanup for you.
+
 ## Install the plugin
 
 Install and enable the plugin from the Kernel repository:
@@ -77,7 +84,7 @@
 | `KERNEL_PROFILE_NAME` | No | Loads an existing Kernel profile by name |
 | `KERNEL_PROXY_NAME` | No | Resolves and attaches an existing Kernel proxy by name |
 
-When you set `KERNEL_PROFILE_NAME`, the plugin saves browser changes back to that profile when the browser ends. This preserves cookies, logins, and other session state for future runs.
+When you set `KERNEL_PROFILE_NAME`, the plugin saves browser changes back to that profile when the browser ends. This preserves cookies, logins, and other session state for future runs. For authenticated browsing patterns, see [Managed Auth](/auth/managed-auth).
 
 ## Understand browser cleanup
 
@@ -122,6 +129,7 @@
 ## Next steps
 
 - Use [Live View](/browsers/live-view) to inspect an active Hermes browser
+- Set up authenticated browsing with [Managed Auth](/auth/managed-auth)
 - Create reusable browser state with [Profiles](/auth/profiles)
 - Configure a named [Proxy](/proxies/overview)
 - Learn how Kernel [terminates browser sessions](/browsers/termination)

You can send follow-ups to the cloud agent here.

Reviewed by Cursor Bugbot for commit b6ec6b7. Configure here.

| `KERNEL_PROFILE_NAME` | No | Loads an existing Kernel profile by name |
| `KERNEL_PROXY_NAME` | No | Resolves and attaches an existing Kernel proxy by name |

When you set `KERNEL_PROFILE_NAME`, the plugin saves browser changes back to that profile when the browser ends. This preserves cookies, logins, and other session state for future runs.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Logins omit Managed Auth link

Low Severity

The guide describes preserving cookies, logins, and session state and points readers only to Profiles. Integration docs that discuss authenticated browsing or login persistence are expected to highlight Managed Auth, not rely on Profiles alone as the auth story.

Additional Locations (1)
Fix in Cursor Fix in Web

Triggered by learned rule: Integration pages should highlight Managed Auth for authenticated browsing

Reviewed by Cursor Bugbot for commit b6ec6b7. Configure here.

description: "Run Hermes Agent browser tools on Kernel cloud browsers"
---

[Hermes Agent](https://github.com/NousResearch/hermes-agent) is an AI agent with browser automation, terminal access, skills, and messaging integrations. The [Kernel browser plugin](https://github.com/kernel/hermes-browser-plugin) routes Hermes's `browser_*` tools through Kernel cloud browsers and handles browser creation and cleanup for you.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Intro lists four dense features

Low Severity

The opening sentence packs browser automation, terminal access, skills, and messaging into one dense clause. Guide pages are expected to use a bullet list when three or more distinct capabilities appear as continuous prose for scannability.

Fix in Cursor Fix in Web

Triggered by learned rule: Use bullet lists when covering multiple distinct points in guides

Reviewed by Cursor Bugbot for commit b6ec6b7. Configure here.

@rgarcia
rgarcia requested a review from dprevoznik July 16, 2026 22:04

@dprevoznik dprevoznik left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM!

@rgarcia
rgarcia merged commit 5e3f62b into main Jul 16, 2026
5 checks passed
@rgarcia
rgarcia deleted the hypeship/hermes-agent-integration branch July 16, 2026 22:41
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.

2 participants