メインコンテンツまでスキップ

コーディング

コーディング 画面(/coding)は、リポジトリを対象にしたコーディング作業を 会話形式で進める機能です。バックエンドは OpenCode ACP に一本化されています。

二層構成​

コーディングは次の二層で動きます。

  • Coordinator(進行役の LLM) — 進捗・質問・最終要約だけを担当します。
  • Worker(外部 CLI) — リポジトリ調査・実装・テスト・技術判断を担当します。

Coordinator は応答本文に <cli_request> を出力してタスクを委譲します。 アプリがそれを抽出して Worker を実行し、Worker の出力を次ターンの観測として返します。 Coordinator が run_shell などのツールで CLI を起動することはなく、バックエンド名は Coordinator に開示されません。

Web UI で使う​

  1. 左サイドバーでプロジェクトとセッションを選びます。
  2. セッションが無い場合は + 新規 で作成します(プロジェクトが必要)。
  3. 入力欄からメッセージを送ります(送信)。実行中の会話は キャンセル できます。
  4. Worker(実行担当の外部 CLI)のモデルを変えるには、入力欄の Worker: の横のセレクタで選びます(次回送信から適用)。
  5. 会話設定 ⚙ で、そのセッションの オーケストレーター(進行役)のモデル と、許可するツールを調整できます。オーケストレーターを「既定を使用」にすると coding.orchestrator の設定が使われます。
  6. 既定設定 で、新規会話に適用する既定ツールセットを設定できます。

セッションタイトルは セッションタイトル 入力で変更できます。

CLI で使う​

新規セッションは --project-id、再開は --resume-session を指定します。 プロンプトは位置引数として渡すか、stdin から読み取ります。

uv run -m obsidian_ai_hub --coding --project-id 42 "このモジュールのテストを追加して"
uv run -m obsidian_ai_hub --coding --resume-session asess_1234567890ab "続きを進めて"
cat prompt.txt | uv run -m obsidian_ai_hub --coding --project-id 42

--json で結果を JSON として出力できます。

設定​

config/config.yml の coding で設定します。環境変数が YAML より優先されます。

coding:
orchestrator:
provider: openai # openai | ollama | gemini | opencode_go | local
model: gpt-5.6-terra
cli:
opencode_path: /path/to/your/opencode # 既定: PATH 上の opencode
acp:
turn_timeout_seconds: 7200 # 既定: 7200秒(2時間)
opencode_model: opencode-go/muse-spark-1.3-contributor
opencode_models:
- opencode-go/muse-spark-1.3-contributor
設定環境変数既定
coding.orchestrator.providerCODING_ORCHESTRATOR_PROVIDERopenai
coding.orchestrator.modelCODING_ORCHESTRATOR_MODELgpt-5.6-terra
coding.cli.opencode_pathCODING_OPENCODE_CLI_PATHopencode
coding.acp.turn_timeout_secondsCODING_ACP_TURN_TIMEOUT_SECONDS7200(2時間)
coding.acp.opencode_modelCODING_OPENCODE_MODELopencode-go/muse-spark-1.3-contributor
coding.acp.opencode_modelsCODING_OPENCODE_MODELS上記 1 件
  • turn_timeout_seconds は各 ACP session/prompt ターン単位の実行制限時間(正の秒数、既定: 7200秒=2時間)を設定します。タイマーはターンごとにリセットされ、HITL待機や Coordinator による次ターンは別枠です。不正な値や 0 以下の値は起動時にエラーとなります。変更の反映には Web サービスの再起動が必要です。
  • 時間上限に到達した場合は ACP に session/cancel を一度だけ送信し、run 状態は独立した終端状態 timed_out(画面表示: 制限時間到達)に遷移して failure カテゴリの通知を配信します。明示的なキャンセル(cancelled)とは区別されます。
  • 使用モデルは毎ターンの prompt 前に ACP の session/set_config_option(configId: "model")で固定されます。拒否された場合はそのターンが失敗します。
  • 選択したモデルが reasoning effort(カテゴリ thought_level)を広告する場合、max → xhigh → high → medium → low の優先順で最初に利用できる値を同じ session/set_config_option で設定します。広告がない、または優先順の値がない場合は OpenCode の既定値で実行し、実行診断に広告値と未対応理由を記録します。設定が拒否された場合はそのターンを失敗させ、既定値へはフォールバックしません。
  • 選択できるモデルは opencode_models の許可リストに限られます。
  • 旧 Direct CLI(Codex / OpenCode run)と Codex バックエンドは廃止済みです。既存の旧セッションは読み取り専用で、新しい実行には OpenCode ACP の新規セッションが必要です。

詳細は コーディング設定 を参照してください。

次に読む​