Pi Coding Agentは、開発者が自分専用のAIエージェントハーネスを構築するための最小限のターミナル型ツールです。公式のプロジェクトサイトやnpmレジストリ、GitHubリポジトリによると、事前に用意された大規模エージェントに頼るのではなく、必要な機能を自ら追加するアプローチを重視しています。独立した公式ソース（pi.dev、npm、GitHub）から得られた情報をもとに、インストール方法や拡張のポイントを整理します。
📑目次
Pi Coding Agentとは
Pi Coding Agent（以下、Pi）は、Mario Zechner氏が開発したオープンソースのターミナル型コーディングエージェントです。GitHubリポジトリはearendil-works/pi、npmパッケージは@earendil-works/pi-coding-agentとして公開されています。公式サイトpi.devでは「多くのエージェントハーネスがあるが、これはあなた自身のもの」と位置づけられています。
このツールの特徴は、薄い抽象化レイヤーです。LLMのAPIに近い位置で動作するため、モデルやプロバイダの切り替えが容易です。ChatGPT、Claude、Gemini、xAI Grokなど複数のプロバイダに対応します。デフォルトでread、write、edit、bashなどの基本ツールが用意されており、grepやfindなどのCLIツールも利用可能です。
拡張性を重視した設計により、TypeScriptでカスタム機能を追加できます。はてなブックマーク検索やWeb検索などの独自ツールを組み込む例が、公式の文脈で示されています。著者の書籍「作って学ぶAIエージェント」との関連も指摘されています。
インストールと初期設定
インストールはシンプルです。npm経由でグローバルインストールします。
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
または、公式のインストールスクリプトを利用できます。
curl -fsSL https://pi.dev/install.sh | sh
インストール後、/loginコマンドでモデルプロバイダにログインします。/modelコマンドで使用モデルを選択可能です。ChatGPT Plus/Pro、Claude Pro/Max、GitHub Copilotなどに対応しています。APIキーを持つプロバイダも柔軟に設定できます。
初期設定では、プロジェクトディレクトリ内でエージェントを起動し、対話形式でコード生成や編集を行います。薄い設計のため、追加の設定ファイルは最小限で済みます。
基本ツールとモデル選択
デフォルトツールはファイル操作とシェル実行に特化しています。readでファイル内容を確認し、writeやeditで変更を加えます。bashツールで任意のコマンドを実行可能です。これにより、開発ワークフローの大部分をカバーします。
モデル選択の柔軟性が強みです。OpenRouterやVercel AI Gateway経由で多様なモデルを利用できます。プロバイダの制限を受けにくいため、最新モデルやコストの低い選択肢を試せます。公式情報では、複数のプロバイダを切り替える実例が紹介されています。
拡張例 —— はてなブックマーク検索やWeb検索の追加
Pi Coding Agentの拡張はTypeScript extensionで行います。新しいツールを定義し、エージェントのツールセットに登録します。はてなブックマーク検索ツールの追加例では、APIを呼び出して人気エントリを取得し、コンテキストとして活用します。
Web検索ツールの追加も同様です。外部APIと連携し、最新情報をエージェントに与えます。拡張はnpmパッケージやGitリポジトリ経由で共有可能です。pi.devのドキュメントでは、Skills、Prompt Templates、Themes、Pi packagesといった拡張手段が説明されています。
これらの拡張により、汎用エージェントを自分専用のハーネスに近づけられます。特定の業務や趣味に特化した機能を追加するケースが想定されています。
他のエージェントとの比較
Claude CodeやCodexなどの既存エージェントと比較すると、Pi Coding Agentはハーネス層が薄い点が異なります。拡張前提の設計のため、初期機能は最小限ですが、柔軟性が高いです。
| 項目 | Pi Coding Agent | Claude Code | Codex |
|---|---|---|---|
| ハーネス層 | 薄い (拡張前提) | 厚め | 厚め |
| 拡張性 | TypeScript extension | 限定的 | 限定的 |
| モデル柔軟性 | 高い (複数provider) | 制限あり | 制限あり |
| インストール | npm / シェルスクリプト | 専用クライアント | 専用クライアント |
この表からわかるように、Piはカスタマイズを前提としています。他のツールが提供する豊富な機能に頼るのではなく、必要な部分だけを自分で構築するスタイルです。公式ソースでは、このアプローチが「自分のもの」として強調されています。
まとめと次のステップ
devgent.orgの他のAIツール記事（AI ブラウザ比較 や AI コスト比較ツール）も参考にしてください。
Pi Coding Agentは、AIエージェントを「使う」から「作る」へシフトするための基盤となります。インストールから拡張までの一連の流れを理解すれば、日常の開発作業を効率化できます。
次のステップとして、実際にnpmでインストールし、基本的なファイル操作を試してみてください。その後、TypeScriptで簡単な検索ツールを追加し、自分のワークフローに合わせた拡張を検討すると良いでしょう。公式のGitHubリポジトリやpi.devを参照しながら進めることをおすすめします。
関連記事:
- Ornith-1.0 リリース — 自己改善型オープンソース agentic coding LLM（Ollama対応）
- Transformerの最大475倍、富士通新LLMアーキテクチャ「PHOTON」——GPU効率を劇的に向上
- AIコード生成時代に「人をつくる」重要性 — tebikiの視点から
よくある質問（FAQ）
著者
krona23
IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。
コメントを残す