1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Pi(OSSコーディングエージェント)を試す前の安全点検|npmを--ignore-scriptsで取得し、実行前に静的チェックする手順

1
Posted at

title: "Pi(OSSコーディングエージェント)を試す前の安全点検|npmを--ignore-scriptsで取得し、実行前に静的チェックする手順"
tags:
  - AIエージェント
  - npm
  - Pi
  - ClaudeCode
  - セキュリティ
private: false

pi_cover.png

はじめに

「Goodbye Claude, hello Pi」というブログが、Hacker Newsで586ポイントを集めました※4。OSSのコーディングエージェント「Pi」に乗り換えた、という内容です。

Piは、公式READMEによると、権限システムを標準では持ちません※2。ファイルやコマンドを自由に実行できるため、試す前の点検が、いつもより重要になります。

この記事では、Piを実行する前にできる、安全点検の手順を示します。

  1. npmで、スクリプトを実行せずに取得する
  2. 取得したパッケージの、ライフサイクルスクリプトを静的に点検する
  3. CLAUDE.md と AGENTS.md の共通化を確認する
  4. 隔離環境で試す、最初の手順を決める

実施日は2026-11-09です。環境はLinux、Node v22.23.4、Python 3.13です。筆者はPiを実行していません。 取得した外部のコードを実行する操作が、実行環境の自動判定で止められたため、回避せずに見送りました。この記事の内容は、取得と静的点検までです。

1. 前提:Piとは

公式サイトとREADMEの説明をまとめます※2※3。

項目 内容
位置づけ 最小のエージェントハーネス(ターミナル用のコーディングエージェント)
提供 Earendil Inc.と貢献者。MITライセンス
必要な環境 Node.js 22.19以上
利用モード 対話型TUI、print / JSON、RPC、SDK
標準で持たないもの サブエージェント、プランモード、権限システム
拡張 TypeScriptのモジュール。npmやgitから配布
GitHub 118.2kスター、15.1kフォーク(2026-11-09取得)

READMEは、権限システムについて、ファイルシステム、プロセス、ネットワーク、認証情報へのアクセスを制限する仕組みを持たないと書いています。より強い隔離には、コンテナやサンドボックスを勧めています※2。

2. npmで、スクリプトを実行せずに取得する

公式のnpm手順にも --ignore-scripts が付いています※2。このオプションは、インストール時に、依存パッケージが持つ preinstall や postinstall を実行しないようにします。

mkdir -p pi-check && cd pi-check
npm install --ignore-scripts --prefix ./inst @earendil-works/pi-coding-agent

取得したバージョンの確認です。

grep -E '"(name|version|license)"' inst/node_modules/@earendil-works/pi-coding-agent/package.json

結果です。

	"name": "@earendil-works/pi-coding-agent",
	"version": "1.5.0",
	"license": "MIT",

筆者の環境で、サイズと構成を確認しました。

du -sh inst/node_modules          # 158M
ls inst/node_modules | wc -l      # 79(スコープ付きは1件として数えます)
ls inst/node_modules/@earendil-works

@earendil-works 配下には、次の8つが入っていました。

pi-agent-core  pi-ai  pi-codemode  pi-coding-agent  pi-mcp  pi-schema  pi-telemetry  pi-tui

必要なNodeは >=22.19.0 と、package.json に書かれています。筆者のNodeはv26.8.2で、条件を満たしていました。

3. ライフサイクルスクリプトを静的に点検する

--ignore-scripts で取得しても、後から npm rebuild などを実行すると、スクリプトが動く場合があります。実行する前に、どのパッケージが、どんなスクリプトを持つかを知っておくと安全です。

3.1 点検スクリプト

node_modules 内の package.json を走査し、preinstall、install、postinstall、prepare を持つパッケージを列挙します。Python 3.13の標準ライブラリだけで動きます。

