Repolode
提交项目
Houseofmvps

Houseofmvps/codesight

一款命令行工具，扫描代码库并生成精简的 AI 上下文文件，减少编程助手探索项目时消耗的 token。

在 GitHub 查看官网
Star
1,419
Fork
127
未关闭 Issue
2
最近提交
3个月前

这是什么？

codesight 是一款命令行工具，会分析项目中的路由、数据库模型、UI 组件、库导出、环境变量和导入关系，并将结果输出为结构化的 Markdown 文件。使用 Claude Code、Cursor、GitHub Copilot、Codex 等 AI 编程助手时，可以直接加载这份汇总地图，而不必让助手在每次对话开始时逐个搜索和阅读大量文件。

工具通过 npx 运行，无需配置，也不需要 API 密钥。对于 TypeScript 项目，它调用 TypeScript 编译器 API 做结构化解析；Python、Go、Ruby、Java、Rust、PHP、Swift 等其他语言则基于正则识别主流框架。此外还提供 blast 命令，用于列出修改某个文件时受影响的文件、路由和模型；可选的 wiki 模式会把上下文拆分为按主题组织的文章；并内置包含 14 个工具的 MCP 服务器。

项目使用 TypeScript 编写，运行时零依赖，要求 Node.js 18 及以上版本。

核心功能

  • 01将路由、数据库模型、组件、环境变量和依赖关系生成为 Markdown 文件。
  • 02安装了 TypeScript 时使用编译器 API 进行精确解析。
  • 03通过正则识别支持 Python、Go、Ruby、Java、Rust、PHP、Swift、Dart 等语言。
  • 04提供 blast 命令，展示修改某个文件时受影响的文件和路由。
  • 05内置包含 14 个工具的 MCP 服务器，适配 Claude Code 和 Cursor。
  • 06可生成 CLAUDE.md、.cursorrules、codex.md、AGENTS.md 等配置文件。

适用场景

  • 在大型单体仓库中，减少 AI 编程助手每次会话开头加载的上下文。
  • 修改共享模块前，查看会影响哪些文件、路由和模型。
  • 审计代码库中必填与带默认值的环境变量。
  • 让新成员或 AI 代理快速了解一个陌生项目的结构。

标签

#ai-coding#context-engineering#llm#cli#code-analysis#developer-tools#mcp#typescript#ai#claude

常见问题

codesight 是什么？
一款命令行工具，扫描代码库并生成精简的 AI 上下文文件，减少编程助手探索项目时消耗的 token。 codesight 是一款命令行工具，会分析项目中的路由、数据库模型、UI 组件、库导出、环境变量和导入关系，并将结果输出为结构化的 Markdown 文件。使用 Claude Code、Cursor、GitHub Copilot、Codex 等 AI 编程助手时，可以直接加载这份汇总地图，而不必让助手在每次对话开始时逐个搜索和阅读大量文件。
codesight 可以免费使用吗？用的什么许可证？
codesight 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
codesight 还在维护吗？
半年内有更新。codesight 最近一次提交是在 2026年7月27日。
codesight 适合用来做什么？
在大型单体仓库中，减少 AI 编程助手每次会话开头加载的上下文。 修改共享模块前，查看会影响哪些文件、路由和模型。 审计代码库中必填与带默认值的环境变量。 让新成员或 AI 代理快速了解一个陌生项目的结构。
在哪里获取 codesight？
源代码和安装说明在 GitHub 上：https://github.com/Houseofmvps/codesight

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目