Macの開発サーバ、ポート、Docker、ビルドフォルダを管理

「開発とエージェント」画面に表示される内容

サイドバーのこのMacの下にある開発とエージェントを開くか、移動 › 開発とエージェントを選びます。サブタイトルに動作方針が示されています：自分のプロセスのみ · 確認なしに停止することはありません。対象はあなたとして実行されているプロセスだけで、ほかのユーザやmacOS自体のプロセスは見ません。

上部の4つのタイルには、エージェントセッション、開発サーバ、アイドル状態のサーバ、使用中のメモリ（エージェントとサーバの合計。エージェントが起動したサーバを二重に数えることはありません）の数値が表示されます。その下には4つのタブがあります：

画面を開いている間、リストは3秒ごとに更新され、画面を離れると停止します。ツールバーの更新ボタンを押すと、すぐにすべてを読み込み直します。このページでは最後の3つのタブについて説明します。

開発サーバの検出とプロジェクトごとのグループ分け

開発サーバとは、TCPポートで待ち受けている自分のプロセスのうち、既知のランタイムであるもの、またはプロジェクトフォルダ内で実行されていてアプリの一部ではないものを指します。認識できるランタイムには、node、bun、deno、python、ruby、java、php、dotnet、go、vite、esbuild、uvicorn、gunicorn、puma、rails、hugo、caddy、nginx、httpd、streamlit、Jupyter、ollamaと、データベースのpostgres、redis-server、mysqld、mongodがあります。

各サーバは、それが実行されているプロジェクトの下に表示されます。プロジェクトとは、ホームフォルダ内で最も近い、package.json、.git、pyproject.toml、requirements.txt、Cargo.toml、go.mod、Gemfile、composer.json、pom.xml、build.gradle、Package.swift、deno.json、pubspec.yaml、mix.exs、Podfileなどのプロジェクトファイルがあるフォルダです。HomebrewのPostgresはどのプロジェクトの外でも実行されるので、プロジェクト外の下に表示されます。

サーバの行の見方

• :3000のようなポートのチップ。クリックすると、ブラウザでhttp://localhost:3000が開きます。
• データベースは、Postgres、Redis、MySQL、MongoDBに付きます。
• ネットワークに公開（オレンジ）は、すべてのインターフェイスで待ち受けていることを示します。このMacだけでなく、同じWi-Fi上のほかのデバイスからもアクセスできます。
• アイドル 3時間（オレンジ）は、その時間CPUを使わず、接続もなかったことを示します（下記参照）。
• node next dev -p 3000のようなコマンドに続いて、ターミナルからまたはCursorから（起動したアプリ）、稼働時間、開いている接続の数が表示されます。
• 右側にメモリとCPU、続いて停止…。

Macでポートを使用しているものを調べる方法

開発サーバの上部にある検索フィールド（ポート上のもの…（3000、8080）または名前）に入力します。数字はその数字で始まるポートに一致し（80で8000と8080が見つかります）、単語はコマンドに一致します（astro、uvicorn）。一般的な背景と、ターミナルでlsofを使う方法については、ガイドMacでポートを使っているのは？をご覧ください。

開発ツールではなく、アプリやmacOSのサービスが占有しているポートは、下部のポートで待ち受け中のほかのApp（N）にまとめられます。展開すると、各アプリとそのポートが表示されます。たとえばAirPlayレシーバーは5000番と7000番で待ち受けるため、5000番ポートのFlaskアプリが起動できないことがあります。これらはここから停止できません。ポートを解放するには、そのアプリを終了してください（またはシステム設定でAirPlayレシーバーをオフにします）。

アイドル状態のサーバと、サーバを安全に停止する方法

OneMacToolsが監視している間に、CPUをほとんど使わず、開いている接続もない状態が15分以上続いたサーバは、アイドル状態とみなされます。アイドル状態のサーバタイルにその数が表示され、それぞれに経過時間付きのアイドルチップが付きます。3日前に起動してそのまま忘れていたAstroのドキュメントサイトなどが典型的な例です。

サーバを停止

1. 行の停止…をクリックします。
2. 確認画面を読みます。例：ポート4321のnodeを停止しますか？と298 MBとポートを解放します。必要なときにプロジェクトから再度起動してください。
3. 停止をクリックします。停止したプロセスの数が緑色の行で表示され、1秒後に一覧が更新されます。

