项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1840
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 与 npm(README 用 npm install 安装依赖)
- 现代浏览器(工具为浏览器端 Web 界面)
- 可访问 GitHub 的网络;读取私有仓库需 GitHub Token
- 本地项目可直接选择目录,或准备 zip 压缩包
安装与启动步骤
-
1在线版直接使用
README 提供官方在线地址,无需任何安装即可把仓库转成文本
-
2克隆项目到本地
从 GitHub 拉取 repo2txt 源码,准备本地运行
git clone https://github.com/abinthomasonline/repo2txt.git -
3安装项目依赖
进入项目目录后用 npm 安装依赖,README 的 Run Locally 只给出这一步
cd repo2txt npm install -
4启动并转换仓库
按 package.json 的 scripts 启动本地服务,浏览器打开后填入仓库 URL、选择文件与过滤规则,生成文本复制给 AI
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
GitHub Token | 否 | 访问私有仓库时使用的访问令牌,公开仓库无需填写 | ghp_xxxxxxxxxxxxxxxxxxxx |
如何确认成功
npm install 无报错完成依赖安装;打开工具页面能正常加载界面并输入仓库地址。
常见问题
Q:README 里为什么没有启动命令?
A:README 的 Quick Start 只包含 Run Locally 的 npm install,未给出 dev/build 命令,请查看项目 package.json 的 scripts 字段确认启动方式。
Q:如何转换私有仓库?
A:在工具中填写 GitHub Token 即可支持私有仓库,README 明确标注 GitHub 支持 public and private repositories with token support。
Q:支持哪些输入来源?
A:GitHub、本地文件目录、Zip 拖拽上传,以及 Beta 阶段的 GitLab 和 Azure DevOps。
Q:仓库文件太多会卡吗?
A:README 说明使用虚拟滚动、代码分割、Web Worker 与渐进式加载,可处理 10000+ 文件。
Q:怎样过滤不需要的文件?
A:可按扩展名筛选、自动遵循 .gitignore、自定义忽略模式,并支持按目录挑选。
注意事项
- README 只提供了 npm install,未提供启动与构建命令,本地部署需自行查看 package.json
- 官方已提供在线版 https://abinthomas.in/repo2txt/,多数情况下无需本地部署
- 使用 GitHub Token 时注意保密,不要提交到公开仓库
- README 中提到 repo2txt-classic 为经典版本,如需旧版可另行查看
核心亮点
- 自动递归抓取仓库所有文本文件,并保留目录结构,生成带文件路径标记的单一文本,粘贴给 AI 后上下文清晰。
- 内置忽略规则,自动跳过二进制、图片、锁文件等无关内容,避免污染 AI 上下文。
- 支持自定义导出选项(如包含/排除文件、是否包含 git 历史),灵活适配不同场景。
不足之处
- 仅支持公开仓库,私有仓库需要额外配置或不可用。
- 大仓库可能生成超长文本,超出 AI 上下文窗口限制,需手动拆分或筛选。
适用场景
- 将代码库整体喂给 ChatGPT/Claude 进行架构分析或代码审查。
- 为 AI 编程助手准备完整的项目上下文,提升生成代码的准确性。
- 将仓库内容导出为单一文本,用于离线存档或文档化。
替代项目
gitingest、repomix、code2prompt
同类项目推荐
igniter
开源
让 Elixir 库自动改你的项目,安装配置一步到位
A code generation and project patching framework.
ZCode
开源
让 AI 智能体自主写代码、跑命令、改工程
Z.ai's coding agent harness. Powerful, intelligent, extensible.
carboncode
开源
用 DeepSeek 在终端自动拆任务、写代码,成本省 90%
Carbon Code 是一款类似 Claude Code 的代码开发工具,也是中国第一个基于 DeepSeek 的代码···
harnessclaw-engine
开源
用 Go 打造可嵌入的 LLM 编程助手,支持实时对话与工具调用。
An LLM programming assistant engine built with Go, supporting WebSocket, multi-turn ···
shai
开源
在终端里随时结对编程,快速获得代码建议
shai is a coding agent, your pair programming buddy that lives in the terminal. Writ···
langchain-coder
开源
说人话写代码,多模型生成还能在线跑和修 bug
Web Application that can generate code and fix bugs and run using various LLM's (GPT···
goverter
开源
声明接口签名,自动生成类型安全的 Go 结构体转换代码
Generate type-safe Go converters by defining function signatures.
sample-well-architected-skills-a···
开源
让 AI 写云代码时自动按 AWS 架构最佳实践评审
Reusable skills and steering that teach AI coding agents how to apply the AWS Well-A···
plandex
开源
把大任务拆小,AI 一步步帮你改代码,搞定复杂项目。
Open source AI coding agent. Designed for large projects and real world tasks.
