codeweb

AI による編集の影響を確認しましょう。

npx -y @ghostlygawd/codeweb .

AI によるコード変更の構造チェック。 codeweb のゲートは変更前後の 呼び出しグラフを構築し、次の 3 つのリグレッションがあればプルリクエストを失敗させます。新たな 依存関係の循環、本文で確認された新たな重複、または呼び出し元のマッピングがない孤立状態になった、既存の非エクスポートシンボルです。ゲートの条件と制限。

チェックに LLM は使いません。静的解析でゲートが消費するモデルのトークン数はゼロです。 チェックに合格しても、プログラムが動作する証明にはなりません。解析では動的な関係を見落とすことがあります。 未解決の結果を確認し、該当するテストを実行してください。純粋な削除は構造ルールに合格します。

判定にはモデルではなくマッピング済みのグラフを使い、LLM のトークンを消費しません。エクスポート済みのシンボルは 差分による孤立チェックの対象外です。analysis.checks を確認してください。スキップされた チェックは合格ではなく、更新すると重複を評価するために必要な証拠が失われます。

グリーンになっても、依存関係を網羅していることや動作が正しいことは保証されません。 純粋な削除は構造上のリグレッションに数えられません。 PR に導入する →

ゲートで比較するにはマップが必要です。そのマップ自体も確認する価値があります。

codeweb はコードを読み取ります。対応している関数と、その間で解決できる呼び出しをマッピングします。 約 3 秒で 3,000 個のシンボルをマッピングします。同じコードからは、静的解析によって同じマップが生成されます。 マッピング処理に LLM は使いません。

静的抽出では、未対応の構文配置、 曖昧な呼び出し、実行時ディスパッチが省かれる場合があります。そのため、マップが完全であるとは保証されません。

コーディングエージェントは grep を使わずにマップを照会します。測定テストでは、grep を使ったエージェントは 関数の実際の呼び出し元の半数以上を見落としました （測定結果を見る）。呼び出し元の一覧が不完全だと、 エージェントが確認していないコードを壊すおそれがあります。

• エージェントに構造化データを提供： Model Context Protocol（MCP）サーバーは、codeweb_impact、codeweb_callers、codeweb_find_similarなど、28個のツールを提供します。
• 回答を小さく保つ： 各クエリはサイズに上限のある構造化された回答を返します。エージェントは残りのコンテキストを実装作業に使えます。
• 同じデータを調査： インタラクティブレポートには、抽出されたコードベースのマップが表示されます。

このマップでは、1つのファイルだけでは確認できない関係も表示されます。これには、重複したロジック、デッドコード、ホットスポット、複雑に絡み合ったドメインが含まれます。

---

リポジトリで試す

cd your-project
npx -y @ghostlygawd/codeweb .

3,000個のシンボルを含むリポジトリの場合、最初のマップの生成には約3秒かかります。.codeweb/report.htmlを開いてマップを確認してください。

すべてのプルリクエストをゲートする

Codewebのソースチェックアウトから判定をローカルで実行します。GitHub Actionを使えば、すべてのプルリクエストで実行できます。

node scripts/ci-gate.mjs --base origin/main --target src   # exit 1 on a structural regression

このゲートは、プルリクエストのベースとヘッドそれぞれからグラフを構築し、差分を取ります。どちらの場合も固定表示の構造レビューコメントを投稿するため、レビュー担当者は何もインストールせずに影響範囲を確認できます。

Actionは移動するブランチではなく、リリースタグに固定してください。 可変の参照を使うと、ゲートの判定仕様が予告なく変わる可能性があります。エンジンも固定するため、codeweb-refも同じタグに固定してください。ワークフローのYAML、モノレポ向けのマトリックス形式、すべての入力については、docs/ci-gate.mdをご覧ください。

ゲートをホスト型で使いたいですか？ワークフローのYAMLも、ベースグラフのキャッシュも、組織内の全リポジトリにまたがる履歴も不要です。これらは、codeweb Teamsの予定範囲です。有料機能と無料機能の境界については、こちらをご覧ください。自分で実行する場合は、今後もずっと無料です。

