Gentleman-Programming/gentle-shell

gentle-shell™ – Pi 開発環境向けのAI駆動型コーディングエージェント

何であるか – gentle-shell（gentle-pi npmパッケージとして配布）は、ターミナルベースのワークスペースであり、大規模言語モデル（LLM）をバックエンドに持つコーディングエージェントをプロジェクト内に実行できるようにします。エージェントはコードベースを探索し、変更を提案し、テストを実行し、差分を提示できます。一方で、アクティブなタスク、セッションの変更、実行時ステータスを表示するUIにより、あなたは常にコントロールを保持できます。

コアコンセプト

• ワークスペース中心 – シェルは1つのパネル（/gentle:… コマンド）を提供し、エージェントの作業、サブエージェント、およびタスクリストを統合します。これにより、ターミナルから離れることなく作業を進められます。
• 集中型エージェント – 親セッションは制限付きの「ワーカー」エージェント（例：リポジトリのマッピング、変更の実装、検証）を生成でき、簡潔な承認と証拠を受信できます。
• 有機的駆動開発（ODD） – デフォルトのワークフローは、軽量で段階的な作業を促進します：望ましい結果を記述し、エージェントに行動させ、具体的な変更をレビューします。より形式的な 仕様駆動開発（SDD） フローは、大規模でフェーズ制御されたタスクにオプションで利用可能です。
• ネイティブレビュー – どの変更も適用される前に、エージェントは承認・拒否・修正要求が可能な「凍結された差分候補」を提示します。これにより、人間が常にループに参加できます。
• 拡張可能な「コンパニオン」 – オプションパッケージ（gentle-engram、pi-intercom など）により、永続的メモリ、セッション間メッセージング、Webアクセスなどの機能を追加できますが、必須ではありません。

導入方法

# 最新安定版（執筆時点では v2.6.0）をインストール
pi install npm:gentle-pi@2.6.0

# Pi を再起動し、アセットを同期
gentle-ai sync

# プロジェクト内で Pi REPL を起動 – gentle-shell UI が表示される
pi

その後、/gentle:status、/gentle:doctor、/gentle:review-mode enable などの組み込みコマンドを使って、エージェントの状態を確認したり、問題を診断したり、オプションのレビューモードを有効化できます。

主要ドキュメント

• ワークスペースレイアウト – docs/gentle-shell.md では、パネル、/gentle:changes ビュー、UIのナビゲーション方法について説明しています。
• ODD ワークフロー – docs/readme-reference.md#organic-driven-development では、日常的な「意図 → 結果」のループをステップバイステップで解説しています。
• SDD/OpenSpec フロー – オプションの形式的フェーズは、同じリファレンスの SDD/OpenSpec セクションに記載されています。
• レビュー統合 – docs/review-integration.md では、エージェントが具体的な差分を人間の承認に渡す境界について詳細に説明しています。
• ネイティブ権限アーキテクチャ – docs/native-authority-architecture.md では、破壊的操作における所有権とセキュリティ境界を明確にしています。

コミュニティとサポート

• 問題と機能要望： https://github.com/Gentleman-Programming/gentle-pi/issues
• 実時間サポートの Discord チャット： https://discord.com/invite/gentleman-programming-769863833996754944
• コントリビューターはリポジトリのコントリビューター図にリストされ、contrib.rocks バッジで可視化されています。

ライセンス – MIT（LICENSE を参照）。プロジェクトの商標（gentle-shell™、gentle-pi™）は著者、Alan Buscaglia に帰属します。

---

gentle-shell は本物のオープンソースツールであり、LLM駆動のコーディングアシスタントを開発者のターミナルに直接導入し、小さな修正から形式的に仕様された大規模な変更まで、構造的かつ柔軟なワークフローを提供します。