@nogataka/smart-edit 1.0.2 → 1.0.4

package/README.md

@@ -94,21 +94,104 @@ Smart Edit は、AI の振る舞いをカスタマイズするための柔軟な
 | **Statistics** | API 呼び出し統計、トークン使用量チャート、ライブカウンター             |
 | **Sessions**   | セッション履歴、JSON エクスポート、過去セッション比較                  |
 
-- `--enable-web-dashboard` オプションで有効化
+- `npx @nogataka/smart-edit start-dashboard` で統合ダッシュボードを起動
+- 複数プロジェクトをサイドバーで切り替え管理
 - ダークモード / ライトモード切替対応
-- モバイルレスポンシブ対応
 
 ## ワークフローツール
 
 AI エージェントの作業効率を高めるためのワークフロー支援ツールを提供します。
 
-| ツール                     | 説明                                                   |
-| -------------------------- | ------------------------------------------------------ |
-| `Onboarding`               | プロジェクト初回参加時のオンボーディングプロセスを支援 |
-| `CheckOnboardingPerformed` | オンボーディングが完了しているか確認                   |
+| ツール                      | 説明                                                     |
+| --------------------------- | -------------------------------------------------------- |
+| `Onboarding`                | プロジェクト初回参加時のオンボーディングプロセスを支援   |
+| `CheckOnboardingPerformed`  | オンボーディング完了確認 + Git 差分による変更検出        |
+| `CollectProjectSymbols`     | プロジェクトシンボル（ユーティリティ、依存関係等）を収集 |
 
 オンボーディングでは、プロジェクトの構造理解、コーディング規約の確認、既存メモリの参照などを AI エージェントに案内します。
 
+### アクティブ化とオンボーディングの違い
+
+Smart Edit では「**アクティブ化**」と「**オンボーディング**」は別の概念です。
+
+| 項目 | アクティブ化 (Activation) | オンボーディング (Onboarding) |
+|------|---------------------------|-------------------------------|
+| **目的** | プロジェクトを Smart Edit に登録 | AI がプロジェクトを理解する |
+| **実行タイミング** | 最初の1回（自動または手動） | セッション開始時に推奨 |
+| **結果** | `.smart-edit` ディレクトリ作成、ツールが利用可能に | メモリに情報を保存 |
+| **ツール** | `activate_project` | `onboarding`, `check_onboarding_performed` |
+| **必須か** | **必須**（プロジェクト操作に必要） | 任意（推奨） |
+
+**処理の流れ:**
+
+```
+1. プロジェクトのアクティブ化
+   → activate_project ツール / --project オプション
+   → .smart-edit ディレクトリ作成
+   → ツールが利用可能になる
+       ↓
+2. オンボーディング（任意だが推奨）
+   → check_onboarding_performed → onboarding ツール
+   → AI がプロジェクト構造を学習
+   → メモリに情報を保存（project-symbols など）
+       ↓
+3. 実際の作業
+   → ファイル編集、シンボル検索など
+```
+
+- **アクティブ化**は技術的な準備段階（プロジェクトパスの認識、`.smart-edit` ディレクトリ作成、言語サーバー初期化）
+- **オンボーディング**は AI の学習プロセス（プロジェクト構造把握、既存コード・ライブラリの確認、メモリへの保存）
+
+アクティブ化なしではオンボーディングはできませんが、オンボーディングなしでもアクティブ化されたプロジェクトで作業は可能です。
+
+## 重複定義チェック機能
+
+AI エージェントが既存のコードや依存ライブラリと重複する実装を作成することを防ぐための機能です。
+
+### 概要
+
+| 機能 | 説明 |
+|------|------|
+| **careful-editor モード** | 既存コードを尊重し、重複実装を防ぐ動作モード |
+| **プロジェクトシンボル収集** | ユーティリティ関数、共通コンポーネント、依存ライブラリを記録 |
+| **Git 差分検出** | 前回オンボーディング以降の大きな変更を自動検出し、再オンボーディングを推奨 |
+
+### 動作の流れ
+
+```
+1. オンボーディング時にプロジェクト構成を収集
+   → CollectProjectSymbols ツールで project-symbols メモリに保存
+       ↓
+2. 次回セッション開始時
+   → CheckOnboardingPerformed が Git 差分をチェック
+       ↓
+3. 大きな変更がある場合
+   → 「再オンボーディング推奨」メッセージを表示
+       ↓
+4. careful-editor モードで実装
+   → 既存のユーティリティ/ライブラリを優先利用
+```
+
+### careful-editor モードの使用
+
+```bash
+npx @nogataka/smart-edit start-mcp-server \
+  --mode careful-editor \
+  --transport stdio
+```
+
+このモードでは、AI エージェントは実装前に以下を確認します：
+- `project-symbols` メモリから既存のユーティリティ関数一覧
+- `package.json` の依存ライブラリとその用途
+- 類似機能の有無を `find_symbol` ツールで検索
+
+### 変更検出の基準
+
+以下の条件で「大きな変更」と判定されます：
+- 10 ファイル以上の変更
+- 5 ファイル以上の新規追加
+- `src/` ディレクトリへの新規ファイル追加
+
 ## 主な構成
 
 | ディレクトリ / ファイル    | 概要                                                        |