動作を見る

以下の各スクリーンショットには、axios（280個のシンボル、7個のドメイン）の生成済みレポートが表示されています。 スクリーンショットはモックアップではありません。

codewebはaxiosで実際の重複を3件発見し、誤検出を12件除外しました。事例を読むか、ライブマップを確認してください。

編集前に、その変更の影響範囲を把握する

ライブマップで関数を選択します。マップにその関数の影響範囲がハイライトされ、変更によって影響を受けるシンボルが表示されます。

エージェントもコードを編集する前に、codeweb_impact MCPツールから同じ回答を取得できます。

### システム全体を把握する

力指向マップに、抽出されたシンボルが表示されます。シンボルをドメインにまとめて折りたたむことができます。検索、ドラッグ、ズーム、またはノードの選択で、呼び出し元や依存関係をたどれます。

Findings — リファクタリングの推測をやめる

Findings タブでは、重複、接続数の多いホットスポット、デッドコードの可能性が高い箇所をランク付けします。行を選択すると、シンボルの呼び出し元と依存関係を確認できます。

重複の密度とドメイン間の絡み合いを確認する

Treemap — 各ブロックのサイズは、ファイルのコード行数を示します。明るいブロックほど、重複コードが多く含まれています。明るいブロックを使って、統合できそうな箇所を特定できます。

Matrix — マトリックスは、ドメイン間の結合を示します。対角線以外の大きなセルは、強い結合を示します。ドメインを統合するか、その間に明確なインターフェースを追加できます。

---

codeweb はシンボル解決レベルで動作します。関数、クラス、メソッド、およびそれらの間の呼び出しエッジとインポートエッジをマッピングします。ファイルレベルのスキャナーでは、2 つのモジュールが似ていることを示せます。codeweb では、2 つの関数が同じ処理を行っていることを示し、その呼び出し元を特定して、統合による影響を計算できます。

ベンチマーク

• 編集前に呼び出し元を見つける： v0.9.0 の効率性パイロットでは、同じコンテキスト消費量で、エージェントは codeweb を使うと関数の実際の呼び出し元の 74% を見つけ、grep では 44% を見つけました。呼び出し元を見落とすと、編集によって動作しているコードが壊れるおそれがあります。
• 変更の影響を計算する： codeweb の 1 回の呼び出しで、簡潔な回答が返されました。記録された比較では、グラフを利用した grep のシミュレーションループは 126 倍のコンテキストサイズを使用しました。これはコンテキストサイズの差を測定したものであり、エージェントセッション全体のトークン節約量ではありません。
• 重複コードを検出する： codeweb は、名前が変更されたコピーも含め、意図的に埋め込まれた重複を誤検出ゼロですべて見つけました。テキスト検索では、名前が変更されたコピーを 0% しか見つけられませんでした。
• 決定的な結果を確認する： テストでは、codeweb を TypeScript コンパイラーやその他の独立した実装と 490,000 回以上比較し、不一致はゼロでした。
• すばやくマッピングしてクエリする： シンボルが 3,000 個あるリポジトリの場合、最初のマッピングには約 3 秒かかります。クエリには約 0.1 秒かかります。シンボル数が 2 倍のリポジトリでは、マッピングにかかる時間は約 1.3 倍です。
• 限界を理解する： 非常に大規模な編集の後は、新しいマッピングにより時間がかかることがあります。また、エージェントは codeweb を使わずに簡単なタスクを正常に完了することもできました。

方法論、元データ、各主張の根拠については、エビデンス台帳をご覧ください。Codeweb のソースをチェックアウトした状態で、npm run bench -- <path>/.codeweb/graph.json を実行すると、独自のリポジトリをベンチマークできます。CI ではすべての PR でパフォーマンス予算を再検証し、公表済みの数値を下回るとビルドが失敗します。

codeweb はローカルのアクティビティ集計も保持します。Codeweb のソースをチェックアウトした状態で npm run stats を実行すると確認できます。

