AI 读你的代码库，为什么这么慢？

你打开 Claude / Cursor，问它改个功能。它先回你一句：

"让我先探索一下你的项目结构……"

然后它一个文件一个文件地翻，烧掉几千 token，才开始干活。每次对话都重来一遍。

repodex 一行命令解决这件事。

npx repodex

跑完，它把整个代码库压成一张「结构地图」——技术栈、文件树、函数签名、调用关系——注入进 CLAUDE.md。AI 一打开就看见全局，不再探索，直接动手。

#Before / After

没有 repodex： AI 盲翻文件，烧 token，还经常改错地方。

有了 repodex： AI 开局就拿到这个（整个项目，1% 的 token）：

# File Tree
├── src/
│   ├── auth/
│   │   ├── login.ts
│   │   └── session.ts
│   └── logs/
│       └── [id].json ×128          ← 128 个同构文件折成一行

# Signatures
<file path="src/auth/login.ts">
export async function login(email: string, password: string): Promise<Session>
</file>

它知道 login 在哪、签名长啥样、谁调用它——在写第一行代码之前。

#30 秒上手

# 1. 装（开发依赖）
npm i -D repodex

# 2. 跑
npx repodex

第一次跑，它会自动：

• 检测你已有的 AI 上下文文件（CLAUDE.md、AGENTS.md、.cursorrules…）
• 插入注入标记
• 写一份 repodex.config.ts

就这样。 下次 AI 对话，它已经懂你的项目了。

#还有什么

• Token 预算：设 maxTokens，repodex 按「git 改动频率 + 被引用次数」自动给文件打分，高信号文件留全签名，低信号的降级或丢弃——永远不超预算。
• 调用图：npx repodex impact <函数名> 告诉 AI「改这个会连锁影响谁」，改代码前先看清爆炸半径。
• Vite 插件：开发服务器一起跑，源码一改自动重新注入。

→ 完整配置和 API 见 README

一行命令，AI 从此直接干活。

npx repodex