Skip to content

feat: support all agent integrations on windows - #2496

Merged
ogulcancelik merged 1 commit into
masterfrom
feature/windows-integrations
Aug 7, 2026
Merged

feat: support all agent integrations on windows#2496
ogulcancelik merged 1 commit into
masterfrom
feature/windows-integrations

Conversation

@ogulcancelik

Copy link
Copy Markdown
Collaborator

Summary

  • add native Windows integration assets for Cursor, Devin, Grok, and MastraCode
  • enable Windows installation and detection for Cursor, Devin, Grok, MastraCode, and Hermes
  • use Cursor’s unambiguous cursor-agent.cmd launcher and make Hermes session reporting cross-platform
  • document Windows integration paths and scripts

Validation

  • just check
  • native Windows build and targeted integration tests
  • live Windows smoke tests for Cursor, Grok, MastraCode, and Hermes

Devin was installed on the Windows VM, but its authenticated agent smoke test requires a Devin login.

@kangal-bot kangal-bot added the ai-review Trigger automated AI reviews for pull requests admitted by the PR gate label Aug 7, 2026
@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: b2e101d8-c6ae-418b-82ac-0a65727fc163

📥 Commits

Reviewing files that changed from the base of the PR and between 29eeeff and 0fce2c8.

📒 Files selected for processing (5)
  • docs/next/website/src/content/docs/integrations.mdx
  • docs/next/website/src/content/docs/ja/integrations.mdx
  • docs/next/website/src/content/docs/zh-cn/integrations.mdx
  • src/integration/assets/hermes/__init__.py
  • src/integration/mod.rs
🚧 Files skipped from review as they are similar to previous changes (4)
  • docs/next/website/src/content/docs/ja/integrations.mdx
  • src/integration/mod.rs
  • docs/next/website/src/content/docs/zh-cn/integrations.mdx
  • docs/next/website/src/content/docs/integrations.mdx

📝 Walkthrough

Walkthrough

Native Windows support was added for Devin, Hermes, Cursor, MastraCode, and Grok. The changes add PowerShell hooks, platform-specific commands and executables, Hermes path resolution, subprocess reporting, detection updates, tests, and documentation.

Changes

Native Windows integrations

