项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3031
使用教程
环境要求
- Node.js 环境（使用 npm 全局安装 CLI 需要）
- Node.js 24+、pnpm 11（仅从源码开发时需要）
- Rust/Cargo（仅编译 packages/opensrc/cli 时需要）
- ripgrep（示例中的 rg 搜索命令依赖它）
安装与启动步骤
-
1安装 opensrc CLI
用 npm 全局安装 opensrc，装好后即可在任意目录调用 opensrc 命令。
npm install -g opensrc -
2获取包源码路径
以 zod 为例，首次执行会拉取源码并缓存，之后直接返回本地路径。
opensrc path zod -
3在源码中搜索
把路径命令的输出作为目录交给 rg，就能在依赖源码里搜索关键字。
rg "parse" $(opensrc path zod) -
4读取指定文件
在返回的路径后拼接文件相对路径，用 cat 查看具体实现。
cat $(opensrc path zod)/src/types.ts -
5使用其他源
支持 PyPI 等源，用 pypi: 前缀指定包名，再用 find 查找文件。
find $(opensrc path pypi:requests) -name "*.py" -
6搭建开发环境
参与开发时先装依赖再用 turbo 构建，仓库为 pnpm 工作区单仓。
pnpm install turbo build -
7构建 Rust CLI
修改 CLI 后可单独编译 Rust 侧代码进行验证。
cargo build --manifest-path packages/opensrc/cli/Cargo.toml
如何确认成功
执行 opensrc path zod 能返回本地缓存路径，且该路径下能看到 zod 源码文件即为成功。
常见问题
Q：第一次执行为什么较慢？
A：首次使用会从对应源下载并缓存源码，之后同一包会直接返回缓存路径，速度很快。
Q：支持哪些包源？
A：README 说明支持 npm、PyPI、crates.io 和 GitHub；非 npm 源用前缀指定，例如 pypi:requests。
Q：怎么进入开发模式？
A：仓库是 pnpm + Turborepo 单仓：pnpm install 后执行 turbo build 或 turbo dev，Rust CLI 用 cargo 命令构建。
Q：怎么让 AI 代理用上源码？
A：用 $(opensrc path <包名>) 把缓存路径传给搜索或阅读命令，代理即可基于真实实现推理。
注意事项
- opensrc path 首次使用会拉取源码并缓存，后续直接返回缓存路径。
- 示例里的 $(opensrc path <包名>) 属于 bash 命令替换，其他终端需改用对应写法。
- 开发环境要求 Node.js 24+ 与 pnpm 11。
核心亮点
- 专为AI编程代理设计，直接抓取npm包源码，显著提升代码生成的上下文理解能力
- Rust实现，性能高效，支持CLI操作，可无缝集成到现有AI编码工作流
- 聚焦npm生态，解决AI代理对依赖源码的访问痛点，定位清晰且实用性强
不足之处
- 仅支持npm包，对Python、Java等其他语言生态覆盖不足
- 项目处于成长阶段，文档和社区支持有待观察
适用场景
- AI编程代理（如Copilot、Cursor）需要深入理解第三方库实现时
- 开发者调试npm依赖问题，需快速查看源码逻辑
- 构建本地代码知识库，为LLM提供精准的源码级训练或检索数据
替代项目
sourcegraph、grep.app、npm-source-fetcher
上一篇：crystal
下一篇：teaql-agent-kit
同类项目推荐
arbor
开源
用代码调用图替代向量检索，让 AI 精准读懂你的项目
Graph-native code intelligence that replaces embedding-based RAG with deterministic ···
dora
开源
让 AI 代理像专家一样快速定位代码，告别低效 grep。
CLI built for AI agents to help navigate codebases better. An alternative to grep/fi···
code-assistant
开源
多模型自主编程代理，能自己读代码改代码
An LLM-powered, autonomous coding assistant. Also offers an MCP and ACP mode.
github-copilot-agent-skills
开源
抄作业式 Copilot 技能模板，拿来就能改
Repo containing my GitHub Copilot Agent & Skills - continually experimenting!
codex-orange-book
开源
跟着橙皮书，从零上手 Codex，AI 编程少走弯路
OpenAI Codex: The Complete Guide · 橙皮书系列 · GPT-5.5 时代的 AI 编程实战手册
copilot-instructions
开源
给 Copilot 立规矩，让 AI 按 DDD 和整洁架构写代码
A comprehensive codebase of best practices, coding rules, and workflow automation fo···
spec-superflow
开源
先定规格再写码，AI 编程不跑偏
源码级融合 OpenSpec 规划引擎 + Superpowers 执行纪律的 AI 编程工作流插件。17 平台支持···
cli-printing-press
开源
输入API规范，自动生成AI友好的全能CLI工具，支持离线搜索。
Every API has a secret identity. This finds it, absorbs every feature from every com···
cc-switch-cli
开源
一条命令切换 Claude Code、Codex、Gemini 的配置与供应商
⭐️ A cross-platform CLI All-in-One assistant tool for Claude Code, Codex & Gemini ···