@@ -155,7 +238,7 @@ CLI は npm パッケージとして公開されており、`npx` または `nod
 
 ```bash
 # npm パッケージを利用する場合（推奨）
-npx @nogataka/smart-edit smart-edit <command>
+npx @nogataka/smart-edit <command>
 
 # ローカル開発時
 node dist/cli.js <command>
@@ -167,28 +250,28 @@ pnpm exec tsx src/smart-edit/cli.ts <command>
 
 1. **smart-edit 管理ディレクトリの生成**
    ```bash
-   npx @nogataka/smart-edit smart-edit config edit
+   npx @nogataka/smart-edit config edit
    ```
    初回実行時は `~/.smart-edit/smart_edit_config.yml` をテンプレートから生成し、既定エディタで開きます。
 
 2. **プロジェクト設定 (project.yml) の生成**
    ```bash
-   npx @nogataka/smart-edit smart-edit project generate-yml /path/to/project
+   npx @nogataka/smart-edit project generate-yml /path/to/project
    ```
    言語を手動指定したい場合は `--language <lang>` を付与します。生成された YAML をプロジェクトルートに配置してください。
 
 3. **モード / コンテキストの確認とカスタマイズ**
    ```bash
    # 一覧表示
-   npx @nogataka/smart-edit smart-edit mode list
-   npx @nogataka/smart-edit smart-edit context list
+   npx @nogataka/smart-edit mode list
+   npx @nogataka/smart-edit context list
 
    # テンプレートからコピー
-   npx @nogataka/smart-edit smart-edit mode create --from-internal default-editor
+   npx @nogataka/smart-edit mode create --from-internal default-editor
 
    # 編集 / 削除
-   npx @nogataka/smart-edit smart-edit mode edit <name>
-   npx @nogataka/smart-edit smart-edit context delete <name>
+   npx @nogataka/smart-edit mode edit <name>
+   npx @nogataka/smart-edit context delete <name>
    ```
 
 4. **プロンプトテンプレートの更新**
@@ -197,7 +280,7 @@ pnpm exec tsx src/smart-edit/cli.ts <command>
 ### 2. MCP サーバーの起動
 
 ```bash
-npx @nogataka/smart-edit smart-edit start-mcp-server \
+npx @nogataka/smart-edit start-mcp-server \
   --project /path/to/project \
   --context ide-assistant \
   --mode default-editor \
@@ -206,34 +289,59 @@ npx @nogataka/smart-edit smart-edit start-mcp-server \
 
 ランタイムの自動インストールをスキップする場合は環境変数を設定します：
 ```bash
