diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/next/website/src/content/docs/agents.mdx | 8 | ||||
| -rw-r--r-- | docs/next/website/src/content/docs/ja/agents.mdx | 8 | ||||
| -rw-r--r-- | docs/next/website/src/content/docs/zh-cn/agents.mdx | 8 |
3 files changed, 24 insertions, 0 deletions
diff --git a/docs/next/website/src/content/docs/agents.mdx b/docs/next/website/src/content/docs/agents.mdx index aaf6b5fb..78274850 100644 --- a/docs/next/website/src/content/docs/agents.mdx +++ b/docs/next/website/src/content/docs/agents.mdx @@ -91,6 +91,14 @@ Live explain is evaluated by the running server, so it reflects the active manif Herdr can run inside tmux as the outer terminal environment. Agent detection does not inspect tmux sessions launched inside a Herdr pane. If a shell framework auto-enters tmux inside Herdr, Herdr sees `tmux` as the pane process instead of the agent behind it. +If your shell automatically attaches to tmux whenever `TMUX` is unset, update its startup rule to exclude Herdr panes. Reattaching the outer tmux session from inside a Herdr pane can recursively shrink the terminal and make it flicker. Add the `HERDR_ENV` check to your existing condition before it runs tmux: + +```zsh +if [[ -z ${TMUX:-} && ${HERDR_ENV:-} != 1 ]]; then + tmux new-session -A -s my-session +fi +``` + ## State rollups The sidebar rolls state upward. diff --git a/docs/next/website/src/content/docs/ja/agents.mdx b/docs/next/website/src/content/docs/ja/agents.mdx index 3a365221..528ab0e4 100644 --- a/docs/next/website/src/content/docs/ja/agents.mdx +++ b/docs/next/website/src/content/docs/ja/agents.mdx @@ -89,6 +89,14 @@ herdr agent explain --file screen.txt --agent codex --json Herdr は外側のターミナル環境として tmux の中で動かせます。エージェント検出は、Herdr のペイン内で起動された tmux セッションの中までは調べません。シェルフレームワークが Herdr 内で自動的に tmux に入る場合、Herdr はペインのプロセスとして背後のエージェントではなく `tmux` を見ることになります。 +`TMUX` が未設定のときにシェルが自動的に tmux に接続する場合、シェルの起動条件を更新して Herdr のペインを除外してください。Herdr のペイン内から外側の tmux セッションに再接続すると、ターミナルのサイズが再帰的に縮小し、画面がちらつくことがあります。既存の条件に、tmux を実行する前に `HERDR_ENV` の確認を追加します: + +```zsh +if [[ -z ${TMUX:-} && ${HERDR_ENV:-} != 1 ]]; then + tmux new-session -A -s my-session +fi +``` + ## 状態のロールアップ サイドバーは状態を上位へ集約します。 diff --git a/docs/next/website/src/content/docs/zh-cn/agents.mdx b/docs/next/website/src/content/docs/zh-cn/agents.mdx index bc749add..80d572c6 100644 --- a/docs/next/website/src/content/docs/zh-cn/agents.mdx +++ b/docs/next/website/src/content/docs/zh-cn/agents.mdx @@ -89,6 +89,14 @@ herdr agent explain --file screen.txt --agent codex --json Herdr 可以在 tmux 作为外层终端环境时运行。智能体检测不会检查在 Herdr 窗格内启动的 tmux 会话。如果某个 shell 框架在 Herdr 内自动进入 tmux,Herdr 看到的窗格进程就是 `tmux`,而不是它背后的智能体。 +如果你的 shell 在 `TMUX` 未设置时自动连接 tmux,请更新 shell 启动条件以排除 Herdr 窗格。从 Herdr 窗格内重新连接外层 tmux 会话可能导致终端尺寸递归缩小、画面闪烁。在现有条件中加入 `HERDR_ENV` 检查,并确保它在运行 tmux 之前生效: + +```zsh +if [[ -z ${TMUX:-} && ${HERDR_ENV:-} != 1 ]]; then + tmux new-session -A -s my-session +fi +``` + ## 状态汇总 侧边栏会把状态向上汇总。 |