codeweb this month: 41 pre-edit card(s) · 5 card-named caller(s) followed · 2 regression(s) flagged · 120 queries served

依存関係を評価するには、所有していないリポジトリを codeweb に指定します。 /codeweb https://github.com/owner/repo。codeweb は読み取り専用のクローンを作成し、そのクローンをマッピングして、導入に関するレビューを追加します。codeweb は対象のコードを実行しません。

インストール

無料の MIT ライセンスです。すべてお使いのマシン上で実行され、アカウントもサーバーもテレメトリーも不要です。コードを読み取りますが、実行することはありません。

• codeweb の実行には Node.js ≥ 22 が必要です。
• codeweb に必須の依存関係はありません。CI では、空の node_modules ディレクトリで動作することを検証しています。
• オプションの web-tree-sitter wasm 文法を使うと、抽出精度が向上します。codeweb の実行に必須ではありません。
• CI では npm provenance を付与してリリースを公開しています。リリースを検証するには npm audit signatures を実行してください。

Claude Code をお使いですか？ プラグインをインストールすると、/codeweb コマンド、編集前の影響カードの自動表示、および 28 個すべてのツールが追加されます。

/plugin marketplace add GhostlyGawd/codeweb
/plugin install codeweb

/codeweb コマンド、エージェント、スキルを登録するには、Claude Code を再起動してください。

Codex をお使いですか？ 同梱のコーディングスキルとローカル MCP サーバーをインストールします。

codex plugin marketplace add GhostlyGawd/codeweb
codex plugin add codeweb@codeweb

Codex を再読み込みしてから、$codeweb を使って編集前に呼び出し元を調べたり、既存の実装を比較したり、構造的な変更をレビューしたりできます。プラグインは既存のツール権限を使用します。

プラグイン／MCP のワークフローは Codex CLI 0.159.2 および 0.160.0 で検証されています。クライアントが同梱ツールを公開しない場合は、コーディングスキルと併せて、以下のスタンドアロン MCP の手順を使用してください。Codeweb を無効化または削除する場合は、設定済みの各エントリーを管理してください。このワークフローでは、フックの自動配信は保証されません。

MCP クライアントを選択： セットアップページには、Claude Code、Cursor、Windsurf、Gemini CLI、Codex 向けの手順がまとめられています。プロジェクトから手順を表示し、ローカルのセットアップを確認できます。

npx -y @ghostlygawd/codeweb setup --client cursor
npx -y @ghostlygawd/codeweb doctor

セットアップでは、ファイルを置き換えずに設定を表示します。Doctor はローカルサーバーとグラフを確認します。ローカルでの確認に成功しても、エディターとの接続が証明されるわけではありません。クライアントを再起動し、エージェントに codeweb_callers を実行させ、返されたソース位置を確認してください。

AI エージェントを使わずにリポジトリをマッピング： プロジェクトディレクトリから次のコマンドを 1 つ実行します。

cd your-project
npx -y @ghostlygawd/codeweb .    # ~3 s for 3,000 symbols — then open .codeweb/report.html

一時的に評価する場合は、npx コマンドを使用してください。永続的にインストールせずにマップを作成できます。

クローンからエンジンを実行：

git clone https://github.com/GhostlyGawd/codeweb.git
node codeweb/scripts/run.mjs /path/to/your/project

docs/cli.md には、各実行ファイル、フラグ、終了コードが記載されています。

VS Code： editor/vscode-codeweb では、マッピングされた各シンボルの上に N callers · blast M のレンズが表示されます。レンズを選択するとレポートが開きます。

できること

各リンクから、リファレンス にある詳細なドキュメント、フラグ、使用例を確認できます。

• 編集前に把握する： 呼び出し元を見つけ、変更の影響を計算し、既存の実装がないか確認します。 → グラフをクエリする · コンテキストと事前チェック
• すべての編集をチェックする： 編集、プルリクエスト、アーキテクチャルールに対する構造的なリグレッション結果を取得します。 → diff の判定 · PR ゲート · 機能スイート
• 優先順位を付けて整理する： 根拠に基づいて、統合やデッドコードの削除に優先順位を付けます。 → optimize · hotspots · campaign · trend