-SMART_EDIT_SKIP_RUNTIME_INSTALL=1 npx @nogataka/smart-edit smart-edit start-mcp-server ...
+SMART_EDIT_SKIP_RUNTIME_INSTALL=1 npx @nogataka/smart-edit start-mcp-server ...
 ```
 
 主なオプション:
 
-- `--transport`: `stdio` (既定) / `sse` / `streamable-http` から選択
-- `--enable-web-dashboard`, `--enable-gui-log-window`: Config の設定を一時的に上書き
-- `--log-level`, `--trace-lsp-communication`: ログ詳細度や LSP トレースの制御
-- `--tool-timeout`: ツール実行のタイムアウト秒数
-- `--instructions-override`: MCP クライアントに渡す初期インストラクションをカスタム指定
+| オプション | 説明 |
+|------------|------|
+| `--project <path>` | アクティブ化するプロジェクトパス（省略時はカレントディレクトリ） |
+| `--no-project` | プロジェクトなしで起動（後から `activate_project` で指定） |
+| `--transport` | `stdio`（既定）/ `sse` / `streamable-http` |
+| `--log-level` | ログレベル（DEBUG / INFO / WARNING / ERROR） |
+| `--tool-timeout <秒>` | ツール実行のタイムアウト |
+| `--instructions-override` | MCP クライアントへの初期インストラクション |
 
-サーバー起動後は、必要に応じてダッシュボード (`--enable-web-dashboard`) や GUI ログビューア (`--enable-gui-log-window`) を利用できます。GUI ログは `GuiLogViewer` 経由でブラウザが自動起動し、`logs/` ディレクトリにも出力されます。
+#### Web ダッシュボード
 
-#### Web ダッシュボード機能
+Smart Edit は統合ダッシュボードを提供し、複数プロジェクトのモニタリングと管理を一元化できます。
 
-ダッシュボードは以下の機能を提供します：
+```bash
+# 統合ダッシュボードを起動
+npx @nogataka/smart-edit start-dashboard
+```
 
-| タブ       | 機能                                                                   |
-| ---------- | ---------------------------------------------------------------------- |
-| Dashboard  | プロジェクト概要、リアルタイムメトリクス、最近のアクティビティ         |
-| Logs       | ログ検索・フィルタ（レベル別、ツール名別）、リアルタイムストリーミング |
-| Statistics | API 呼び出し統計、トークン使用量チャート、ライブカウンター             |
-| Sessions   | セッション履歴、JSON エクスポート、過去セッション比較                  |
+ダッシュボードは MCP サーバーとは独立して動作します。複数の MCP サーバーを起動していても、1つのダッシュボードですべてのプロジェクトを管理できます。
 
-- ダークモード / ライトモード切替対応
-- サイドバーナビゲーション（折りたたみ可能）
+```bash
+# 例: 複数プロジェクトの同時利用
+npx @nogataka/smart-edit start-dashboard                                           # ダッシュボード起動
+npx @nogataka/smart-edit start-mcp-server --project ~/projects/app-a               # プロジェクトA
+npx @nogataka/smart-edit start-mcp-server --project ~/projects/app-b               # プロジェクトB
+```
+
+**ダッシュボード機能:**
+
+| タブ | 機能 |
+|------|------|
+| Dashboard | プロジェクト概要、リアルタイムメトリクス |
+| Logs | ログ検索・フィルタ、リアルタイムストリーミング |
+| Statistics | ツール呼び出し統計、トークン使用量チャート |
+| Sessions | セッション履歴、JSON エクスポート |
+
+**特徴:**
+- サイドバーで複数プロジェクトを切り替え
+- MCP サーバー終了後もダッシュボードは継続動作
+- ダークモード / ライトモード切替
 - モバイルレスポンシブ対応
 
+**ダッシュボードオプション:**
+
+| オプション | 説明 |
+|------------|------|
+| `--port <port>` | ダッシュボードのポート番号（デフォルト: 24282） |
+
 #### MCP クライアント（Codex など）からの接続例
 
 `npx` で公開パッケージを取得する場合、`mcp_servers.toml` の設定キーを `smart-edit` に合わせてください。
@@ -241,7 +349,7 @@ SMART_EDIT_SKIP_RUNTIME_INSTALL=1 npx @nogataka/smart-edit smart-edit start-mcp-
 ```toml
 [mcp_servers.smart-edit]
 command = "npx"