Layer / File(s) Summary
Platform-specific agent detection and resume
src/agent_resume.rs, src/detect/mod.rs
Cursor uses cursor-agent.cmd on Windows. MastraCode detection recognizes its Node package CLI path.
Hermes subprocess reporting and path resolution
src/integration/assets/hermes/__init__.py, src/integration/env.rs, src/integration/registry.rs, scripts/test_hermes_integration_asset.py
Hermes reports sessions through the Herdr CLI, supports HERMES_HOME, resolves Windows defaults, and suppresses subprocess windows.
PowerShell hooks and installation wiring
src/integration/assets/*/herdr-agent-state.ps1, src/integration/mod.rs, src/integration/registry.rs
Devin, Cursor, MastraCode, and Grok use Windows PowerShell assets and retain shell assets on other platforms.
Platform-aware hook commands and validation
src/integration/targets.rs, src/integration/tests.rs
Hook installation and removal use platform-aware commands. MastraCode uses encoded PowerShell commands on Windows. Tests validate Windows support and generated commands.
Integration documentation
docs/next/CHANGELOG.md, docs/next/website/src/content/docs/integrations.mdx, docs/next/website/src/content/docs/ja/integrations.mdx, docs/next/website/src/content/docs/zh-cn/integrations.mdx
Documentation describes Windows hook filenames and Hermes path defaults in three languages.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant AgentCLI
  participant PowerShellHook
  participant HerdrCLI
  participant PaneState
  AgentCLI->>PowerShellHook: send session event JSON
  PowerShellHook->>HerdrCLI: report-agent-session with session metadata
  HerdrCLI->>PaneState: update active pane session
  PowerShellHook-->>AgentCLI: emit empty JSON response
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: native support for all agent integrations on Windows.
Description check ✅ Passed The description directly covers the Windows integration assets, detection, cross-platform behavior, documentation, and validation.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/windows-integrations

Comment @coderabbitai help to get the list of available commands.

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

Actionable comments posted: 2


ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1698632b-c7e9-4519-a4d5-f8849f5b88e9

📥 Commits

Reviewing files that changed from the base of the PR and between 7d77e92 and 4e54e2f.

📒 Files selected for processing (17)
  • docs/next/CHANGELOG.md
  • docs/next/website/src/content/docs/integrations.mdx
  • docs/next/website/src/content/docs/ja/integrations.mdx
  • docs/next/website/src/content/docs/zh-cn/integrations.mdx
  • scripts/test_hermes_integration_asset.py
  • src/agent_resume.rs
  • src/detect/mod.rs
  • src/integration/assets/cursor/herdr-agent-state.ps1
  • src/integration/assets/devin/herdr-agent-state.ps1
  • src/integration/assets/grok/herdr-agent-state.ps1
  • src/integration/assets/hermes/__init__.py
  • src/integration/assets/mastracode/herdr-agent-state.ps1
  • src/integration/env.rs
  • src/integration/mod.rs
  • src/integration/registry.rs
  • src/integration/targets.rs
  • src/integration/tests.rs

Comment thread docs/next/website/src/content/docs/integrations.mdx Outdated
Comment thread src/integration/tests.rs
@ogulcancelik
ogulcancelik force-pushed the feature/windows-integrations branch from 4e54e2f to 29eeeff Compare August 7, 2026 19:42
@greptile-apps

greptile-apps Bot commented Aug 7, 2026

Copy link
Copy Markdown

Greptile Summary

The PR adds native Windows support for Cursor, Devin, Grok, MastraCode, and Hermes integrations.

  • Adds PowerShell hook assets and platform-specific installation commands.
  • Enables Windows integration detection, installation, status checks, and agent restoration.
  • Replaces Hermes socket reporting with a cross-platform Herdr CLI invocation.
  • Bumps the Hermes integration version to ensure existing installations are detected as outdated and reinstalled.

Confidence Score: 5/5

The PR appears safe to merge.

The previously reported Hermes upgrade issue is fixed because both the installed asset marker and the integration registry constant are now version 5, so existing version 4 installations are classified as outdated; no blocking failure remains.

Important Files Changed

Filename Overview
src/integration/assets/hermes/init.py Replaces Unix-socket session reporting with a cross-platform argv-based Herdr CLI invocation and correctly advances the asset marker to version 5.
src/integration/mod.rs Selects platform-specific integration assets and advances the Hermes registry version to 5, matching the installed asset.
src/integration/targets.rs Generates platform-appropriate hook commands for Cursor, MastraCode, and Grok.
src/integration/env.rs Injects the current Herdr executable path into panes and resolves the platform-specific Hermes home directory.
src/integration/registry.rs Enables the new Windows integration targets and aligns Hermes availability detection with its resolved home directory.
src/integration/tests.rs Updates integration coverage for Windows support, command generation, installation, and availability.
src/agent_resume.rs Uses Cursor's unambiguous Windows command launcher when restoring sessions.
src/detect/mod.rs Uses the Windows Cursor launcher and recognizes node-wrapped MastraCode processes.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Pane[Herdr-managed pane] --> Env[Injected pane environment]
  Env --> Agent[Agent CLI]
  Agent --> Hook[Installed PowerShell or Python hook]
  Hook --> CLI[Herdr reporting CLI]
  CLI --> Server[Herdr server]
  Server --> State[Pane agent session/state]
Loading

Reviews (2): Last reviewed commit: "feat: support all agent integrations on ..." | Re-trigger Greptile

Comment thread src/integration/assets/hermes/__init__.py
@ogulcancelik
ogulcancelik force-pushed the feature/windows-integrations branch from 29eeeff to 0fce2c8 Compare August 7, 2026 19:51
@ogulcancelik
ogulcancelik merged commit 50ddc06 into master Aug 7, 2026
8 checks passed
@kangal-bot kangal-bot removed the ai-review Trigger automated AI reviews for pull requests admitted by the PR gate label Aug 7, 2026
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