repo2txt

一键把 GitHub 仓库变成单个文本,直接喂给 AI 助手。

repo2txt 是一个基于 Web 的工具,用于将 GitHub 仓库的完整内容转换为单个格式化的文本文件。它解决了开发者需要将整个代码库上下文提供给 AI 助手(如 ChatGPT、Claude)时,手动复制粘贴文件效率低下的问题。用户只需输入仓库 URL,工具会自动抓取所有文件,并按照清晰的目录结构和文件分隔符生成一个统一的文本文件,方便直接粘贴到对话中或保存。核心能力包括:支持公开仓库、自动忽略二进制和无关文件、保留文件路径和语法标记、可配置导出选项。它基于 TypeScript 构建,界面简洁,操作直观,是 AI 辅助编程工作流中的实用预处理工具。

开源 unknown 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1839
维护状态 维护中
是否开源
定价模式 unknown

项目数据

分类对话助手
开发团队abinthomasonline
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议
主要语言TypeScript
技术栈/模型ai,anthropic,chatgpt,developer-tools,devtools,llm
GitHub 星标★ 1839
30天Star增速
HF 下载量
上线时间2024-09-23 00:00:00
最近更新2026-09-23 00:00:00
维护状态维护中
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 4 步

环境要求

  • Node.js 与 npm(README 用 npm install 安装依赖)
  • 现代浏览器(工具为浏览器端 Web 界面)
  • 可访问 GitHub 的网络;读取私有仓库需 GitHub Token
  • 本地项目可直接选择目录,或准备 zip 压缩包

安装与启动步骤

  1. 1在线版直接使用

    README 提供官方在线地址,无需任何安装即可把仓库转成文本

  2. 2克隆项目到本地

    从 GitHub 拉取 repo2txt 源码,准备本地运行

    git clone https://github.com/abinthomasonline/repo2txt.git
  3. 3安装项目依赖

    进入项目目录后用 npm 安装依赖,README 的 Run Locally 只给出这一步

    cd repo2txt
    npm install
  4. 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

项目介绍

repo2txt 是编程开发领域的开源项目,由 abinthomasonline 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,839)位列前 30%,在编程开发分类中处于中上游。

项目仍在小幅维护中,最近一次代码更新于 2026-09-23。从国内网络环境看,可直接访问。

它主要面向的使用场景是:将代码库整体喂给ChatGPT/Claude进行架构分析或代码审查。同类可对比的替代方案包括 gitingest、repomix、code2prompt。

同类项目推荐

bolt.new 开源

想到啥说啥,网页应用当场生成直接能用

Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···

★ 16557 2026-08-09
fuzz4all 开源

用大模型自动生成测试输入,发现各种软件漏洞

️Fuzz4All: Universal Fuzzing with Large Language Models

★ 338 2026-08-09
superpowers-zh 开源

全套 AI 编程神技汉化好了,照着用就行。

AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···

★ 8188 2026-08-09
Gitea 代码托管 开源

轻量 Git 代码托管平台

Git with a cup of tea! Painless self-hosted all-in-one software development service,···

★ 58115 2026-08-22