-args = ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--context", "codex", "--transport", "stdio"]
+args = ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--context", "codex", "--transport", "stdio"]
 ```
 
 CLI 側の `--context` や `--mode` は必要に応じて追加してください。`smart-edit` コマンドは `package.json` の `bin.smart-edit` で `./dist/cli.js` にマッピングされています。
@@ -250,13 +358,13 @@ CLI 側の `--context` や `--mode` は必要に応じて追加してくださ
 
 ```bash
 # プロジェクト設定 YAML の生成
-npx @nogataka/smart-edit smart-edit project generate-yml /path/to/project
+npx @nogataka/smart-edit project generate-yml /path/to/project
 
 # 有効化されているツールを確認
-npx @nogataka/smart-edit smart-edit tools list
+npx @nogataka/smart-edit tools list
 
 # ツールごとの説明を表示
-npx @nogataka/smart-edit smart-edit tools list
+npx @nogataka/smart-edit tools list
 ```
 
 ### 4. メモリ機能
@@ -342,20 +450,48 @@ Smart Edit は MCP (Model Context Protocol) サーバーとして動作し、様
 
 ### `--project` オプションについて
 
-**`--project` は省略可能です。** MCP サーバー起動時にプロジェクトを指定しなくても、以下の方法でプロジェクトをアクティブ化できます：
+**デフォルトでカレントディレクトリがプロジェクトとして自動アクティブ化されます。** `--project` を明示的に指定した場合はそのパスが使用されます。
 
-1. **チャットから指示**: 「現在のディレクトリをプロジェクトとしてアクティブ化して」と依頼
-2. **`activate_project` ツール**: MCP 経由で `activate_project` ツールを呼び出し
+| 指定方法 | 動作 |
+|----------|------|
+| オプションなし | カレントディレクトリを自動アクティブ化 |
+| `--project /path/to/project` | 指定したパスをアクティブ化 |
+| `--no-project` | プロジェクトなしで起動（後から `activate_project` で指定可能） |
 
 ```bash
-# --project なし（推奨: 柔軟に複数プロジェクトを切り替え可能）
-npx @nogataka/smart-edit smart-edit start-mcp-server --transport stdio
+# オプションなし（カレントディレクトリを自動使用）
+npx @nogataka/smart-edit start-mcp-server --transport stdio
 
-# --project あり（特定プロジェクトに固定する場合）
-npx @nogataka/smart-edit smart-edit start-mcp-server --project /path/to/project --transport stdio
+# --project あり（特定プロジェクトを指定）
+npx @nogataka/smart-edit start-mcp-server --project /path/to/project --transport stdio
+
+# --no-project（プロジェクトなしで起動、後から指定）
+npx @nogataka/smart-edit start-mcp-server --no-project --transport stdio
 ```
 
-以下の各クライアント設定例では `--project` を省略していますが、必要に応じて追加できます。
+#### `--no-project` で起動した場合の使い方
+
+`--no-project` を指定した場合、最初にプロジェクトをアクティブ化する必要があります。以下のようにチャットで AI に依頼してください：
+
+**プロンプト例:**
+```
+現在のディレクトリをプロジェクトとしてアクティブ化して
+```
+
+```
+/path/to/my-project をアクティブ化して
+```
+
+```
+smart-edit で現在のプロジェクトを登録して
+```
+
+AI が `activate_project` ツールを呼び出し、以下が実行されます：
+- `.smart-edit` ディレクトリの作成
+- 言語サーバーの初期化
+- プロジェクト固有のツールが利用可能に
+
+以下の各クライアント設定例ではデフォルト動作（カレントディレクトリ自動使用）を利用していますが、必要に応じて `--project` や `--no-project` を追加できます。
 
 ---
 
@@ -381,16 +517,16 @@ Claude Code ではプロジェクトごとに MCP サーバーを追加します
 
 ```bash
 # プロジェクトのルートディレクトリで実行