使用方法

/codeweb                                  # map the current project
/codeweb src/payments --depth symbol      # deep-dive one subsystem
/codeweb https://github.com/owner/repo    # external review before adopting
/codeweb owner/repo --open                # clone, map, and open the report

利用可能なフラグには、--depth module|symbol|auto、--engine hybrid|read|tools、--focus <glob>、--mode internal|external、--open があります。詳しくは commands/codeweb.md を参照してください。

codeweb はすべての出力を <target>/.codeweb/ に書き込みます。エージェントやその他のツールは graph.json を読み取れます。report.html を開くこともできます。codeweb は Markdown 形式のファイルも作成します。 各出力ファイルの説明を参照してください。

MCP ツールとして使用する

scripts/mcp-server.mjs は、依存関係ゼロの Model Context Protocol（MCP）stdio サーバーです。MCP クライアントから 28 個のツールを利用できます。これらのツールは、クライアントが状況を把握し、構造を読み取り、書き込み前に確認し、編集をゲートし、クリーンアップを計画するのに役立ちます。

9 月 14 日に実施したパッケージ版の評価では、Codex CLI 0.154.0 を使ってベースラインのループを検証しました。この評価は、すべてのクライアントですべてのツールを認証したものではありません。Claude のランタイム互換性やその他のクライアントは、この評価ではテストしていません。記録された評価範囲を参照してください。

プラグインはサーバーを自動的に登録します。 スタンドアロンサーバーを登録するには、次を実行します。

claude mcp add codeweb -- npx -y -p @ghostlygawd/codeweb codeweb-mcp

Codeweb 0.15.0 以降が必要です。 インストール済みの MCP サーバーを使用するか、リファレンスに示すように、絶対パスを指定してソースチェックアウトを登録してください。

エージェントが実行するループ：

1. codeweb_brief（シンボル名が不明な場合は codeweb_find）で状況を把握します。
2. 編集前に、codeweb_refresh {baseline:true} を 1 回呼び出して、最新のソースを取得します。シンボルを変更する前に、codeweb_explain を呼び出し、その後 codeweb_context、codeweb_impact、または codeweb_dependents で確認します。
3. 編集後に、codeweb_diff {before:"baseline",refresh:true} を呼び出します。
4. 結果が赤の場合は、コードを修正し、同じベースラインに対して同じ diff を繰り返します。修正中に別のベースラインを取得しないでください。baseline:true を指定すると元のベースラインが置き換わります。通常のリフレッシュと自動リフレッシュでは、ベースラインは保持されます。次のタスクでは新しいベースラインを開始してください。

既知の未対応の同一行 JS/TS 宣言では、クリーンなゲートではなく status: "inconclusive" と ok:false が返されます。診断箇所と呼び出し元をソースで確認してください。検出機能は既知のレイアウトを対象としており、診断がないからといって、抽出が完全であるとは限りません。

analysis.checks を確認してください。スキップされたチェックは合格ではありません。リフレッシュすると重複の証拠が失われるため、このループでは重複を評価しません。構造上の結果がグリーンでも、動作上の正しさが証明されるわけではありません。プロジェクトのテストも実行してください。ベースラインが失われた場合、編集後のソースから元の状態を再構築することはできません。再開する前に、編集前のソースを復元してください。

npm v0.14.0 では、スナップショットのクイックスタートを使用してください。未リリースのチェックアウトでは、小さなサイクル → 修正 → グリーンのウォークスルーをお試しください。サーバーに組み込まれた指示が表示されないクライアントでは、代わりにルールのスニペットを貼り付けてください。

サーバーには、次のエージェント固有の機能が含まれています。