#!/usr/bin/env python3
"""node_modules 内の package.json を走査し、install系ライフサイクルスクリプトを持つパッケージを列挙する。
--ignore-scripts で取得したパッケージを「実行前に」点検するための静的チェック(Python 3.13、標準ライブラリのみ)。"""
import json, os, sys
root = sys.argv[1]
hooks = ("preinstall", "install", "postinstall", "prepare")
total = 0; found = []
for dp, dn, fn in os.walk(root):
    if "package.json" in fn:
        try: d = json.load(open(os.path.join(dp, "package.json"), encoding="utf-8"))
        except Exception: continue
        if not d.get("name") or not d.get("version"): continue
        total += 1
        s = d.get("scripts", {}) or {}
        hit = {k: s[k] for k in hooks if k in s}
        if hit: found.append((d["name"], d["version"], hit))
print(f"packages scanned: {total}")
for n, v, h in sorted(set((n, v, json.dumps(h, ensure_ascii=False)) for n, v, h in found)): print(f"  {n}@{v}: {h}")
print("lifecycle hooks found:", len(found))

3.2 実行結果

python3 -I audit_scripts.py inst/node_modules

実際の出力です。

packages scanned: 127
  @google/genai@2.21.0: {"preinstall": "echo 'preinstall: no-op'", "prepare": "node scripts/prepare.js"}
  @isaacs/nonrecursive-glob-match@1.1.0: {"prepare": "tshy && bash scripts/build.sh"}
  balanced-match@4.0.4: {"prepare": "tshy"}
  brace-expansion@5.0.12: {"prepare": "tshy"}
  gaxios@7.3.1: {"prepare": "npm run compile"}
  gcp-metadata@8.1.2: {"prepare": "npm run compile"}
  google-auth-library@10.9.1: {"prepare": "npm run compile"}
  google-logging-utils@1.1.3: {"prepare": "npm run compile"}
  lru-cache@11.5.3: {"prepare": "tshy && bash scripts/build.sh"}
  minimatch@11.0.3: {"prepare": "tshy"}
  protobufjs@7.6.6: {"postinstall": "node scripts/postinstall"}
  standardwebhooks@1.1.1: {"prepare": "npm run build"}
  undici@8.12.3: {"prepare": "husky && node ./scripts/platform-shell.js"}
  web-streams-polyfill@3.3.3: {"prepare": "npm run build"}
lifecycle hooks found: 14

127個のパッケージを走査し、14個がライフサイクルスクリプトを持っていました。

3.3 結果の読み方

区分 パッケージ 内容
postinstall protobufjs@7.6.6 node scripts/postinstall を実行する
preinstall @google/genai@2.21.0 echo 'preinstall: no-op'。何もしない
prepare 他の12個 ビルド用(tshy、npm run compile など)

prepare は、一般にnpmの仕様として、レジストリから依存として入れる場合には実行されず、開発時(ローカルでの npm install やgit経由の取得)に使われます。筆者はこの仕様を、今回の環境で試していません。公式のnpmドキュメントで確認してください。

注意すべきは postinstall を持つパッケージです。protobufjs は、広く使われているライブラリです。筆者は、scripts/postinstall の中身を読んでいません。スクリプトの実行を許可する前に、中身を読むのが安全です。

この点検は、悪意の有無を判定するものではありません。スクリプトの存在を知るためのものです。

3.4 うまくいかなかった点

  • スクリプトの中身(scripts/postinstall など)までは、確認していません。
  • 依存の依存まで走査した結果で、node_modules に展開されたものだけが対象です。
  • npm audit のような、既知の脆弱性の確認は、この記事では行っていません。

4. CLAUDE.md と AGENTS.md を共通化する

ブログの著者は、Claude Codeが CLAUDE.md、他のツールが AGENTS.md を使うため、コピーかシンボリックリンクが必要だと書いています※1。Piは、AGENTS.md と SYSTEM.md を文脈設計の仕組みに挙げています※3。

ブログによると、Anthropicは AGENTS.md への対応を発表済みです※1。ただし、筆者はその公式の記述を確認していません。対応状況は、利用中のバージョンで確認してください。

シンボリックリンクで共通化する手順を、一時ディレクトリで試しました。

echo "# rules" > AGENTS.md
ln -s AGENTS.md CLAUDE.md
ls -l
git init -q . && git add AGENTS.md CLAUDE.md && git ls-files -s