-claude mcp add smart-edit -- npx -y @nogataka/smart-edit@latest smart-edit start-mcp-server --transport stdio
+claude mcp add smart-edit -- npx -y @nogataka/smart-edit@latest start-mcp-server --transport stdio
 ```
 
 **オプション付きの例:**
 ```bash
 # プロジェクトを指定する場合
-claude mcp add smart-edit -- npx -y @nogataka/smart-edit@latest smart-edit start-mcp-server --project "$(pwd)" --transport stdio
+claude mcp add smart-edit -- npx -y @nogataka/smart-edit@latest start-mcp-server --project "$(pwd)" --transport stdio
 
 # コンテキストを指定する場合
-claude mcp add smart-edit -- npx -y @nogataka/smart-edit@latest smart-edit start-mcp-server --context ide-assistant --transport stdio
+claude mcp add smart-edit -- npx -y @nogataka/smart-edit@latest start-mcp-server --context ide-assistant --transport stdio
 ```
 
 **管理コマンド:**
@@ -408,7 +544,7 @@ claude mcp remove smart-edit # サーバー削除
 ```toml
 [mcp_servers.smart-edit]
 command = "npx"
-args = ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--context", "codex", "--transport", "stdio"]
+args = ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--context", "codex", "--transport", "stdio"]
 ```
 
 **使用方法:**
@@ -416,7 +552,7 @@ args = ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "
 2. プロジェクトをアクティブ化するとツールが利用可能に
 
 > **Note**:
-> - `--project` を追加すれば起動時にプロジェクトを指定できます（上記「`--project` オプションについて」を参照）
+> - デフォルトではカレントディレクトリが自動的にプロジェクトとして使用されます（上記「`--project` オプションについて」を参照）
 > - Codex の UI でツール実行が `failed` と表示されても、実際には成功していることがあります。ログ (`~/.codex/log/codex-tui.log`) で確認してください。
 
 ---
@@ -430,13 +566,13 @@ Cursor では `~/.cursor/mcp.json` (または Settings → MCP) で設定しま
   "mcpServers": {
     "smart-edit": {
       "command": "npx",
-      "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--transport", "stdio"]
+      "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--transport", "stdio"]
     }
   }
 }
 ```
 
-> `--project` を追加する場合: `args` に `"--project", "/path/to/project"` を追加
+> デフォルトでカレントディレクトリが使用されます。特定パスを指定する場合: `args` に `"--project", "/path/to/project"` を追加
 
 ---
 
@@ -449,13 +585,13 @@ Windsurf では `~/.codeium/windsurf/mcp_config.json` で設定します。
   "mcpServers": {
     "smart-edit": {
       "command": "npx",
-      "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--transport", "stdio"]
+      "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--transport", "stdio"]
     }
   }
 }
 ```
 
-> `--project` を追加する場合: `args` に `"--project", "/path/to/project"` を追加
+> デフォルトでカレントディレクトリが使用されます。特定パスを指定する場合: `args` に `"--project", "/path/to/project"` を追加
 
 ---
 
@@ -471,7 +607,7 @@ Continue では `~/.continue/config.json` の `experimental.modelContextProtocol
         "transport": {
           "type": "stdio",
           "command": "npx",
-          "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--transport", "stdio"]
+          "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--transport", "stdio"]
         }
       }
     ]
@@ -479,7 +615,7 @@ Continue では `~/.continue/config.json` の `experimental.modelContextProtocol
 }
 ```
 
-> `--project` を追加する場合: `args` に `"--project", "/path/to/project"` を追加
+> デフォルトでカレントディレクトリが使用されます。特定パスを指定する場合: `args` に `"--project", "/path/to/project"` を追加
 
 ---
 