• 省略可能な graph 引数： graph を省略すると、サーバーは最も近いマップを検索します。マップがない場合、エラーでエージェントに codeweb_map を実行するよう案内します。
• 予算に応じたレスポンス： レスポンスには、ランクが最も高い項目と正確な合計数が含まれます。約 300 KB だったコンテキストのレスポンスは、現在約 10 KB です。
• 古さに関する情報： 古い結果には、その状態が示され、codeweb_refresh を実行するよう案内されます。これは状況把握ツールと、生成されるアドバイザーのすべての回答に適用されます。

28 個のすべてのツール：分類と説明 →

仕組み

JavaScript、TypeScript、Python、Rust、Go、Java、C#、Ruby、PHP、Kotlin、Swift、C、C++ では、 codeweb はデフォルトで決定論的な Node パイプラインを使用します。1 つのコマンドでマップを作成できます。パイプラインに LLM は含まれず、同じ入力からは常に同じバイト列が生成されます。

マップのパイプラインは、以下の図に示す 4 つの段階で構成されます。scripts/run.mjs は、重複分析の後、レポートのレンダリング前に optimize.md も作成します。

1. 抽出（extract-symbols.mjs）では、各ソースファイルを解析し、関数、クラス、メソッドなどのアトミックなノードに分割します。また、呼び出しとインポートのエッジも記録します。修飾されていない呼び出しが複数の定義を指す可能性がある場合、codeweb は推測せず、そのエッジを省略します。ファイル単位のキャッシュにより、抽出を増分的に実行でき、フルビルドとバイト単位で同一の結果が得られます。インポートされた .json ファイルは解析されず、ファイルレベルのノードとしてマップに追加されます。参照されていない .json ファイルはマップから除外されるため、ロックファイルによるノイズを防げます。
2. クラスタリング（cluster3.mjs）では、実際にユーティリティとして機能するハブを取り除き、残りのノードをディレクトリにひも付いた意味領域にグループ化します。
3. 重複分析（overlap.mjs）では、重複したロジックと並行実装を検出します。トークンのシャングル類似度を使い、各候補を実際の関数本体と比較します。この確認により、名前が偶然一致しただけのものが検出結果になるのを防ぎます。識別子を正規化したスケルトンに対する構造的なパスでも、名前を変更した Type-2 クローンを検出します（find-similar --structural）。
4. レンダリング（build-report.mjs）では、graph.json を自己完結型の report.html および report.md ファイルに変換します。

抽出器で解析できない言語では、codeweb はエージェントパスを使用します。 codeweb-dissector エージェントが各サブシステムのノードとエッジを抽出します。続いて codeweb-domain-mapper がドメインと重複を割り当てます。

どちらのパスでも、同じ graph.json スキーマが生成されます。external モードでは、どちらのパスも採用判定を追加します。

言語サーバー（LSP）との違い： LSP はエディターセッション内で、定義や直接参照などの 1 段階先の情報をオンデマンドで返します。codeweb は、推移的な影響、関数本体の証拠に基づく重複、デッドコード、ドメイン間の結合を含む、決定論的なグラフ全体の成果物を作成します。

エージェントは MCP 経由でその成果物をクエリし、CI はその差分を確認して PR の可否を判定します。この 2 つは併用できます。codeweb が置き換えるのは grep の繰り返しであり、言語サーバーではありません。

ドキュメントのインデックスから目的に合った読み進め方を選んでください。リポジトリの所有権についても説明しています。コンポーネントマップでは、エンジンの詳細を確認できます。

ロードマップ

• ファーストクラス対応言語をさらに追加： codeweb は現在、JavaScript、TypeScript、Python、Rust、Go、Java、C#、Ruby、PHP、Kotlin、Swift、C、C++ の 13 言語をネイティブにサポートしています。その他の言語にはエージェントによるフォールバックを使用します。動的ディスパッチ向けの AST 階層は、JS/TS、Java、C#、Python、Go、Rust、Ruby、PHP、C、C++ に対応しています。Kotlin と Swift のディスパッチには、固定された ABI の信頼できる wasm 文法が必要です。scripts/grammars/PROVENANCE.md を参照してください。

