Persistproc

🚀 persistproc

マルチエージェント開発ワークフロー用の共有プロセスレイヤー

詳細ドキュメント: steveasleep.com/persistproc

🚀 クイックスタート

🔍 persistproc とは何ですか？

Persistprocは、MCPサーバーおよびコマンドラインツールで、エージェントや人間がWebサーバーなどの長時間実行されるプロセスを表示および制御できるようにします。その目的は、AIを使ってコーディングする際に必要なコピー＆ペーストの量を減らし、複数のエージェントを使いやすくし、ツールに依存しないようにすることです。

設定ファイルはありません。プロセスはすべて実行時に管理されます。これは、supervisordの代替ではありません。

🌟 利用例：基本的なWeb開発

TODOリストアプリを開発しているとしましょう。通常は npm run dev で開発サーバーを起動します。このサーバーはコードの変更を監視し、型チェック、リントを行い、ページをホットリロードします。エラーが発生すると、エラーがターミナルに表示されます。

CursorやClaude CodeなどのLLMエージェントを使用している場合、エラーが表示されたら、ターミナルからエラーをコピー＆ペーストしてエージェントに修正方法を尋ねることがあります。そして、エージェントがいくつかの変更を加え、別のエラーに遭遇すると、もう一度コピー＆ペーストし、エージェントがさらに変更を加える…というサイクルが繰り返されます。

エージェントが直接変更を見ることができれば、何もする必要はありません！persistprocを使用すると、それが可能です。npm run dev の代わりに persistproc npm run dev と入力すると、エージェントはその出力を即座に読み取ったり、再起動したりすることができます。それ以外の場合は、通常どおりターミナルで出力を見ることができ、Ctrl+Cでプロセスを終了することもできます。

graph TB
    User[User] -->|"persistproc npm run dev"| PP[persistproc server]
    PP <-->|"manages / logs"| NPM["npm run dev<br/>(web server)"]
    PP -.->|"streams output"| User
    
    Agent[Cursor] -.->|"output()<br/>restart()"| PP
    
    style PP fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    style NPM fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style User fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    style Agent fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px

⚠️ 重要なメモ

なぜCursorを使ってエージェントにターミナルを開かせないのですか？

1. すべての人がCursor/VSCodeのターミナルを好むわけではありません。エンジニアには様々なワークフローがあります。
2. Cursorのエージェントだけがプロセスを見ることができ、Claude CodeやGemini CLIなどは見ることができません。

🌟 利用例：複雑なWeb開発

ローカルでWebアプリを動作させるために4つのプロセスを実行する必要があるとしましょう。API、フロントエンドサーバー、SCSSビルダー、Postgresなどです。各サービスは独自のログを出力します。

ローカルでテスト中にエラーが発生した場合、4つのログファイルを読んで何が起こったかを調べることができます。

しかし、persistprocでこれらのプロセスを起動した場合、エージェントは一度にすべての情報を読み取り、より迅速な診断を提供する可能性があります。

graph TB
    User[User] -->|"starts processes"| PP[persistproc server]
    
    subgraph processes["Managed Processes"]
        API[API Server]
        FE[Frontend Server]
        SCSS[SCSS Builder]
        DB[Postgres]
    end
    
    PP <-->|"manages / logs"| processes
    
    Agent1[Claude Code] -.->|"read logs<br/>diagnose issues"| PP
    Agent2[Cursor] -.->|"read logs<br/>diagnose issues"| PP
    
    style PP fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    style API fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style FE fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style SCSS fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style DB fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style User fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    style Agent1 fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
    style Agent2 fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
    style processes fill:#f5f5f5,stroke:#999,stroke-width:1px,stroke-dasharray: 5 5

⚠️ 重要なメモ

もしプロセスが別のシステムによって起動されている場合はどうすればいいですか？

その場合は、ログファイルを予測可能な場所に書き込み、エージェントにその場所を教えるのが最善の策です。persistprocを使おうとするよりも、その方が良いでしょう。または、GitHubのこのissue をフォローすることもできます。

現在、persistprocはエージェントがプロセスを 管理 できるようにする場合に最も有用であり、単に出力を見るだけではありません。

✨ 利用可能なツール

persistproc は、http://127.0.0.1:8947 で標準の Model Context Protocol (MCP) サーバーを公開しています。任意のMCP互換クライアントを使用して、プログラムでこのサーバーとやり取りすることができます。

サーバーは以下のツールを公開しています。

このリストは意図的に短くなっています。LLMはツールが多すぎるとパフォーマンスが低下するため、一部のIDE（Cursorなど）では使用できるツールの数に制限があります。

📦 インストール

1. persistproc をインストールする

pip install persistproc

2. サーバーを起動し、エージェントを設定する

専用のターミナルでこれを実行し、実行したままにしておきます。

persistproc serve

persistproc serve が最初に出力するのは、さまざまなエージェントの設定手順です。まだ設定していない場合は、それらの手順に従ってください。

3. プロセスを起動する

別のターミナルで、プロジェクトのディレクトリに移動し、persistproc を介してコマンドを実行します。

# 例: Node.js開発サーバーの起動
cd /path/to/your/project
persistproc npm run dev

コマンドはサーバーに送信され、その出力はターミナルにストリーミングされます。このターミナルを安全に閉じることができ、プロセスは引き続き実行されます。

💡 使用アドバイス

または、エージェントに「persistprocを使って開発サーバーを起動して」と依頼するだけで、おそらく package.json ファイルを見て適切なコマンドを見つけ、persistproc を使って実行します。

これで、エージェントは利用可能なツールを使って開発環境を管理することができます。

💻 使用例

エージェントが接続されたら、プロセスの管理を依頼することができます。persistproc npm run dev でWebサーバーを起動したと仮定します（PID 12345）。これで、サーバーとやり取りすることができます。

• あなた: "実行中のプロセスをリスト表示して。"

  • エージェント: list() を呼び出し、実行中の npm run dev プロセスを表示します。

• あなた: "Webサーバーが固まっているようです。再起動できますか？"

  • エージェント: 正しいプロセスを特定し、ctrl(action="restart", pid=12345) を呼び出します。

• あなた: "Webサーバーからのエラーを表示して。"

  • エージェント: output(pid=12345, stream="stderr") を呼び出して、最新のエラーログを取得します。

🔧 開発

完全に構成された仮想環境で ./pp を使用してpersistprocを実行します。pytest などの他のコマンドは、仮想環境で uv run を使用して実行します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。