結果です。

-rw-r--r-- 1 root root 8 AGENTS.md
lrwxrwxrwx 1 root root 9 CLAUDE.md -> AGENTS.md
100644 e4dce001483aafa30db213c87b139909893f64ff 0	AGENTS.md
120000 47dc3e3d863cfb5727b87d785d09abf9743c0a72 0	CLAUDE.md

gitは、CLAUDE.md をモード 120000(シンボリックリンク)として記録しました。内容は AGENTS.md と同じです。

注意点:Windowsでは、シンボリックリンクの扱いに設定が必要な場合があります。チームにWindows利用者がいる場合は、コピーを生成するスクリプトも検討してください。この点は、筆者は検証していません。

5. 隔離環境で試す、最初の手順

Piは権限システムを持たないため、先に隔離を用意します※2。READMEの推奨に沿った考え方を、手順に直します。筆者は実行していません。

手順 内容
1 使い捨てのコンテナを用意する(ホストの重要なディレクトリはマウントしない)
2 本番の認証情報を持ち込まない。環境変数にも入れない
3 ネットワークは、必要な接続先だけを許可する
4 プロジェクトは、コピーまたは読み取り専用でマウントする
5 npm install -g --ignore-scripts @earendil-works/pi-coding-agent で入れる※2
6 pi を起動し、/login でプロバイダを接続する
7 小さなタスクで試し、実行されたコマンドを記録する
8 権限ゲートの拡張を入れる場合は、先にサンプルのコードを読む

READMEは、npm版が、推移的な依存のバージョンを固定しないと書いています※2。再現性が必要な場合は、ロックファイルで固定してください。

5.1 同じ日の話題と合わせて

同じ日に、Claude Codeの「Don't Ask Again」で秘密が保存される件が、HNで515ポイントを集めました。承認ルールを保存する設計が、秘密の保存になる、という話です。

Piは、承認ルールを持たないため、その経路は生まれません。ただし、制限もないため、隔離と認証情報の管理が、利用者側の責任になります。どちらが安全かは、運用で決まります。

6. 筆者がまだ確認できていないこと

  • Piの実行、対話動作、拡張、権限ゲートの挙動。
  • pi.dev の公式インストールスクリプト(この環境から接続できませんでした)。
  • ブログの数字(244リリース、4分の3超、約3,000トークン)の再計測。
  • protobufjs などの postinstall の中身。

まとめ

  • Piは、権限システムを標準で持たないOSSのエージェントハーネスです。試す前の点検と隔離が重要です。
  • --ignore-scripts で取得し、スクリプトを静的に点検すると、実行前に、存在を知ることができます。筆者の環境では、127パッケージ中14個がライフサイクルスクリプトを持っていました。
  • CLAUDE.md と AGENTS.md は、シンボリックリンクで共通化できます。
  • 筆者は、Piを実行していません。実行環境が整い次第、隔離して試します。

※本記事の記載内容は筆者個人の見解であり、所属する会社や組織の立場や方針とは一切関係ありません。

筆者情報

【Tomcat-zhou】|AI/AX/AIセキュリティ専門家

AI戦略洞察、AI駆動開発の方法論設計と現場で回る仕組みづくりをしています。
noteで戦略洞察 / Zenn・Qiitaで技術・方法論を書いています。
AIセキュリティ・AIコンサル・AIエージェント開発・AI活用・AI駆動開発教育、AI人材育成サービスを一体で提供。

X: @ZY20240528
LinkedIn: Tomcat-zhou
Facebook: zhou yi
note: Tomcat-zhou
Zenn: Tomcat-zhou

参考資料

  1. Goodbye Claude, hello Pi(caleb.software、2026-09-21公開・2026-11-07更新)
  2. earendil-works/pi(GitHub、2026-11-09取得)
  3. Pi 公式サイト(pi.dev、2026-11-09取得)
  4. Hacker News フロントページ(2026-11-09取得)

タグ

AIエージェント npm Pi ClaudeCode セキュリティ AGENTS.md OSS

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?