jscpd

プログラミングソースコード用のコピー/ペースト検出器。224以上のフォーマットに対応。MCPサーバーとトーケン効率的なレポーターでAI対応。Rust搭載エンジンで24〜37倍高速化。

jscpdは、abin-Karpアルゴリズムを実装し、ファイル間の重複したコードブ口ックを検出します。

クイックスタート

# Install (all platforms — installs the jscpd command)
curl -fsSL https://jscpd.dev/install.sh | bash

# TypeScript engine (Node.js, v4.x)
npm install -g jscpd@4
jscpd /path/to/code
# or use without installing
npx jscpd@4 /path/to/code

# Rust engine (v5.x, 24-37x faster) — installs the jscpd command
npm install -g jscpd@5
jscpd /path/to/code

# Rust engine — cpd command only
npm install -g cpd
cpd /path/to/code

# Rust-native install (exposes both jscpd and cpd)
cargo install jscpd

# Nix (installs both jscpd and cpd)
nix run github:kucherenko/jscpd -- /path/to/code
# or install permanently
nix profile install github:kucherenko/jscpd

# Homebrew (macOS/Linux)
brew install jscpd

Related MCP server: tree-sitter-analyzer

ドキュメント

2つのエンジン

jscpd@5 は jscpd コマンドをインストールします。cpd npmパッケージは cpd コマンドをインストールします。どちらにも同じRustバリナリが含まれています。1回のインストールで両方のコマンド名を使いたい場は、crates.io を使用してくださ: cargo install jscpd。

新機能

v5.0.x — Rustエンジン

jscpd v5は、jscpd@5（jscpd コマンドをインストール）または cpd（cpd コマンドをインストール）として提供される、ゼロから書き直されたRust実装です。自己完結型バリナリ — Node.jsランタイムは不要です。

同じインターフェース、24〜37倍高速:

• v4のすべてのCLIオプションを維持 — 置き換えそのまま: jscpd → jscpd@5

• 同じ .jscpd.json 設定ファイル、同じ検出アルゴリズム、同じレポーター

• クロスフォーマット検出に対応した223の言語フォーマット（Vue SFC、Svelte、Astro、Markdown）

v5の新機能:

• 24〜37倍高速 な実プロジェクトでの検出（benchmark を参照）

  • 小規模コードベース（548ファイル）: 34倍高速

  • 中規模コードベース（9Kファイル）: 37倍高速

  • 大規模コードベース（17Kファイル、900 MB）: 24倍高速

• Git blame — 著者を並べて比較表示（--blame --reporters console-full）

• --workers — ファイルのトークナイズと検出の並列度を制御（デフォルト: 自動、全CPUコアを使用。v4では利用不可）

• 13のレポーター: console, console-full, json, xml, csv, html, markdown, badge, sarif, ai, xcode, threshold, silent

• AIレポーター — LLMパイプライン向けのトークン効率的な出力（console比でトークン約79%削減）

• --mcp — stdio上の組み込みMCPサーバー: AIアシスタントをバイナリに向けると、コードベースに対してスニペットの重複をチェックできます（docs を参照）

• --summary — コードベースのサマリー: トークン数、行数、サイズ、複雑性の見積もりによるトップファイルとフォルダ — スキャンから直接リファクタリングのホットスポットを把握（docs を参照）

• 自己完結型バイナリ — 7プラットフォーム向けにプリビルド（macOS arm64/x64、Linux arm64/x64、Windows arm64/x64）

v5にはまだない機能（これらにはv4を使用）:

• LevelDB/Redisストア（--store leveldb）

• Node.jsプログラミングAPI（jscpd()、detectClones()）

完全なCLIリファレンスとv4との違いについては、Rustドキュメント を参照してください。

v4.2.x — TypeScriptエンジン

• カスタムトークナイザーバックエンド — prismjs を reprism 上に構築した独自バックエンドに置き換え。実プロジェクトでトークナイズが約11.5%高速化

• クロスフォーマット検出 — Vue SFC、Svelte、Astro、Markdownをブロックごとにトークナイズし、ファイルタイプをまたいだ検出を実現

• 新しいフォーマット: Apex、CFML/ColdFusion、GDScript、および70以上の追加フォーマット（合計224、152から増加）