@@ -492,13 +628,13 @@ Cline では VS Code の設定 (`settings.json`) または Cline の MCP 設定
   "cline.mcpServers": {
     "smart-edit": {
       "command": "npx",
-      "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--transport", "stdio"]
+      "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--transport", "stdio"]
     }
   }
 }
 ```
 
-> `--project` を追加する場合: `args` に `"--project", "/path/to/project"` を追加
+> デフォルトでカレントディレクトリが使用されます。特定パスを指定する場合: `args` に `"--project", "/path/to/project"` を追加
 
 ---
 
@@ -512,14 +648,14 @@ Zed では `~/.config/zed/settings.json` の `context_servers` に追加しま
     "smart-edit": {
       "command": {
         "path": "npx",
-        "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--transport", "stdio"]
+        "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--transport", "stdio"]
       }
     }
   }
 }
 ```
 
-> `--project` を追加する場合: `args` に `"--project", "/path/to/project"` を追加
+> デフォルトでカレントディレクトリが使用されます。特定パスを指定する場合: `args` に `"--project", "/path/to/project"` を追加
 
 ---
 
@@ -536,13 +672,13 @@ GitHub Copilot は VS Code 1.102 以降で MCP を公式サポートしていま
   "servers": {
     "smart-edit": {
       "command": "npx",
-      "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--transport", "stdio"]
+      "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--transport", "stdio"]
     }
   }
 }
 ```
 
-> `--project` を追加する場合: `args` に `"--project", "/path/to/project"` を追加
+> デフォルトでカレントディレクトリが使用されます。特定パスを指定する場合: `args` に `"--project", "/path/to/project"` を追加
 
 #### JetBrains IDE での設定
 
@@ -564,7 +700,7 @@ Claude Desktop (Windows/macOS) では `claude_desktop_config.json` に MCP サ
     "mcpServers": {
       "smart-edit": {
         "command": "npx",
-        "args": ["-y", "@nogataka/smart-edit@latest", "smart-edit", "start-mcp-server", "--context", "desktop-app", "--transport", "stdio"]
+        "args": ["-y", "@nogataka/smart-edit@latest", "start-mcp-server", "--context", "desktop-app", "--transport", "stdio"]
       }
     }
   }
@@ -582,7 +718,7 @@ Claude Desktop (Windows/macOS) では `claude_desktop_config.json` に MCP サ
   }
   ```
   - `dist/cli.js` を呼び出す前に `pnpm build` を実行し、`dist/` に成果物を生成しておいてください。
-  - `--project` は省略可能です（上記「`--project` オプションについて」を参照）。
+  - デフォルトでカレントディレクトリが使用されます。`--no-project` を指定するとプロジェクトなしで起動できます。
 
 - **Docker イメージを使う場合（PoC）**
   ```json
@@ -594,7 +730,7 @@ Claude Desktop (Windows/macOS) では `claude_desktop_config.json` に MCP サ
           "run", "--rm", "-i",
           "-v", "/path/to/your/projects:/workspace/projects",
           "ghcr.io/nogataka/smart-edit:latest",
-          "smart-edit", "start-mcp-server", "--context", "desktop-app", "--transport", "stdio"
+          "start-mcp-server", "--context", "desktop-app", "--transport", "stdio"
         ]
       }
     }
@@ -606,7 +742,7 @@ Claude Desktop (Windows/macOS) では `claude_desktop_config.json` に MCP サ
 - Windows でパスを指定する場合はバックスラッシュを二重にする (`\\`) か、スラッシュ (`/`) を利用してください。
 - 設定を保存したら Claude Desktop を完全終了（システムトレイのアイコンも終了）し、再起動すると smart-edit のツールが利用可能になります。
 - `desktop-app` コンテキストは Claude Desktop 向けにチューニングされています。必要に応じて `~/.smart-edit/contexts/` 配下に自作コンテキストを配置し、`--context` で差し替え可能です。
-- ダッシュボードを利用したい場合は Config 側で `web_dashboard: true` を有効にしてください。ブラウザが自動起動しない場合は `http://localhost:24282/dashboard/index.html` へアクセスできます。
+- ダッシュボードを利用したい場合は別ターミナルで `npx @nogataka/smart-edit start-dashboard` を実行してください。ブラウザで `http://localhost:24282/dashboard/` にアクセスすると統合ダッシュボードが表示されます。
 - MCP サーバーを終了するにはチャットを閉じるだけでなく、別コンソールから `smart-edit` プロセスを停止するか、CLI のログを確認しながら Ctrl+C で停止してください。
 
 Claude Desktop の MCP 設定については [公式クイックスタート](https://modelcontextprotocol.io/quickstart/user) も参考になります。

package/dist/smart-edit/cli.js

@@ -9,6 +9,7 @@ import { ProjectConfig, SmartEditConfig, SmartEditPaths } from './config/smart_e
 import { createSmartEditLogger, setConsoleLoggingEnabled } from './util/logging.js';
 import { SmartEditAgent } from './agent.js';
 import { SmartEditMCPFactorySingleProcess, createSmartEditHttpServer, createSmartEditStdioServer } from './mcp.js';
+import { DEFAULT_DASHBOARD_PORT, registerInstance, unregisterInstance, findAvailablePort } from './instance-registry.js';
 import { ToolRegistry } from './tools/tools_base.js';
 import { coerceLanguage } from '../smart-lsp/ls_config.js';
 import { ensureDefaultSubprocessOptions } from '../smart-lsp/util/subprocess_util.js';
@@ -96,8 +97,25 @@ function normalizeStartMcpServerOptions(raw) {
         }
         return undefined;
     };
