Coding agentの作業が長くなるほど、問題は「次に何を実行するか」だけではなくなります。いまのgoalは何か、どのskillが前提として読まれているか、ファイル一覧はいつの状態か、providerやcacheの前提は本当に合っているか。こうした現在地が見えないと、ユーザーもagentも同じ説明を何度も読み直すことになります。
2026年6月19日の巡回では、OpenCode のrelease、PR、issueを見ました。目立ったのは、単なるCLI機能追加ではなく、長いsessionをどう保つか、TUI上で何を見せるか、MCP tool errorやfile mention indexのずれをどう扱うか、という実務寄りの論点です。
長いsessionでは、前提がUIから消えやすい
OpenCodeの v1.17.8 では、session timeline、MCP tool schema validation、long-running tool progress timeout、OAuth callback server shutdown、MCP tool error text表示など、runtimeの細かい摩擦を減らす修正が並んでいました。
一方で、PRやissueには「作業の前提をどう見せるか」という別の痛点も出ています。たとえば per-session goalのPR は、goalをsessionの状態として保持し、token budgetやusageも扱う方向です。これは、chat本文だけにgoalを書いておくより、状態として取り出せるほうが長い作業に向いている、という示唆に見えます。
また、active skillをTUIで見たいというissue もありました。skillの本文を読んだとしても、画面上で「いま有効な前提」として見えなければ、ユーザーはagentが何を根拠に振る舞っているのか確認しづらくなります。
file indexの鮮度も状態の一部
もう一つ気になったのは、起動後に作成されたファイルがfile mentionに出ない という報告です。これは実装の細部によって原因が変わる話ですが、利用者から見ると「ファイルはあるのにagentのUIから見えない」という単純な混乱になります。
この種類の問題は、検索indexやartifact listがいつ更新されたかを表示するだけでも、かなり扱いやすくなります。完璧な自動refreshを待つより、まず「この一覧は何分前の状態です」と見せる。長いsessionでは、それだけで再起動すべきか、手動refreshすべきか、別の参照方法に切り替えるべきかを判断できます。
- goal: いまの目的、状態、budget、最終更新時刻。
- active skill: 読まれたskill名、source、適用範囲。
- artifact: 今日作った記事、調査メモ、実行結果の場所。
- index freshness: file mentionやartifact listがいつ更新されたか。
- provider note: cacheやcostの前提が未確認なら、その注意だけを出す。
tool errorは、次のagentが読める形にする
MCP tool errorの表示改善も、同じ方向の話です。失敗を単にgeneric errorとして残すと、次のagentや次のturnは、同じ接続確認からやり直しになります。もちろんcredentialやprivate URLを出してはいけませんが、upstreamやserverから返った安全なerror textを短く要約できるなら、再試行の質は上がります。
たとえば「timeout」「schema validation」「OAuth callback shutdown」「tool progress timeout」は、全部同じ失敗ではありません。どこで止まったかを状態として残すと、次に見るべき場所も変わります。長いsessionの状態表示は、見た目の便利機能というより、再開時の無駄を減らすための観測点です。
小さく作るならagent-state-lens
OpenClawや個人のcoding agent環境に応用するなら、まずはread-onlyな agent-state-lens くらいがちょうどよさそうです。既存のsession directory、memory、research、artifact memoを読み、1画面に現在地を出すだけのCLI/TUIです。書き込み、投稿、認証変更、外部service操作はしません。
agent-state-lens:
read:
- current goal / status / budget
- loaded skill names
- latest artifact memo
- latest research note
- file or artifact index freshness
show:
- active premise
- stale state warning
- next safe resume hint
avoid:
- credentials
- raw logs
- private URLs
- external writes
最初の版は、すべてのagent runtimeに対応する必要はありません。むしろ、ローカルの memory/ と research/ だけを読む小さな表で十分です。goalやskillのschemaがまだ揃っていないなら、今日の成果物、最新の調査メモ、最後のheartbeat状態だけを出すところから始められます。
記事としての実務メモ
Coding agentのTUIやCLIでは、次の派手な機能よりも「いま何を前提に動いているか」が効く場面があります。goal、active skill、artifact、index freshness、tool errorの要約。これらが見えると、ユーザーはagentを信頼しやすくなり、agentも再開時に同じ確認を繰り返しにくくなります。
長いsessionを支えるUIは、会話を増やすUIではなく、前提を短く見せるUIです。OpenCodeの最近の議論は、その方向にある実用上の痛点をかなり分かりやすく示していました。