• Shebang検出 — 拡張子のないスクリプトの言語を自動検出

• --store-path — 並列実行時のLevelDBキャッシュディレクトリを設定

• --skipComments — --mode weak の短縮形

• --formats-names — ファイル名（例: Makefile、Dockerfile）をフォーマットにマッピング

• --noTips — CIでのヒント出力を抑制

• バグ修正: ファイル全体の重複が黙って除外される問題（#728）、Lisp/ElispファイルでのReDoS（#737）、不正な package.json によるプロセスクラッシュ（#739）、Vue SFCのクロスファイル検出（#737）、Vue SFCの列番号（#737）、50件の依存関係のセキュリティ脆弱性

完全なCLIリファレンスについては、TypeScriptドキュメント を参照してください。

パッケージ

jscpdの利用者

npmパッケージ jscpd は毎月10M+回ダウンロードされており、GitHubのdependentsグラフでは~5,000のリポジトリがそれを宣言しています。

分析プラットフォームにバンドル:

• GitHub Super Linter — 公式のGitHub linterアグリゲーターで、コピー/ペースト検出器としてjscpdをバンドル

• MegaLinter — CI向けのオープンソースlinterアグリゲーターで、ci_light を含むすべてのフレーバーでjscpdを同梱

• Codacy — 自動コード分析プラットフォームで、重複検出エンジンにjscpdを採用

注目すべきプロジェクトでの利用:

• OpenClaw — 個人向けAIアシスタント。チェックスクリプトで重複ゲートとしてjscpdを実行

• DeepSeek Harness — DeepSeekのプラグインハーネス。CIでjscpd設定を使用

• degit — Rich Harrisのプロジェクトスキャフォルダー

• MEGA webclient — MEGA.nzのWebクライアント

• Microsoft TypeAgent

• Salesforce DX VS Code

• Alibaba AppWorks — ライブラリとしてjscpdを組み込み

• OVHcloud manager — OVHcloudのカスタマーコントロールパネル

• KiroCrew — 自己改善型の常駐開発ワークスペース

パフォーマンス

macOS（Apple Silicon）でベンチマークを実施し、ターゲットごとに10回実行（CopilotKitは3回）。v4は --no-gitignore -i "node_modules" を指定して、同等のファイルスキャンを確保しました。

完全な方法論と生データについては、performance-comparison.md を参照してください。

AI対応機能

jscpdは、次の3つのメカニズムを通じてAIを活用したワークフローに統合されます:

AIレポーター

LLMパイプライン向けのトークン効率的な出力（デフォルトのコンソールレポーター比で約79%少ないトークン）:

jscpd --reporters ai /path/to/source              # v4
cpd --reporters ai /path/to/source                # v5
cpd --reporters ai --summary /path/to/source      # v5: + compact codebase summary

エージェントスキル

AIコーディングアシスタントにjscpdの使い方と検出された重複のリファクタリング方法を教える、インストール可能な2つのスキル:

インストール後、エージェントに「コードの重複を見つけて修正して」と依頼すると、適切なオプションでjscpdを呼び出し、結果に基づいてアクションを実行します。

詳細については、AI-Readyドキュメント を参照してください。

コントリビューション

開発環境（Rust と TypeScript）、テスト方針、受け入れ可能なプルリクエストの要件については、CONTRIBUTING.md を参照してください。セキュリティ問題は公開の issue ではなく、セキュリティポリシー を通じて報告してください。

1. リポジトリ kucherenko/jscpd をフォークする

2. フォークしたバージョンをクローンする (git clone https://github.com/{your-id}/jscpd)

3. 依存関係をインストールする (pnpm install)

4. 開発モードで実行する: pnpm dev

5. 変更を追加する

6. テストを追加して確認する: pnpm test

7. ビルドする: pnpm build

8. PR を作成する

バッカー

バッカーの皆様、ありがとうございます！ 🙏 [バッカーになる]

スポンサー

スポンサーになってこのプロジェクトを支援してください。あなたのロゴがウェブサイトへのリンクとともにここに表示されます。 [スポンサーになる]

ライセンス

MIT © Andrey Kucherenko