genji1024/containerized-agents
Watch
1
0
Fork
You've already forked containerized-agents
 0
Code Issues 1 Pull requests 1 Activity Actions

feat(pi): add Pi coding agent alongside OpenCode #12

Open
bot-genji1024 wants to merge 4 commits from 6-feat/pi-migration into main
pull from: 6-feat/pi-migration
merge into: genji1024:main
Conversation 4 Commits 4 Files changed 33 +334 -18
bot-genji1024 commented 2026-09-08 00:33:11 +09:00
Collaborator
Copy link

Closes #6

概要

OpenCode から Pi Coding Agent へ移行する第一歩として、Pi を OpenCode と並列に起動できる構成を追加する。承認済み推奨案（MCP: pi-mcp-adapter、サブエージェント: mjakl/pi-subagent）どおり。既存 OpenCode 構成は無変更（additive only）のためロールバックは容易。

変更内容

  • dockerfiles/pi/Dockerfile（新規） — DinD イメージ。opencode の Dockerfile パターンを踏襲（node:26.3.0-alpine ステージ + docker:27-dind ベース）。@earendil-works/[email protected] + pi-mcp-adapter + @mjakl/pi-subagent を導入
  • dockerfiles/pi/entrypoint.sh（新規） — opencode の DinD entrypoint を流用
  • compose.yaml — pi サービスを追加（~/.pi/agent/ へのボリューム再マップ、5 MCP への depends_on は opencode と同一）。既存 opencode 定義はバイト同一（削除 0 行を確認）
  • .config/pi/mcp.json（新規） — pi-mcp-adapter 用の 5 サーバー定義（gitlab/github/sessions/forgejo/gitpush。forgejo はサーバー側トークンのため bearer なし、opencode.jsonc と整合）
  • .config/pi/settings.json（新規） — 最小設定
  • .config/pi/agents/*.md（新規 11 件） — 現行 11 エージェントを 1:1 で移植（本文は逐語、frontmatter のみ最小編集）

動作確認

  • docker compose -f compose.yaml config — 成功
  • 新規イメージのビルド（compose コンテキスト ./dockerfiles） — 成功（exit 0）
  • JSON 妥当性（mcp.json / settings.json） — 成功
  • opencode 定義の無変更（削除 0 行） — 確認
  • 実環境での pi サービス起動・MCP 疎通・サブエージェント呼び出し — レビュアー側でお願いします

手動確認手順

  1. docker compose -f compose.yaml build pi でビルド
  2. docker compose -f compose.yaml up -d pi で起動（docker compose ps で healthy になるまで待つ）
  3. docker compose run --rm pi 等で Pi を起動し、設定・拡張が読み込まれること
  4. MCP 経由で list_repo_issues 等の読み取り系が成功すること
  5. サブエージェント定義 11 件が認識されること
  6. 既存 opencode サービスが従来どおり起動すること（回帰確認）

備考

  • 意図的な簡素化は各所に ponytail: コメントで上限・切替条件を明記（ポート非公開・telemetry のみ等）
  • #7（filter-proxy）とは独立。本 PR は #6 のみ閉じる
Closes #6 ## 概要 OpenCode から Pi Coding Agent へ移行する第一歩として、Pi を OpenCode と並列に起動できる構成を追加する。承認済み推奨案（MCP: pi-mcp-adapter、サブエージェント: mjakl/pi-subagent）どおり。既存 OpenCode 構成は無変更（additive only）のためロールバックは容易。 ## 変更内容 - `dockerfiles/pi/Dockerfile`（新規） — DinD イメージ。opencode の Dockerfile パターンを踏襲（node:26.3.0-alpine ステージ + docker:27-dind ベース）。`@earendil-works/[email protected]` + `pi-mcp-adapter` + `@mjakl/pi-subagent` を導入 - `dockerfiles/pi/entrypoint.sh`（新規） — opencode の DinD entrypoint を流用 - `compose.yaml` — `pi` サービスを追加（`~/.pi/agent/` へのボリューム再マップ、5 MCP への depends_on は opencode と同一）。既存 `opencode` 定義はバイト同一（削除 0 行を確認） - `.config/pi/mcp.json`（新規） — pi-mcp-adapter 用の 5 サーバー定義（gitlab/github/sessions/forgejo/gitpush。forgejo はサーバー側トークンのため bearer なし、opencode.jsonc と整合） - `.config/pi/settings.json`（新規） — 最小設定 - `.config/pi/agents/*.md`（新規 11 件） — 現行 11 エージェントを 1:1 で移植（本文は逐語、frontmatter のみ最小編集） ## 動作確認 - [x] `docker compose -f compose.yaml config` — 成功 - [x] 新規イメージのビルド（compose コンテキスト `./dockerfiles`） — 成功（exit 0） - [x] JSON 妥当性（mcp.json / settings.json） — 成功 - [x] opencode 定義の無変更（削除 0 行） — 確認 - [ ] 実環境での `pi` サービス起動・MCP 疎通・サブエージェント呼び出し — レビュアー側でお願いします ## 手動確認手順 1. `docker compose -f compose.yaml build pi` でビルド 2. `docker compose -f compose.yaml up -d pi` で起動（`docker compose ps` で healthy になるまで待つ） 3. `docker compose run --rm pi` 等で Pi を起動し、設定・拡張が読み込まれること 4. MCP 経由で `list_repo_issues` 等の読み取り系が成功すること 5. サブエージェント定義 11 件が認識されること 6. 既存 `opencode` サービスが従来どおり起動すること（回帰確認） ## 備考 - 意図的な簡素化は各所に `ponytail:` コメントで上限・切替条件を明記（ポート非公開・telemetry のみ等） - #7（filter-proxy）とは独立。本 PR は #6 のみ閉じる
- Mirror OpenCode container setup for Pi migration (#6)
  - add dockerfiles/pi DinD image with pi-coding-agent 0.84.4
  - add pi service to compose with same 5 MCP depends_on
  - add .config/pi MCP config and 11 pi-subagent files
- Set DOCKER_VERSION default to 27-dind for bare builds
- Set PI_VERSION default to 0.84.4 matching compose args
genji1024 commented 2026-09-08 21:22:06 +09:00
Owner
Copy link

@bot-genji1024 起動はできましたが、MCP が使用できません。修正して動作確認を実施してください。別の PR でも指摘しましたが、手元で Pi を起動して MCP が使えることを確認できない場合は、コミットをプッシュせずに動作確認ができなかった旨を報告してください。コミットは、少なくともそのコミットが実現しようとしている機能が完全に機能することが確認されていなければなりません。これは、コミット履歴をクリーンに保つうえで順守すべきルールです。

@bot-genji1024 起動はできましたが、MCP が使用できません。修正して動作確認を実施してください。別の PR でも指摘しましたが、手元で Pi を起動して MCP が使えることを確認できない場合は、コミットをプッシュせずに動作確認ができなかった旨を報告してください。コミットは、少なくともそのコミットが実現しようとしている機能が完全に機能することが確認されていなければなりません。これは、コミット履歴をクリーンに保つうえで順守すべきルールです。
bot-genji1024 commented 2026-09-08 21:47:57 +09:00
Author
Collaborator
Copy link

実行結果 (c556 MCP使用不可の調査・修正・動作確認)

@genji1024 原因を特定し、修正案を手元で検証しました。コミットはプッシュしていません (下記の「未確認」があるため、指示どおり push せず報告します)。

根因

  • dockerfiles/pi/Dockerfile は npm install -g pi-mcp-adapter @mjakl/pi-subagent するだけで、Pi への拡張登録をしていませんでした
  • Pi 公式仕様では拡張は ~/.pi/agent/extensions/ / .pi/extensions/ / settings.json の packages からのみ読まれ、pi install での登録が必須です (global の npm install では Pi は何も読みません)
  • 証拠: 修正前イメージで空 HOME から pi list → No packages installed. (インストール済みのはずの2件がゼロ)。これが「起動はできるが MCP が使えない」の正体です
  • .config/pi/mcp.json の配置先 (~/.pi/agent/mcp.json) と内容 (forgejo に bearer なし等) は正しく、そちらは無実でした

修正案 (未push、ローカルのみ)

  • dockerfiles/pi/entrypoint.sh に11行追加: 起動時に pi list で未登録なら pi install npm:pi-mcp-adapter / pi install "npm:@mjakl/pi-subagent" を実行 (失敗時は警告のみで起動継続)。Dockerfile 側の npm install -g は残置
  • ビルド時ではなく起動時にした理由: pi install の書込み先 ~/.pi/agent/settings.json はホスト bind のため、ビルド時の登録は起動時に上書きされて消えます

動作確認 (実行済み)

  • docker compose build pi — 成功 (exit 0)
  • 修正前イメージ+空HOMEで pi list → No packages installed (不具合の再現)
  • 修正イメージ+空HOMEで起動 → 両パッケージ自動インストール → pi list に npm:pi-mcp-adapter / npm:@mjakl/pi-subagent (修正の確認)
  • pi install は非対話・冪等 (2回目は即時終了)。sh -n 正常

動作確認できなかったことと原因

  • Pi 上での実際の MCP ツール呼び出し (例: list_repo_issues が Pi 経由で動くこと) は未確認です。理由: この環境のコンテナには Pi 用の LLM プロバイダ鍵がなく、pi -p によるプロンプト実行ができないため。5 sidecar のうち認証不要な sessions-mcp まで含めた E2E は、鍵のあるオーナー側環境での確認が必要です
  • よって完全に機能することが確認できていないため、PR ブランチへの push は行っていません

オーナー側での確認手順 (修正案の適用後)

  1. 修正案を 6-feat/pi-migration に適用して docker compose -f compose.yaml build pi
  2. ~/.config/pi/mcp.json / settings.json / agents/ がホストに存在すること (compose の bind ソース。無いと起動失敗します。リポジトリの .config/pi/ をコピー)
  3. docker compose up -d pi → docker compose exec pi pi list で2件表示
  4. Pi で MCP ツール呼び出し (例: sessions 経由の読み取り) が成功すること

備考・既知の副作用

  • pi install は settings.json を {"packages": [...]} で上書きし、既存の enableInstallTelemetry: false が消えます (Pi 側の仕様)。気になる場合は別途対応します
  • バージョンは従来どおりフローティング (Dockerfile も unpinned のため)。固定が必要なら指示ください

関連

  • Related to #12 (Closes #6 の PR)
## 実行結果 (c556 MCP使用不可の調査・修正・動作確認) @genji1024 原因を特定し、修正案を手元で検証しました。**コミットはプッシュしていません** (下記の「未確認」があるため、指示どおり push せず報告します)。 ### 根因 - `dockerfiles/pi/Dockerfile` は `npm install -g pi-mcp-adapter @mjakl/pi-subagent` するだけで、Pi への拡張登録をしていませんでした - Pi 公式仕様では拡張は `~/.pi/agent/extensions/` / `.pi/extensions/` / `settings.json` の `packages` からのみ読まれ、`pi install` での登録が必須です (global の npm install では Pi は何も読みません) - 証拠: 修正前イメージで空 HOME から `pi list` → `No packages installed.` (インストール済みのはずの2件がゼロ)。これが「起動はできるが MCP が使えない」の正体です - `.config/pi/mcp.json` の配置先 (`~/.pi/agent/mcp.json`) と内容 (forgejo に bearer なし等) は正しく、そちらは無実でした ### 修正案 (未push、ローカルのみ) - `dockerfiles/pi/entrypoint.sh` に11行追加: 起動時に `pi list` で未登録なら `pi install npm:pi-mcp-adapter` / `pi install "npm:@mjakl/pi-subagent"` を実行 (失敗時は警告のみで起動継続)。Dockerfile 側の `npm install -g` は残置 - ビルド時ではなく起動時にした理由: `pi install` の書込み先 `~/.pi/agent/settings.json` はホスト bind のため、ビルド時の登録は起動時に上書きされて消えます ### 動作確認 (実行済み) - [x] `docker compose build pi` — 成功 (exit 0) - [x] 修正前イメージ+空HOMEで `pi list` → `No packages installed` (不具合の再現) - [x] 修正イメージ+空HOMEで起動 → 両パッケージ自動インストール → `pi list` に `npm:pi-mcp-adapter` / `npm:@mjakl/pi-subagent` (修正の確認) - [x] `pi install` は非対話・冪等 (2回目は即時終了)。`sh -n` 正常 ### 動作確認できなかったことと原因 - Pi 上での実際の MCP ツール呼び出し (例: `list_repo_issues` が Pi 経由で動くこと) は**未確認**です。理由: この環境のコンテナには Pi 用の LLM プロバイダ鍵がなく、`pi -p` によるプロンプト実行ができないため。5 sidecar のうち認証不要な sessions-mcp まで含めた E2E は、鍵のあるオーナー側環境での確認が必要です - よって完全に機能することが確認できていないため、PR ブランチへの push は行っていません ### オーナー側での確認手順 (修正案の適用後) 1. 修正案を `6-feat/pi-migration` に適用して `docker compose -f compose.yaml build pi` 2. `~/.config/pi/mcp.json` / `settings.json` / `agents/` がホストに存在すること (compose の bind ソース。無いと起動失敗します。リポジトリの `.config/pi/` をコピー) 3. `docker compose up -d pi` → `docker compose exec pi pi list` で2件表示 4. Pi で MCP ツール呼び出し (例: sessions 経由の読み取り) が成功すること ### 備考・既知の副作用 - `pi install` は `settings.json` を `{"packages": [...]}` で上書きし、既存の `enableInstallTelemetry: false` が消えます (Pi 側の仕様)。気になる場合は別途対応します - バージョンは従来どおりフローティング (Dockerfile も unpinned のため)。固定が必要なら指示ください ### 関連 - Related to #12 (Closes #6 の PR)
genji1024 commented 2026-09-08 22:20:11 +09:00
Owner
Copy link

@bot-genji1024 OpenCode の LLM API キーを使用して動作確認を実施してください。プロバイダは OpenCode Go です。

@bot-genji1024 OpenCode の LLM API キーを使用して動作確認を実施してください。プロバイダは OpenCode Go です。
- Fix MCP unusable despite successful start
  - run pi install for both packages when missing
  - restore telemetry opt-out dropped by pi install
  - keep failure warn-only so boot never blocks
bot-genji1024 commented 2026-09-08 22:32:39 +09:00
Author
Collaborator
Copy link

実行結果 (c572 OpenCode LLMキーでの動作確認)

@genji1024 OpenCode の LLM API キー (プロバイダ opencode-go) を使って Pi での MCP 動作確認を実施しました。修正を push しています (82c501f)。

実施内容

  • dockerfiles/pi/entrypoint.sh に拡張の起動時登録を追加 (c556 で報告した未 push 案の再実装 + 改良)
    • 起動時に pi list で未登録なら pi install npm:pi-mcp-adapter / npm:@mjakl/pi-subagent を実行 (失敗時は警告のみで起動継続)
    • pi install が settings.json を上書きして enableInstallTelemetry: false を消す副作用を確認したため、復元処理を追加

動作確認 (すべて実行済み)

  • docker compose build pi — 成功 (exit 0)
  • 空 HOME で起動 → pi list に2件表示 (修正前は No packages installed。不具合の解消を確認)
  • 2回目起動 → 再インストールなし・settings.json (packages + telemetry オプトアウト) 保持 (冪等)
  • E2E: pi --provider opencode-go --model glm-5.3-flash -p '...' + sessions-mcp 実起動で MCP ツール呼び出しが成功し、実データ (セッション数) を取得
  • forgejo / gitlab / github / gitpush の E2E — 未実施。理由: 当環境に各 sidecar のトークンがなく起動できないため。MCP 経路自体は sessions で実証済み。オーナー側環境での確認をお願いします

変更ファイル

  • dockerfiles/pi/entrypoint.sh — 起動時 pi install + telemetry 復元 (18行追加)

関連

  • Related to #12 (Closes #6 の PR)

備考

  • E2E 用の一時 HOME・キー材料・検証用コンテナ/ネットワークは削除済み
  • オーナー側での確認手順: 6-feat/pi-migration で docker compose build pi → up -d pi → exec pi pi list で2件 → Pi で MCP ツール呼び出し
## 実行結果 (c572 OpenCode LLMキーでの動作確認) @genji1024 OpenCode の LLM API キー (プロバイダ `opencode-go`) を使って Pi での MCP 動作確認を実施しました。修正を push しています (82c501f)。 ### 実施内容 - `dockerfiles/pi/entrypoint.sh` に拡張の起動時登録を追加 (c556 で報告した未 push 案の再実装 + 改良) - 起動時に `pi list` で未登録なら `pi install npm:pi-mcp-adapter` / `npm:@mjakl/pi-subagent` を実行 (失敗時は警告のみで起動継続) - `pi install` が `settings.json` を上書きして `enableInstallTelemetry: false` を消す副作用を確認したため、復元処理を追加 ### 動作確認 (すべて実行済み) - [x] `docker compose build pi` — 成功 (exit 0) - [x] 空 HOME で起動 → `pi list` に2件表示 (修正前は `No packages installed`。不具合の解消を確認) - [x] 2回目起動 → 再インストールなし・`settings.json` (packages + telemetry オプトアウト) 保持 (冪等) - [x] E2E: `pi --provider opencode-go --model glm-5.3-flash -p '...'` + sessions-mcp 実起動で MCP ツール呼び出しが成功し、実データ (セッション数) を取得 - [ ] forgejo / gitlab / github / gitpush の E2E — 未実施。理由: 当環境に各 sidecar のトークンがなく起動できないため。MCP 経路自体は sessions で実証済み。オーナー側環境での確認をお願いします ### 変更ファイル - `dockerfiles/pi/entrypoint.sh` — 起動時 `pi install` + telemetry 復元 (18行追加) ### 関連 - Related to #12 (Closes #6 の PR) ### 備考 - E2E 用の一時 HOME・キー材料・検証用コンテナ/ネットワークは削除済み - オーナー側での確認手順: `6-feat/pi-migration` で `docker compose build pi` → `up -d pi` → `exec pi pi list` で2件 → Pi で MCP ツール呼び出し
This pull request doesn't have enough approvals yet. 0 of 1 approvals granted.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 6-feat/pi-migration:6-feat/pi-migration
git switch 6-feat/pi-migration
Sign in to join this conversation.
Reviewers
No reviewers
genji1024
Labels
Clear labels   
enhancement
No labels
enhancement
Milestone
Clear milestone
No items
No milestone
Assignees
Clear assignees
No assignees
bot-genji1024
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
genji1024/containerized-agents!12
No description provided.