Repolode
投稿する
Houseofmvps

Houseofmvps/codesight

コードベースをスキャンしてAI向けの簡潔なコンテキストファイルを生成し、調査に使うトークンを削減するCLI。

GitHub で見る公式サイト
スター
1,419
フォーク
128
未解決の Issue
2
最終コミット
3 か月前

これは何？

codesightはプロジェクトのルート、データベースモデル、UIコンポーネント、環境変数、importグラフをスキャンし、構造化されたMarkdownとして出力します。各セッションの開始時にアシスタントが多数のファイルをgrepして開く代わりに、Claude Code、Cursor、GitHub Copilot、CodexなどのAIコーディングツールに一度読み込ませることを想定しています。

TypeScriptプロジェクトでは、インストールされている場合にTypeScript Compiler APIで解析し、その他の言語では正規表現による検出を行います。30以上のWeb・モバイルフレームワークと14のORMに対応しています。また、.codesight/wiki/にWiki形式のナレッジベースを生成したり、14個のツールを備えたMCPサーバーを起動したり、変更の影響を受けるファイルやルートを示す影響範囲レポートを作成したりできます。

このパッケージにはランタイム依存関係がなく、APIキーや設定なしで、任意のプロジェクトルートからnpxで実行できます（デフォルトのスキャンの場合）。

主な機能

  • 01CLAUDE.md、.cursorrules、codex.md、AGENTS.mdのコンテキストファイルを生成します。
  • 02ルート、データベーススキーマ、コンポーネント、環境変数、ミドルウェアをMarkdownにまとめます。
  • 03importグラフから、指定したファイルの変更による影響範囲を算出します。
  • 0414個のツールを備えたMCPサーバーとして、Claude CodeやCursorから利用できます。
  • 05AST解析によるTypeScriptのほか、正規表現による検出で多くの言語に対応します。

ユースケース

  • 各セッションの開始時に、AIコーディングアシスタントへ簡潔なプロジェクト概要を渡す。
  • 共有モジュールを変更する前に、影響を受けるルートやファイルを確認する。
  • git hookやwatch modeを使って、コミット対象のプロジェクトWikiを最新の状態に保つ。
  • コードベース全体で必要な環境変数を監査する。

クイックスタート

  1. 1

    プロジェクトのルートでスキャンを実行します

    npx codesight
  2. 2

    AI設定ファイル（CLAUDE.md、.cursorrules、AGENTS.md）を生成します

    npx codesight --init
  3. 3

    Wikiナレッジベースを生成します

    npx codesight --wiki

使う前に知っておきたいこと

  • ASTの精度を最大限に活用できるのはTypeScriptプロジェクトのみです。それ以外の言語では正規表現による検出を使用します。

トピック

#ai-tools#llm#code-analysis#context-engineering#cli#developer-tools#mcp#token-optimization#ai#claude

よくある質問

codesight とは？
コードベースをスキャンしてAI向けの簡潔なコンテキストファイルを生成し、調査に使うトークンを削減するCLI。 codesightはプロジェクトのルート、データベースモデル、UIコンポーネント、環境変数、importグラフをスキャンし、構造化されたMarkdownとして出力します。各セッションの開始時にアシスタントが多数のファイルをgrepして開く代わりに、Claude Code、Cursor、GitHub Copilot、CodexなどのAIコーディングツールに一度読み込ませることを想定しています。
codesight は無料で使えますか？ライセンスは？
codesight は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
codesight は今もメンテナンスされていますか？
半年以内に更新あり。codesight の最終コミットは 2026年7月27日 です。
codesight は何に使えますか？
各セッションの開始時に、AIコーディングアシスタントへ簡潔なプロジェクト概要を渡す。 共有モジュールを変更する前に、影響を受けるルートやファイルを確認する。 git hookやwatch modeを使って、コミット対象のプロジェクトWikiを最新の状態に保つ。 コードベース全体で必要な環境変数を監査する。
codesight のインストール方法は？
プロジェクトのルートでスキャンを実行します: npx codesight AI設定ファイル（CLAUDE.md、.cursorrules、AGENTS.md）を生成します: npx codesight --init Wikiナレッジベースを生成します: npx codesight --wiki
codesight はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/Houseofmvps/codesight

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト