mirror of
https://github.com/herdrdev/herdr.git
synced 2026-09-21 16:01:04 +00:00
docs: publish preview documentation
This commit is contained in:
kangal-bot
@@ -175,7 +175,9 @@ herdr integration install devin
|
||||
|
||||
The hook reports native session identity from Devin session, prompt, tool-use, permission, and stop events. Devin state still comes from Herdr's screen manifest and OSC detection because Devin hooks do not emit a reliable state transition after every permission cancellation or user interrupt.
|
||||
|
||||
Herdr uses `~/.config/devin` by default, or `$XDG_CONFIG_HOME/devin` when `XDG_CONFIG_HOME` is set. The Devin config directory must already exist. Install writes `herdr-agent-state.sh` (`herdr-agent-state.ps1` on Windows) and updates `config.json` with Herdr hook entries. The hook refreshes the session reference while Devin runs. Uninstall removes Herdr entries from `config.json` and deletes the hook script.
|
||||
On Linux and macOS, Herdr uses `~/.config/devin` by default, or `$XDG_CONFIG_HOME/devin` when `XDG_CONFIG_HOME` is set. The Devin config directory must already exist. Install writes `herdr-agent-state.sh` and updates `config.json` with Herdr hook entries. The hook refreshes the session reference while Devin runs. Uninstall removes Herdr entries from `config.json` and deletes the hook script.
|
||||
|
||||
Devin integration installation is not currently supported on Windows. Devin stores its Windows config under `%APPDATA%\devin`, which Herdr does not yet resolve. Native process and screen detection still work without the hook.
|
||||
|
||||
Herdr resumes stored Devin sessions with `devin --resume <id>`. Native screen manifest detection remains the state authority whether or not the hook is installed.
|
||||
|
||||
|
||||
@@ -177,7 +177,9 @@ herdr integration install devin
|
||||
|
||||
このフックは、Devin のセッション、プロンプト、ツール使用、許可、停止の各イベントからネイティブセッション識別を報告します。Devin のフックはすべての許可キャンセルやユーザー割り込みの後に信頼できる状態遷移を発行しないため、Devin の状態は引き続き Herdr のスクリーンマニフェストと OSC 検出から得られます。
|
||||
|
||||
Herdr はデフォルトで `~/.config/devin` を使い、`XDG_CONFIG_HOME` が設定されていれば `$XDG_CONFIG_HOME/devin` を使います。Devin の設定ディレクトリはあらかじめ存在している必要があります。インストールは `herdr-agent-state.sh`（Windows では `herdr-agent-state.ps1`）を書き込み、`config.json` に Herdr のフックエントリを追加します。フックは Devin の実行中にセッション参照を更新します。アンインストールは `config.json` から Herdr のエントリを削除し、フックスクリプトを削除します。
|
||||
Linux と macOS では、Herdr はデフォルトで `~/.config/devin` を使い、`XDG_CONFIG_HOME` が設定されていれば `$XDG_CONFIG_HOME/devin` を使います。Devin の設定ディレクトリはあらかじめ存在している必要があります。インストールは `herdr-agent-state.sh` を書き込み、`config.json` に Herdr のフックエントリを追加します。フックは Devin の実行中にセッション参照を更新します。アンインストールは `config.json` から Herdr のエントリを削除し、フックスクリプトを削除します。
|
||||
|
||||
Devin インテグレーションのインストールは、現在 Windows ではサポートされていません。Devin の Windows 設定は `%APPDATA%\devin` に保存されますが、Herdr はまだその場所を解決できません。フックがなくても、ネイティブプロセス検出とスクリーン検出は動作します。
|
||||
|
||||
Herdr は保存された Devin セッションを `devin --resume <id>` で resume します。フックのインストール有無にかかわらず、スクリーンマニフェスト検出が状態の権威のままです。
|
||||
|
||||
|
||||
@@ -45,7 +45,7 @@ Windows ビルドは安定版とプレビューの両方のアップデートチ
|
||||
|
||||
Windows のエージェントプロセス検出は、ペインのシェルの子孫プロセスをスキャンし、npm/Node や Git Bash のプロセスチェーンを含む直接のエージェントと一般的なコマンドラッパーを認識します。Git Bash から起動したエージェントはエミュレートされた `exec` 境界を越えて追跡されますが、Unix のフォアグラウンドプロセスグループ検出と同じものではありません。
|
||||
|
||||
Windows でインテグレーションをインストールできるのは、現在 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI、Antigravity CLI です。利用可能な対象は Unix より少なく、インストール形式が Windows で未対応のインテグレーションは表示されないか拒否されます。
|
||||
Windows でインテグレーションをインストールできるのは、現在 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI、Antigravity CLI です。利用可能な対象は Unix より少なく、インストール形式が Windows で未対応のインテグレーションは表示されないか拒否されます。Devin CLI のプロセス検出とスクリーン検出は Windows でも動作しますが、オプションのセッション識別フックは現在インストールできません。
|
||||
|
||||
プラグインは、プレビューとしてマニフェストのプラットフォームに `windows` をサポートします。GitHub インストール、ローカルリンク、ビルドコマンド、アクション、イベント、プラグインペインは Windows ではベストエフォートです。コマンドは argv 形式で Windows 互換である必要があります。`npm`、`bun`、`node` のような Node パッケージの shim は `PATH` にあれば動作するはずですが、`sh` や Bash を使う Unix 専用の例には Windows 向けの代替が必要です。プラットフォームフィルターは、未サポートのビルドコマンドをスキップし、未サポートのアクションやペインには `platform_unsupported` を返します。
|
||||
|
||||
|
||||
@@ -45,7 +45,7 @@ Local persistent sessions continue running after the client detaches or its term
|
||||
|
||||
Windows agent process detection scans descendants of the pane shell and recognizes direct agents plus common command wrappers, including npm/Node and Git Bash process chains. It follows Git Bash-launched agents across emulated `exec` boundaries, but it is not the same as Unix foreground process-group detection.
|
||||
|
||||
Windows integration installation currently supports Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, OpenCode, Kilo Code CLI, Droid, Kimi Code CLI, Qoder CLI, and Antigravity CLI. Availability is narrower than on Unix; Herdr hides or rejects integrations whose install format is not supported on Windows.
|
||||
Windows integration installation currently supports Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, OpenCode, Kilo Code CLI, Droid, Kimi Code CLI, Qoder CLI, and Antigravity CLI. Availability is narrower than on Unix; Herdr hides or rejects integrations whose install format is not supported on Windows. Devin CLI process and screen detection work on Windows, but its optional session-identity hook cannot currently be installed.
|
||||
|
||||
Plugins support `windows` as a manifest platform in preview. GitHub install, local link, build commands, actions, events, and plugin panes are best-effort on Windows. Commands are argv commands and must be Windows-compatible; Node package shims such as `npm`, `bun`, and `node` are expected to work when they are on `PATH`, while Unix-only examples using `sh` or Bash need Windows-specific alternatives. Platform filters skip unsupported build commands and return `platform_unsupported` for unsupported actions or panes.
|
||||
|
||||
|
||||
@@ -177,7 +177,9 @@ herdr integration install devin
|
||||
|
||||
该钩子从 Devin 的会话、提示、工具使用、权限和停止事件中上报原生会话身份。Devin 的状态仍来自 Herdr 的屏幕清单和 OSC 检测,因为 Devin 钩子不会在每次权限取消或用户中断后都发出可靠的状态转换。
|
||||
|
||||
Herdr 默认使用 `~/.config/devin`,设置了 `XDG_CONFIG_HOME` 时使用 `$XDG_CONFIG_HOME/devin`。Devin 配置目录必须已经存在。安装会写入 `herdr-agent-state.sh`（Windows 上为 `herdr-agent-state.ps1`）,并向 `config.json` 添加 Herdr 钩子条目。钩子在 Devin 运行期间刷新会话引用。卸载会从 `config.json` 中移除 Herdr 条目并删除钩子脚本。
|
||||
在 Linux 和 macOS 上,Herdr 默认使用 `~/.config/devin`,设置了 `XDG_CONFIG_HOME` 时使用 `$XDG_CONFIG_HOME/devin`。Devin 配置目录必须已经存在。安装会写入 `herdr-agent-state.sh`,并向 `config.json` 添加 Herdr 钩子条目。钩子在 Devin 运行期间刷新会话引用。卸载会从 `config.json` 中移除 Herdr 条目并删除钩子脚本。
|
||||
|
||||
Devin 集成目前不支持在 Windows 上安装。Devin 的 Windows 配置存放在 `%APPDATA%\devin`,Herdr 尚不能解析该位置。即使没有钩子,原生进程检测和屏幕检测仍然可用。
|
||||
|
||||
Herdr 用 `devin --resume <id>` 恢复保存的 Devin 会话。无论钩子是否安装,屏幕清单检测始终是状态权威。
|
||||
|
||||
|
||||
@@ -45,7 +45,7 @@ Windows 构建同时通过稳定版和预览版更新通道提供。新安装默
|
||||
|
||||
Windows 智能体进程检测会扫描窗格 shell 的后代进程,识别直接运行的智能体和常见的命令包装器,包括 npm/Node 和 Git Bash 进程链。它会跨越模拟的 `exec` 边界跟踪从 Git Bash 启动的智能体,但这和 Unix 前台进程组检测不是一回事。
|
||||
|
||||
Windows 目前支持安装 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI 和 Antigravity CLI 集成。可用范围比 Unix 更窄;安装格式不受 Windows 支持的集成会被隐藏或拒绝。
|
||||
Windows 目前支持安装 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI 和 Antigravity CLI 集成。可用范围比 Unix 更窄;安装格式不受 Windows 支持的集成会被隐藏或拒绝。Devin CLI 的进程检测和屏幕检测可在 Windows 上工作,但目前无法安装其可选的会话身份钩子。
|
||||
|
||||
插件以预览状态支持在清单中声明 `windows` 平台。GitHub 安装、本地链接、构建命令、动作、事件和插件窗格在 Windows 上尽力而为。命令是 argv 命令,必须兼容 Windows;`npm`、`bun`、`node` 之类的 Node 包 shim 只要在 `PATH` 上就应该能用,而使用 `sh` 或 Bash 的 Unix 专用示例需要 Windows 专用的替代方案。平台过滤器会跳过不支持的构建命令,并对不支持的动作或窗格返回 `platform_unsupported`。
|
||||
|
||||
|
||||
+45
-15
@@ -1,36 +1,66 @@
|
||||
{
|
||||
"schema_version": 1,
|
||||
"channel": "preview",
|
||||
"base_version": "0.8.0",
|
||||
"build_id": "2026-08-18-9fac51722653",
|
||||
"commit": "9fac51722653fa0b0b6a5786166fb18c763424e0",
|
||||
"built_at": "2026-08-18T19:40:21Z",
|
||||
"base_version": "0.8.2",
|
||||
"build_id": "2026-08-19-b5c4a0176e91",
|
||||
"commit": "b5c4a0176e9183924df552eb8aecb94ed5f9e732",
|
||||
"built_at": "2026-08-19T19:32:11Z",
|
||||
"protocol": 20,
|
||||
"notes": "Preview build 2026-08-18-9fac51722653\n\nBuilt from `9fac51722653` on `master`.\nBase stable: v0.8.0\nCompare: https://github.com/herdrdev/herdr/compare/1147e60bc0a43c727563bee457394af0ca0a5e8b...9fac51722653fa0b0b6a5786166fb18c763424e0\n\n### Added\n- Make Windows generally available\n- Plugin marketplace discovery shelves \u2014 trending and new arrivals\n\n### Fixed\n- Preserve macOS IME commits in report-all mode (#2947)\n- Isolate hidden pane render cadence (#2892)\n- Retry Windows installer activation after transient locks (#2921)\n- Raise timeout on docs release integration test for slow builders\n- Link agents to config reference data\n- Reap ctrl-click url openers (#2906)\n- Sync powershell process working directory (#2879)\n- Match Windows Ctrl+digit keybindings (#2913)\n\n### Maintenance\n- Publish preview documentation",
|
||||
"notes": "Preview build 2026-08-19-b5c4a0176e91\n\nBuilt from `b5c4a0176e91` on `master`.\nBase stable: v0.8.2\nCompare: https://github.com/herdrdev/herdr/compare/v0.8.2...b5c4a0176e9183924df552eb8aecb94ed5f9e732\n\n### Changed\n- Rebuilt preview from the current master branch.",
|
||||
"assets": {
|
||||
"linux-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-18-9fac51722653/herdr-linux-x86_64",
|
||||
"sha256": "92a164e247142c190f01352cd15d894633dca77e3326efd5850c33319ee2e986"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-linux-x86_64",
|
||||
"sha256": "fe5d3009003113731bfe1e7a72b356acaf2d6e35aee952aa68ecb4fd63710d8c"
|
||||
},
|
||||
"linux-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-18-9fac51722653/herdr-linux-aarch64",
|
||||
"sha256": "901a06de8ece0b4b54c1071b923f22e9e68af0b472ea0cd4403faf313b4dbe52"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-linux-aarch64",
|
||||
"sha256": "4d9175d8cd377537f5f70c96fade62b2493cce1fa097ae2edf39d5c4168d7b6e"
|
||||
},
|
||||
"macos-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-18-9fac51722653/herdr-macos-x86_64",
|
||||
"sha256": "2ecae0f0df52e5588fd0bdc78c41a2b867100592bb7a3d7bfe192957c0fc7499"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-macos-x86_64",
|
||||
"sha256": "7133b614f07b40979b1eca3a4607e9242ed6cd9ff988e0c17c7d8c8b5f5f05b3"
|
||||
},
|
||||
"macos-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-18-9fac51722653/herdr-macos-aarch64",
|
||||
"sha256": "e91ccc7004db186a64c78bfe902e1ee6fdb0a0003bf2a480f705926511006d24"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-macos-aarch64",
|
||||
"sha256": "61fe8e4e2ebe82c0267ab2ecb0c996847627be2c69c41aea12a445675c7cb097"
|
||||
},
|
||||
"windows-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-18-9fac51722653/herdr-windows-x86_64.zip",
|
||||
"sha256": "e40ed68a771e0d292c57ce2f1e8432c55ba939a566827b6b652fca5241167c88",
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-windows-x86_64.zip",
|
||||
"sha256": "01c8bc9f22be0ad447ceb8f4ed8ae18871b31694ccfd6b504b26ee31f0c6e25e",
|
||||
"format": "zip"
|
||||
}
|
||||
},
|
||||
"builds": {
|
||||
"2026-08-19-b5c4a0176e91": {
|
||||
"base_version": "0.8.2",
|
||||
"commit": "b5c4a0176e9183924df552eb8aecb94ed5f9e732",
|
||||
"built_at": "2026-08-19T19:32:11Z",
|
||||
"protocol": 20,
|
||||
"tag": "preview-2026-08-19-b5c4a0176e91",
|
||||
"assets": {
|
||||
"linux-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-linux-x86_64",
|
||||
"sha256": "fe5d3009003113731bfe1e7a72b356acaf2d6e35aee952aa68ecb4fd63710d8c"
|
||||
},
|
||||
"linux-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-linux-aarch64",
|
||||
"sha256": "4d9175d8cd377537f5f70c96fade62b2493cce1fa097ae2edf39d5c4168d7b6e"
|
||||
},
|
||||
"macos-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-macos-x86_64",
|
||||
"sha256": "7133b614f07b40979b1eca3a4607e9242ed6cd9ff988e0c17c7d8c8b5f5f05b3"
|
||||
},
|
||||
"macos-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-macos-aarch64",
|
||||
"sha256": "61fe8e4e2ebe82c0267ab2ecb0c996847627be2c69c41aea12a445675c7cb097"
|
||||
},
|
||||
"windows-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-19-b5c4a0176e91/herdr-windows-x86_64.zip",
|
||||
"sha256": "01c8bc9f22be0ad447ceb8f4ed8ae18871b31694ccfd6b504b26ee31f0c6e25e",
|
||||
"format": "zip"
|
||||
}
|
||||
}
|
||||
},
|
||||
"2026-08-18-9fac51722653": {
|
||||
"base_version": "0.8.0",
|
||||
"commit": "9fac51722653fa0b0b6a5786166fb18c763424e0",
|
||||
|
||||
Reference in New Issue
Block a user