停止はプロセスに終了を依頼するもので、Ctrl-Cが送るのと同じ穏やかなシグナルを使うため、サーバは正常に終了できます。OneMacToolsが停止するのは自分のプロセスだけで、そのプロセスIDが一覧に表示したのと同じプログラムのものであることを再確認するため、再利用されたプロセスIDを誤って停止することはありません。

暴走プロセスのアラート

この画面を閉じていても、OneMacToolsは30秒ごとに開発プロセスを確認し、1つのプロセスが10分間1コアを使い切ったとき、1時間で1 GB増えたとき、またはポート上で1日アイドル状態が続いたときに、停止ボタン付きの通知を送ります。rustc、clang、tsc、webpackのようなコンパイラは負荷が高いのが当然なので対象外です。設定の暴走プロセスでは、この機能をオフにしたり、OneMacToolsに自動で停止させたりできます：CPUを使い切ったままのプロセスを停止（15分後、30分後、1時間後）と誰も使っていない開発サーバを停止（1日後、3日後、7日後）。どちらもデフォルトはしないです。設定のリファレンスを参照してください。

Docker、Colima、OrbStack

Dockerタブは、Docker Desktop、Colima、OrbStackで動作します。表示内容は状態によって異なります：

• Dockerがインストールされていません：3つのいずれもこのMacにありません。
• Dockerが実行されていません：停止中でも仮想マシンが使っているディスク容量を表示します。Docker Desktopを開くまたはColimaを起動で起動できます（Colimaはcolima startを実行するので、1分ほどかかることがあります）。Colimaには“colima delete”をコピーもあります。もう使わず容量を取り戻したい場合に、ターミナルに貼り付けて使います。
• 実行中：Dockerが使用している領域とコンテナ。

Dockerが使用している領域

イメージ、コンテナ、ローカルボリューム、ビルドキャッシュがそれぞれ1行で表示され、数、サイズ、解放できる容量がわかります。クリーンアップ…は、実行前に何をするかを説明します：

コンテナには、各コンテナのイメージ、状態、ポート、メモリ、CPUと、あればComposeプロジェクトが表示されます。実行中のコンテナには停止…（データは残ります）、停止中のコンテナには開始と削除…（ボリュームは残ります）があります。OrbStackがインストールされている場合は、OrbStackのマシンにLinuxマシンが表示され、開始と停止…を使えます。

古いnode_modulesとビルドフォルダを消去

JavaScriptのプロジェクトには、数百MBにもなるnode_modulesがあり、Rust、Python、Flutterのプロジェクトにも同様のものがあります。プロジェクトファイルはホームフォルダをたどり（6階層まで。ライブラリ、アプリケーション、メディアのフォルダ、ツール自身の非表示フォルダは除外）、ビルドフォルダをプロジェクトごとに大きい順に一覧表示します。

フォルダが表示されるのは、それを再作成するファイルが隣にある場合だけです。そのため、たまたまbuildやtargetという名前のフォルダに手が加えられることはありません：

各プロジェクトには、自分のファイルとGitの履歴から判断した最終変更日時が表示されます。30日間変更のないプロジェクトには自動でチェックが入り、日付がオレンジ色になります。虫めがねをクリックすると、Finderでフォルダが表示されます。

1. これから作業する予定のものはチェックを外してください。
2. N件をゴミ箱に入れる…をクリックして確定します。ダイアログに解放される容量が表示されます。
3. 次にそのプロジェクトで作業するときに、パッケージマネージャやビルドがフォルダを再作成します。ゴミ箱を空にするまでは、履歴から戻すことができます。

一般的な方法はガイドMacでnode_modulesを削除するで説明しています。プロジェクトファイルは、それをクリック操作だけで行えるようにしたものです。Mac全体の容量についてはMacクリーンアップをご覧ください。

AIアシスタントから使う

同じ情報は、OneMacToolsのMCPサーバを通じて、Claude、Cursor、Codexなどのアシスタントからも利用できます。ポートを使っているもの、プロジェクトごとの開発サーバ、Dockerの状態、古いプロジェクトファイルです。アシスタントは作業の途中で「ポート3000を使っているのは？」と尋ね、ここに表示されるのと同じ答えを得られます。ただし、何かを停止するには必ずあなたの承認が必要です（承認のしくみ）。

質問

関連ドキュメント