最近のリリースでは、エージェントインテリジェンススイート（hotspots、campaign、 reading-order、Type-2 クローン検出、抑制メモリ）、ライブインタラクティブデモ、高速パスでの Go と Rust のサポート、重複傾向データ、GitHub Action を使ったワンコマンドの CI 回帰ゲートが追加されました。 codeweb は現在、28 個のツールを提供しています。

バージョン管理とリリース

以下のメンテナンスコマンドを実行するには、Codeweb のソースチェックアウトが必要です。

codeweb はセマンティック バージョニングに従います。変更は CHANGELOG.mdに記録されます。このファイルでは Keep a Changelog形式を使用しています。各機能、ベンチマーク、修正は タグ付き GitHub リリースとして公開されます。

バージョンの正しい値はpackage.jsonです。 MCP ツールの数の正しい値はscripts/mcp-server.mjsです。リリースツールがその他の値を算出し、 検証します。

npm run version-sync        # propagate version + tool count -> plugin.json, SKILL.md, README badge
npm run check-consistency   # fail if any public-facing surface has drifted
npm run build:site          # regenerate the docs/ website (zero-dependency, deterministic)
npm run release -- --minor  # roll the changelog, bump, sync, rebuild; prints the git/tag steps

check-consistencyは CI で実行されます。すべての箇所にあるバージョン文字列、ツール数と言語数の認識済みの文章パターン、現在のバージョンに対応する CHANGELOG の項目、および台帳に記載されたすべての根拠ファイルをチェックし、条件を満たさない場合は CI を失敗させます。

概要

GhostlyGawdが開発しました。コードの多くは AI エージェントの支援を受けて作成されています。コミットの共同作成者トレーラーに、それらの貢献が記載されています。質問や問題がある場合は、イシューを作成してください。セキュリティ上の問題を報告するにはSECURITY.mdを参照してください。

最新情報を受け取るには： codeweb は更新サービスに接続しません。リリース通知を受け取るには、GitHub でWatch → Custom → Releasesを選択してください。

永久に無料、その先にある有料部分

CHARTER.mdで承認されたルールは次のとおりです。1 台のノート PC で 1 つのリポジトリに対して実行するものはすべて永久に無料です。有料となるのは、ホスティング、複数リポジトリの集約、人によるサポートです。

このリポジトリにあるものはすべて無料部分です。マップ、MCP ツール、フック、レポート、CLI、セルフホスト可能なゲート Action、そして codeweb が学習するすべての言語が含まれます。MIT ライセンスで、アカウント、テレメトリー、ライセンスキーは不要です。ここにあるものが後から有料になることはありません。

計画中の有料部分は、独立したホステッドサービスのcodeweb Teamsです。ゲートの実行を代行し、組織内のすべてのリポジトリにわたる履歴を保持します。課金はこのサービス内でのみ行われるため、支払いに問題が生じてもホステッド版のみに影響し、ローカルのツールや CI が損なわれることはありません。

ホステッドサービスの提供状況は、このリポジトリのローカルチェックでは確認できません。料金ページにはサインアップへの導線が残されています。

契約の全文は境界に関するページ、計画中の Teams の料金は料金ページをご覧ください。

プロジェクトを支援する

スポンサーになることでプロジェクトを支援できます。スポンサーシップには広告の掲載も含まれます。トップスポンサーは README の先頭にロゴを掲載でき、各スポンサーは支援者リストに参加できます。詳しくは支援ページをご覧ください。

組織で codeweb を実行していてサポートが必要な場合は、GitHub プロフィールからメールを送信してください。

引き継ぎ

refactor-cleaner、codebase-onboarding、code-tourのツールをお持ちの場合は、codeweb の出力をそれらに渡せます。codeweb の実行にこれらのツールは必要ありません。

次のステップとして、optimize.mdで最も高く評価されているreadyなマージを適用してください。その後、codeweb をもう一度実行し、検出件数を比較してください。