From d4e335e7b46f7a5c93e7ac05075412fe19d1b382 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Wed, 30 Sep 2026 19:10:00 +0300 Subject: [PATCH] docs: drop external example link from agent support guide --- docs/next/website/src/content/docs/add-herdr-support.mdx | 8 ++------ .../website/src/content/docs/ja/add-herdr-support.mdx | 8 ++------ .../website/src/content/docs/zh-cn/add-herdr-support.mdx | 8 ++------ .../0.9.2/website/src/content/docs/add-herdr-support.mdx | 8 ++------ .../website/src/content/docs/ja/add-herdr-support.mdx | 8 ++------ .../website/src/content/docs/zh-cn/add-herdr-support.mdx | 8 ++------ .../0.9.3/website/src/content/docs/add-herdr-support.mdx | 8 ++------ .../website/src/content/docs/ja/add-herdr-support.mdx | 8 ++------ .../website/src/content/docs/zh-cn/add-herdr-support.mdx | 8 ++------ 9 files changed, 18 insertions(+), 54 deletions(-) diff --git a/docs/next/website/src/content/docs/add-herdr-support.mdx b/docs/next/website/src/content/docs/add-herdr-support.mdx index def9ce76..dd5589ed 100644 --- a/docs/next/website/src/content/docs/add-herdr-support.mdx +++ b/docs/next/website/src/content/docs/add-herdr-support.mdx @@ -48,6 +48,8 @@ Only report when `HERDR_ENV=1` and the other variables are set. Outside Herdr, y - `--source` identifies your integration. Keep it stable and unique. Don't start it with `herdr:`, because Herdr's own integrations use that prefix. - `--seq` is optional but recommended. It must increase with every report from your source, including across sessions and restarts of your agent. A timestamp works well. Herdr ignores reports whose number is not higher than the last one it accepted, so late or out-of-order reports can't overwrite newer state. +To change how your agent appears without changing its state, such as a title or custom status text, see [Custom status labels](/docs/integrations/#custom-status-labels). + ## Report the resume command Put the command that resumes the current session after `--`. Include the options that session needs, such as the model or permission mode, so the resumed session behaves the same: @@ -110,9 +112,3 @@ To test restore without touching your normal session, use a separate named sessi 1. Start `herdr --session my-agent-test`, then run your agent in a pane. 2. Stop that session with `herdr session stop my-agent-test`. 3. Start `herdr --session my-agent-test` again. The pane should run your resume command and your agent should report again. - -## Example - -[Prime Agent's built-in Herdr reporter](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts) is a real-world integration. It activates only inside Herdr, maps agent events to `working`, `idle`, and `blocked`, keeps its report order across sessions, and releases the pane on exit. - -To change how your agent appears without changing its state, such as a title or custom status text, see [Custom status labels](/docs/integrations/#custom-status-labels). diff --git a/docs/next/website/src/content/docs/ja/add-herdr-support.mdx b/docs/next/website/src/content/docs/ja/add-herdr-support.mdx index 3083ff19..38cc8334 100644 --- a/docs/next/website/src/content/docs/ja/add-herdr-support.mdx +++ b/docs/next/website/src/content/docs/ja/add-herdr-support.mdx @@ -48,6 +48,8 @@ Herdr ペイン内のすべてのプロセスは、次の環境変数を継承 - `--source` はインテグレーションを識別します。固定かつ一意にしてください。`herdr:` で始めないでください。この接頭辞は Herdr 自身のインテグレーションが使います。 - `--seq` は省略できますが、付けることを推奨します。source からの報告ごとに増加する必要があり、エージェントのセッションや再起動をまたいでも増加し続ける必要があります。タイムスタンプが適しています。Herdr は最後に受け付けた番号より大きくない報告を無視するので、遅れて届いた報告や順不同の報告が新しい状態を上書きすることはありません。 +タイトルやカスタムのステータス文言など、状態を変えずにエージェントの見た目を変えるには、[カスタムステータスラベル](/ja/docs/integrations/#カスタムステータスラベル)を参照してください。 + ## resume コマンドを報告する 現在のセッションを再開するコマンドを `--` の後に置きます。モデルや権限モードなど、そのセッションに必要なオプションも含めると、再開したセッションが同じように動きます: @@ -110,9 +112,3 @@ herdr agent list 1. `herdr --session my-agent-test` を起動し、ペインでエージェントを実行します。 2. `herdr session stop my-agent-test` でそのセッションを停止します。 3. `herdr --session my-agent-test` をもう一度起動します。ペインで resume コマンドが実行され、エージェントが再び報告するはずです。 - -## 例 - -[Prime Agent の組み込み Herdr レポーター](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts)は実際のインテグレーションです。Herdr 内でのみ有効になり、エージェントイベントを `working`、`idle`、`blocked` に対応付け、セッションをまたいで報告順序を維持し、終了時にペインを解放します。 - -タイトルやカスタムのステータス文言など、状態を変えずにエージェントの見た目を変えるには、[カスタムステータスラベル](/ja/docs/integrations/#カスタムステータスラベル)を参照してください。 diff --git a/docs/next/website/src/content/docs/zh-cn/add-herdr-support.mdx b/docs/next/website/src/content/docs/zh-cn/add-herdr-support.mdx index c6fda913..c0beec1a 100644 --- a/docs/next/website/src/content/docs/zh-cn/add-herdr-support.mdx +++ b/docs/next/website/src/content/docs/zh-cn/add-herdr-support.mdx @@ -48,6 +48,8 @@ Herdr 窗格中的每个进程都会继承这些环境变量: - `--source` 用于标识你的集成。保持稳定且唯一。不要以 `herdr:` 开头,这个前缀由 Herdr 自己的集成使用。 - `--seq` 可以省略,但建议加上。它必须随来自你的来源的每次上报递增,跨会话和智能体重启也要继续递增。时间戳就很合适。Herdr 会忽略编号不大于上次已接受编号的上报,所以迟到或乱序的上报不会覆盖更新的状态。 +如果想在不改变状态的情况下改变智能体的显示方式,例如标题或自定义状态文字,请参阅[自定义状态标签](/zh-cn/docs/integrations/#自定义状态标签)。 + ## 上报恢复命令 把恢复当前会话的命令放在 `--` 之后。带上该会话需要的选项,例如模型或权限模式,这样恢复后的会话行为一致: @@ -110,9 +112,3 @@ herdr agent list 1. 启动 `herdr --session my-agent-test`,然后在一个窗格中运行你的智能体。 2. 用 `herdr session stop my-agent-test` 停止该会话。 3. 再次启动 `herdr --session my-agent-test`。窗格应当运行你的恢复命令,智能体应当再次上报。 - -## 示例 - -[Prime Agent 内置的 Herdr 上报器](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts)是一个真实的集成。它只在 Herdr 中启用,将智能体事件映射为 `working`、`idle` 和 `blocked`,跨会话保持上报顺序,并在退出时释放窗格。 - -如果想在不改变状态的情况下改变智能体的显示方式,例如标题或自定义状态文字,请参阅[自定义状态标签](/zh-cn/docs/integrations/#自定义状态标签)。 diff --git a/docs/versions/0.9.2/website/src/content/docs/add-herdr-support.mdx b/docs/versions/0.9.2/website/src/content/docs/add-herdr-support.mdx index def9ce76..dd5589ed 100644 --- a/docs/versions/0.9.2/website/src/content/docs/add-herdr-support.mdx +++ b/docs/versions/0.9.2/website/src/content/docs/add-herdr-support.mdx @@ -48,6 +48,8 @@ Only report when `HERDR_ENV=1` and the other variables are set. Outside Herdr, y - `--source` identifies your integration. Keep it stable and unique. Don't start it with `herdr:`, because Herdr's own integrations use that prefix. - `--seq` is optional but recommended. It must increase with every report from your source, including across sessions and restarts of your agent. A timestamp works well. Herdr ignores reports whose number is not higher than the last one it accepted, so late or out-of-order reports can't overwrite newer state. +To change how your agent appears without changing its state, such as a title or custom status text, see [Custom status labels](/docs/integrations/#custom-status-labels). + ## Report the resume command Put the command that resumes the current session after `--`. Include the options that session needs, such as the model or permission mode, so the resumed session behaves the same: @@ -110,9 +112,3 @@ To test restore without touching your normal session, use a separate named sessi 1. Start `herdr --session my-agent-test`, then run your agent in a pane. 2. Stop that session with `herdr session stop my-agent-test`. 3. Start `herdr --session my-agent-test` again. The pane should run your resume command and your agent should report again. - -## Example - -[Prime Agent's built-in Herdr reporter](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts) is a real-world integration. It activates only inside Herdr, maps agent events to `working`, `idle`, and `blocked`, keeps its report order across sessions, and releases the pane on exit. - -To change how your agent appears without changing its state, such as a title or custom status text, see [Custom status labels](/docs/integrations/#custom-status-labels). diff --git a/docs/versions/0.9.2/website/src/content/docs/ja/add-herdr-support.mdx b/docs/versions/0.9.2/website/src/content/docs/ja/add-herdr-support.mdx index 3083ff19..38cc8334 100644 --- a/docs/versions/0.9.2/website/src/content/docs/ja/add-herdr-support.mdx +++ b/docs/versions/0.9.2/website/src/content/docs/ja/add-herdr-support.mdx @@ -48,6 +48,8 @@ Herdr ペイン内のすべてのプロセスは、次の環境変数を継承 - `--source` はインテグレーションを識別します。固定かつ一意にしてください。`herdr:` で始めないでください。この接頭辞は Herdr 自身のインテグレーションが使います。 - `--seq` は省略できますが、付けることを推奨します。source からの報告ごとに増加する必要があり、エージェントのセッションや再起動をまたいでも増加し続ける必要があります。タイムスタンプが適しています。Herdr は最後に受け付けた番号より大きくない報告を無視するので、遅れて届いた報告や順不同の報告が新しい状態を上書きすることはありません。 +タイトルやカスタムのステータス文言など、状態を変えずにエージェントの見た目を変えるには、[カスタムステータスラベル](/ja/docs/integrations/#カスタムステータスラベル)を参照してください。 + ## resume コマンドを報告する 現在のセッションを再開するコマンドを `--` の後に置きます。モデルや権限モードなど、そのセッションに必要なオプションも含めると、再開したセッションが同じように動きます: @@ -110,9 +112,3 @@ herdr agent list 1. `herdr --session my-agent-test` を起動し、ペインでエージェントを実行します。 2. `herdr session stop my-agent-test` でそのセッションを停止します。 3. `herdr --session my-agent-test` をもう一度起動します。ペインで resume コマンドが実行され、エージェントが再び報告するはずです。 - -## 例 - -[Prime Agent の組み込み Herdr レポーター](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts)は実際のインテグレーションです。Herdr 内でのみ有効になり、エージェントイベントを `working`、`idle`、`blocked` に対応付け、セッションをまたいで報告順序を維持し、終了時にペインを解放します。 - -タイトルやカスタムのステータス文言など、状態を変えずにエージェントの見た目を変えるには、[カスタムステータスラベル](/ja/docs/integrations/#カスタムステータスラベル)を参照してください。 diff --git a/docs/versions/0.9.2/website/src/content/docs/zh-cn/add-herdr-support.mdx b/docs/versions/0.9.2/website/src/content/docs/zh-cn/add-herdr-support.mdx index c6fda913..c0beec1a 100644 --- a/docs/versions/0.9.2/website/src/content/docs/zh-cn/add-herdr-support.mdx +++ b/docs/versions/0.9.2/website/src/content/docs/zh-cn/add-herdr-support.mdx @@ -48,6 +48,8 @@ Herdr 窗格中的每个进程都会继承这些环境变量: - `--source` 用于标识你的集成。保持稳定且唯一。不要以 `herdr:` 开头,这个前缀由 Herdr 自己的集成使用。 - `--seq` 可以省略,但建议加上。它必须随来自你的来源的每次上报递增,跨会话和智能体重启也要继续递增。时间戳就很合适。Herdr 会忽略编号不大于上次已接受编号的上报,所以迟到或乱序的上报不会覆盖更新的状态。 +如果想在不改变状态的情况下改变智能体的显示方式,例如标题或自定义状态文字,请参阅[自定义状态标签](/zh-cn/docs/integrations/#自定义状态标签)。 + ## 上报恢复命令 把恢复当前会话的命令放在 `--` 之后。带上该会话需要的选项,例如模型或权限模式,这样恢复后的会话行为一致: @@ -110,9 +112,3 @@ herdr agent list 1. 启动 `herdr --session my-agent-test`,然后在一个窗格中运行你的智能体。 2. 用 `herdr session stop my-agent-test` 停止该会话。 3. 再次启动 `herdr --session my-agent-test`。窗格应当运行你的恢复命令,智能体应当再次上报。 - -## 示例 - -[Prime Agent 内置的 Herdr 上报器](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts)是一个真实的集成。它只在 Herdr 中启用,将智能体事件映射为 `working`、`idle` 和 `blocked`,跨会话保持上报顺序,并在退出时释放窗格。 - -如果想在不改变状态的情况下改变智能体的显示方式,例如标题或自定义状态文字,请参阅[自定义状态标签](/zh-cn/docs/integrations/#自定义状态标签)。 diff --git a/docs/versions/0.9.3/website/src/content/docs/add-herdr-support.mdx b/docs/versions/0.9.3/website/src/content/docs/add-herdr-support.mdx index def9ce76..dd5589ed 100644 --- a/docs/versions/0.9.3/website/src/content/docs/add-herdr-support.mdx +++ b/docs/versions/0.9.3/website/src/content/docs/add-herdr-support.mdx @@ -48,6 +48,8 @@ Only report when `HERDR_ENV=1` and the other variables are set. Outside Herdr, y - `--source` identifies your integration. Keep it stable and unique. Don't start it with `herdr:`, because Herdr's own integrations use that prefix. - `--seq` is optional but recommended. It must increase with every report from your source, including across sessions and restarts of your agent. A timestamp works well. Herdr ignores reports whose number is not higher than the last one it accepted, so late or out-of-order reports can't overwrite newer state. +To change how your agent appears without changing its state, such as a title or custom status text, see [Custom status labels](/docs/integrations/#custom-status-labels). + ## Report the resume command Put the command that resumes the current session after `--`. Include the options that session needs, such as the model or permission mode, so the resumed session behaves the same: @@ -110,9 +112,3 @@ To test restore without touching your normal session, use a separate named sessi 1. Start `herdr --session my-agent-test`, then run your agent in a pane. 2. Stop that session with `herdr session stop my-agent-test`. 3. Start `herdr --session my-agent-test` again. The pane should run your resume command and your agent should report again. - -## Example - -[Prime Agent's built-in Herdr reporter](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts) is a real-world integration. It activates only inside Herdr, maps agent events to `working`, `idle`, and `blocked`, keeps its report order across sessions, and releases the pane on exit. - -To change how your agent appears without changing its state, such as a title or custom status text, see [Custom status labels](/docs/integrations/#custom-status-labels). diff --git a/docs/versions/0.9.3/website/src/content/docs/ja/add-herdr-support.mdx b/docs/versions/0.9.3/website/src/content/docs/ja/add-herdr-support.mdx index 3083ff19..38cc8334 100644 --- a/docs/versions/0.9.3/website/src/content/docs/ja/add-herdr-support.mdx +++ b/docs/versions/0.9.3/website/src/content/docs/ja/add-herdr-support.mdx @@ -48,6 +48,8 @@ Herdr ペイン内のすべてのプロセスは、次の環境変数を継承 - `--source` はインテグレーションを識別します。固定かつ一意にしてください。`herdr:` で始めないでください。この接頭辞は Herdr 自身のインテグレーションが使います。 - `--seq` は省略できますが、付けることを推奨します。source からの報告ごとに増加する必要があり、エージェントのセッションや再起動をまたいでも増加し続ける必要があります。タイムスタンプが適しています。Herdr は最後に受け付けた番号より大きくない報告を無視するので、遅れて届いた報告や順不同の報告が新しい状態を上書きすることはありません。 +タイトルやカスタムのステータス文言など、状態を変えずにエージェントの見た目を変えるには、[カスタムステータスラベル](/ja/docs/integrations/#カスタムステータスラベル)を参照してください。 + ## resume コマンドを報告する 現在のセッションを再開するコマンドを `--` の後に置きます。モデルや権限モードなど、そのセッションに必要なオプションも含めると、再開したセッションが同じように動きます: @@ -110,9 +112,3 @@ herdr agent list 1. `herdr --session my-agent-test` を起動し、ペインでエージェントを実行します。 2. `herdr session stop my-agent-test` でそのセッションを停止します。 3. `herdr --session my-agent-test` をもう一度起動します。ペインで resume コマンドが実行され、エージェントが再び報告するはずです。 - -## 例 - -[Prime Agent の組み込み Herdr レポーター](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts)は実際のインテグレーションです。Herdr 内でのみ有効になり、エージェントイベントを `working`、`idle`、`blocked` に対応付け、セッションをまたいで報告順序を維持し、終了時にペインを解放します。 - -タイトルやカスタムのステータス文言など、状態を変えずにエージェントの見た目を変えるには、[カスタムステータスラベル](/ja/docs/integrations/#カスタムステータスラベル)を参照してください。 diff --git a/docs/versions/0.9.3/website/src/content/docs/zh-cn/add-herdr-support.mdx b/docs/versions/0.9.3/website/src/content/docs/zh-cn/add-herdr-support.mdx index c6fda913..c0beec1a 100644 --- a/docs/versions/0.9.3/website/src/content/docs/zh-cn/add-herdr-support.mdx +++ b/docs/versions/0.9.3/website/src/content/docs/zh-cn/add-herdr-support.mdx @@ -48,6 +48,8 @@ Herdr 窗格中的每个进程都会继承这些环境变量: - `--source` 用于标识你的集成。保持稳定且唯一。不要以 `herdr:` 开头,这个前缀由 Herdr 自己的集成使用。 - `--seq` 可以省略,但建议加上。它必须随来自你的来源的每次上报递增,跨会话和智能体重启也要继续递增。时间戳就很合适。Herdr 会忽略编号不大于上次已接受编号的上报,所以迟到或乱序的上报不会覆盖更新的状态。 +如果想在不改变状态的情况下改变智能体的显示方式,例如标题或自定义状态文字,请参阅[自定义状态标签](/zh-cn/docs/integrations/#自定义状态标签)。 + ## 上报恢复命令 把恢复当前会话的命令放在 `--` 之后。带上该会话需要的选项,例如模型或权限模式,这样恢复后的会话行为一致: @@ -110,9 +112,3 @@ herdr agent list 1. 启动 `herdr --session my-agent-test`,然后在一个窗格中运行你的智能体。 2. 用 `herdr session stop my-agent-test` 停止该会话。 3. 再次启动 `herdr --session my-agent-test`。窗格应当运行你的恢复命令,智能体应当再次上报。 - -## 示例 - -[Prime Agent 内置的 Herdr 上报器](https://github.com/PrimeIntellect-ai/prime-agent/blob/main/packages/coding-agent/src/core/extensions/builtin/herdr-agent-state.ts)是一个真实的集成。它只在 Herdr 中启用,将智能体事件映射为 `working`、`idle` 和 `blocked`,跨会话保持上报顺序,并在退出时释放窗格。 - -如果想在不改变状态的情况下改变智能体的显示方式,例如标题或自定义状态文字,请参阅[自定义状态标签](/zh-cn/docs/integrations/#自定义状态标签)。