Delphi Code

Delphi Code

コーディングエージェントがすべてのリポジトリにあるコードを検索できるようにします。ローカルプロジェクトや GitHub、Bitbucket のリポジトリをインデックス化し、「ウェブアプリから要求された返金をバックエンドで処理している箇所はどこですか？」と質問すれば、その言葉が含まれるファイルがなくても、すべてのリポジトリから該当するファイルを一度に取得できます。

• プライベート： コードがマシンの外に出ることはありません。インデックス作成と検索は、ローカルモデルを使ってオフラインで実行されます。アカウント、クラウドプロバイダー、バックグラウンドデーモンは不要です。
• 高速： MCP サーバーがモデルを読み込んだ状態に保つため、繰り返しの検索もほぼ瞬時に行えます。GPU は不要です。
• エージェントで利用可能： Claude Code、Claude Desktop、Codex、Cursor、VS Code、Gemini CLI、OpenCode に対応しています。

インストール

curl -LsSf https://github.com/markdorof/delphi-code/releases/latest/download/install.sh | sh

必要に応じてスクリプトが uv をインストールし、その後 setup を実行します。setup は埋め込みモデルを一度ダウンロードし、見つかったすべてのエージェントに接続します。オプションは sh -s -- の後に指定します：--no-setup、--no-connect、--version VERSION。uv がすでにインストールされている場合：

uv tool install --managed-python --python 3.14 delphi-code
delphi-code setup

Apple silicon 搭載の macOS 14 以降が必要です（Linux は未検証、Windows は非対応です）。delphi-code doctor でインストール状況を確認できます。

使用方法

delphi-code add ~/src/api github.com/octo/tools   # track and index projects
delphi-code search 'where are user passwords checked?'
delphi-code ui                                     # or do it all in the browser

エージェントは MCP を通じて同じ検索を呼び出します。新しいエージェントをインストールした後は、delphi-code connect を実行してください。手動で接続する場合：

エージェント	設定
Claude Code	claude plugin marketplace add markdorof/delphi-code を実行し、次に claude plugin install delphi-code@delphi-code を実行します
Codex	codex plugin marketplace add markdorof/delphi-code を実行し、次に codex plugin add delphi-code@delphi-code を実行します
Cursor	{"mcpServers": {"delphi-code": {"type": "stdio", "command": "delphi-code", "args": ["mcp"]}}} を ~/.cursor/mcp.json に追加します
VS Code（Copilot）	code --add-mcp '{"name": "delphi-code", "command": "delphi-code", "args": ["mcp"]}' を実行します
Gemini CLI	gemini mcp add delphi-code delphi-code mcp を実行します
OpenCode	{"mcp": {"delphi-code": {"type": "local", "command": ["delphi-code", "mcp"]}}} を ~/.config/opencode/opencode.json に追加します

Claude Code と Codex 以外のエージェントでは、意味に基づいて検索し、grep を使わないタイミングがわかるように、スキルもエージェントのスキルフォルダーにコピーしてください。

コマンド

コマンド	機能
setup	モデルをダウンロードします（オフラインのマシンでは --from DIR でインポートできます）。エージェントも接続します。
add [SOURCE ...]	ローカルパスやリモートリポジトリを追跡してインデックス化します（--ref でブランチまたはタグを指定）。ソースを指定しない場合は、GitHub または Bitbucket アカウントからリポジトリを選択します。
sync [PROJECT ...]	追跡中のプロジェクトを更新し、変更された箇所だけを再度埋め込みます。
index -p PATH	プロジェクトを追跡せずに一度だけインデックス化します。
search QUERY	すべてのインデックス、または -p で指定したインデックスを検索します。--language、--path、--limit で絞り込めます。
list、status、remove NAME	追跡中のプロジェクトを表示する、プロジェクトのインデックスを表示する、プロジェクトの追跡を停止する操作を行います。
connect、disconnect	エージェントの設定に Delphi Code を追加または削除します。
ui	検索、プロジェクト、セットアップ確認のためのローカルウェブ UI を開きます。
doctor	モデルとストレージを確認します。
mcp	コマンドを MCP ツールとして stdio 経由で提供します。

-p にはパスまたはインデックス化されたプロジェクト名を指定します。index と add は .gitignore の対象ファイルを除外し、--ignore、--path、--language を指定できます。すべてのコマンドで --help を指定でき、ほとんどのコマンドではスクリプト用の --json も指定できます。ネットワークを使用するのは setup、add、sync のみです。

設定

変数	用途
GITHUB_TOKEN / GH_TOKEN	リモートリポジトリへの GitHub アクセス（gh auth token、次に git の認証情報を順に使用します）
BITBUCKET_APP_PASSWORD と BITBUCKET_EMAIL または BITBUCKET_USERNAME	Bitbucket へのアクセス（API トークンも使用できます）
DELPHI_CODE_MODEL	デフォルトの all-MiniLM-L6-v2 の代わりに、別のローカル SentenceTransformers モデルを使用します
DELPHI_CODE_INDEX_ROOT、DELPHI_CODE_REGISTRY、DELPHI_CODE_LOG_FILE	インデックス、追跡対象プロジェクトのリスト、またはログの保存先を変更します
DELPHI_CODE_LOG_LEVEL	DEBUG、INFO、WARNING、ERROR、または OFF

データは、macOS では ~/Library/Application Support/delphi-code に、Linux では ~/.local/share/delphi-code に保存されます。

アップグレードとアンインストール

uv tool upgrade delphi-code

モデルとインデックスは保持されます。コマンドが index_incompatible エラーで失敗した場合は、指定されたインデックスディレクトリを削除して、もう一度 sync を実行してください。変更点についてはリリースをご覧ください。

delphi-code disconnect
uv tool uninstall delphi-code
rm -rf ~/Library/Application\ Support/delphi-code
uv cache clean   # frees about 900 MB of downloaded packages

インストールスクリプトによって uv がインストールされており、不要な場合は、uv とその Python をアンインストールしてください。

ライセンス

Apache-2.0。THIRD_PARTY_NOTICES.mdをご覧ください。コントリビューションについては、CONTRIBUTING.mdをご覧ください。