+    // プロジェクトの決定ロジック:
+    // 1. --no-project が指定された場合: null（プロジェクトなしで起動）
+    // 2. --project が指定された場合: 指定されたパス
+    // 3. --project-file が指定された場合: 指定されたパス（後方互換）
+    // 4. どれも指定されていない場合: カレントディレクトリを使用
+    const resolveProject = () => {
+        if (raw.noProject === true) {
+            return null;
+        }
+        if (isNonEmptyString(raw.project)) {
+            return raw.project;
+        }
+        if (isNonEmptyString(raw.projectFile)) {
+            return raw.projectFile;
+        }
+        return process.cwd();
+    };
     return {
-        project: isNonEmptyString(raw.project) ? raw.project : null,
+        project: resolveProject(),
         projectFile: isNonEmptyString(raw.projectFile) ? raw.projectFile : null,
         context,
         modes: normalizedModes.slice(),
@@ -222,6 +240,8 @@ async function handleStartMcpServer(options, projectArg) {
             memoryLogHandler: agentOptions.memoryLogHandler ?? undefined
         })
     });
+    // Track registered instance for cleanup
+    let registeredInstance = null;
     try {
         const serverOptions = {
             host: options.host,
@@ -237,11 +257,26 @@ async function handleStartMcpServer(options, projectArg) {
         switch (options.transport) {
             case 'streamable-http': {
                 const server = await createSmartEditHttpServer(factory, serverOptions);
+                const serverPort = server.url.port ? Number.parseInt(server.url.port, 10) : options.port;
                 logger.info(`Streamable HTTP MCP server started: ${server.url.href}`);
                 logger.info('Press Ctrl+C to exit.');
+                // Register instance (skip in test environment)
+                if (!process.env.SMART_EDIT_SKIP_EDITOR) {
+                    registeredInstance = registerInstance({
+                        port: serverPort,
+                        project,
+                        pid: process.pid,
+                        transport: 'streamable-http'
+                    });
+                    logger.info(`Registered instance ${registeredInstance.id} in registry`);
+                }
                 await new Promise((resolve) => {
                     const shutdown = async () => {
                         logger.info('Stopping HTTP MCP server...');
+                        if (registeredInstance) {
+                            unregisterInstance(registeredInstance.id);
+                            logger.info(`Unregistered instance ${registeredInstance.id} from registry`);
+                        }
                         await server.close();
                         resolve();
                     };
@@ -257,6 +292,17 @@ async function handleStartMcpServer(options, projectArg) {
             case 'stdio': {
                 const server = await createSmartEditStdioServer(factory, serverOptions);
                 logger.info('STDIO MCP server started. Press Ctrl+C to exit.');
+                // For stdio transport, find an available port for the dashboard API (skip in test environment)
+                if (!process.env.SMART_EDIT_SKIP_EDITOR) {
+                    const dashboardPort = findAvailablePort();
+                    registeredInstance = registerInstance({
+                        port: dashboardPort,
+                        project,
+                        pid: process.pid,
+                        transport: 'stdio'
+                    });
+                    logger.info(`Registered instance ${registeredInstance.id} in registry (dashboard port: ${dashboardPort})`);
+                }
                 await new Promise((resolve) => {
                     let settled = false;
                     const finalize = async (reason) => {
@@ -265,6 +311,10 @@ async function handleStartMcpServer(options, projectArg) {
                         }
                         settled = true;
                         logger.info('Stopping STDIO MCP server...');
+                        if (registeredInstance) {
+                            unregisterInstance(registeredInstance.id);
+                            logger.info(`Unregistered instance ${registeredInstance.id} from registry`);
+                        }
                         if (reason === 'signal') {
                             await server.close();
                         }
@@ -295,6 +345,11 @@ async function handleStartMcpServer(options, projectArg) {
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         logger.error(`Smart-Edit MCP サーバーの起動に失敗しました: ${message}`);
+        // Unregister instance on error
+        if (registeredInstance) {
+            unregisterInstance(registeredInstance.id);
+            logger.info(`Unregistered instance ${registeredInstance.id} from registry (error cleanup)`);
+        }
         throw error;
     }
     finally {
@@ -379,7 +434,8 @@ export function createSmartEditCli(options = {}) {
     }
     const startMcpServerCommand = new Command('start-mcp-server')
         .description('Smart-Edit MCP サーバーを起動します。')
-        .option('--project [project]', '起動時にアクティブ化するプロジェクト名またはパス。')
+        .option('--project [project]', '起動時にアクティブ化するプロジェクトパス。省略時はカレントディレクトリを使用。')
+        .option('--no-project', 'プロジェクトなしで起動。後から activate_project ツールで指定可能。')
         .option('--project-file [project]', '[非推奨] --project の旧名称。')
         .argument('[project]', '[非推奨] プロジェクトの位置引数。')
         .option('--context <context>', 'ビルトインコンテキスト名またはカスタム YAML へのパス。')
@@ -404,11 +460,32 @@ export function createSmartEditCli(options = {}) {
             await handleStartMcpServer(opts, normalizedProjectArg);
         }
         catch (error) {
+            // In test environment, rethrow the error so vitest can display it properly
+            // (this.error() calls process.exit which vitest intercepts, hiding the actual error)
+            if (process.env.SMART_EDIT_SKIP_EDITOR) {
+                throw error;
+            }
             const message = error instanceof Error ? error.message : String(error);
             this.error(`${message}\n`, { exitCode: 1 });
         }
     });
     program.addCommand(startMcpServerCommand);
+    const startDashboardCommand = new Command('start-dashboard')
+        .description('統合ダッシュボードを起動します（MCPサーバーなし）。複数のMCPインスタンスを一括管理できます。')
+        .option('--port <port>', 'ダッシュボードのポート番号。', (value) => parseInteger(value, '--port'), DEFAULT_DASHBOARD_PORT)
+        .action(async function () {
+        const opts = this.optsWithGlobals();
+        const port = typeof opts.port === 'number' ? opts.port : DEFAULT_DASHBOARD_PORT;
+        try {
+            const { runStandaloneDashboard } = await import('./standalone-dashboard.js');
+            await runStandaloneDashboard({ port });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(`${message}\n`, { exitCode: 1 });
+        }
+    });
+    program.addCommand(startDashboardCommand);
     const modeCommand = new Command('mode')
         .description('Smart-Edit モードを管理します。');
     modeCommand