GEMINI.md 是什么？
Gemini CLI 的规则文件
你在仓库里看到一个 GEMINI.md,或者 Gemini CLI 提到了它。它是 Google 给 Gemini CLI 的上下文和规则文件:一个 Markdown 文件,告诉 Gemini 怎么在你项目上干活——技术栈、约定、要跑的命令。
和 CLAUDE.md 之于 Claude Code、.cursorrules 之于 Cursor 是一个思路,只是 Gemini 自己的名字。这就是里面写什么、放在哪、怎么加载。
GEMINI.md 里写什么
GEMINI.md 装的和每个 AI 规则文件一样:你的技术栈和架构、代码约定和风格、构建和测试的命令、以及 agent 该碰和不该碰的边界。它是纯 Markdown,所以就是用标题和列表描述你的项目。要写一个,语法看 Markdown 怎么写。
GEMINI.md 放哪、怎么加载
Gemini CLI 分层读 GEMINI.md:先找主目录里一个全局的(~/.gemini/)、项目根一个,还能沿目录树往上捡 GEMINI.md,再合成一份上下文。这种分层让你把宽泛的规则放全局、具体的放各项目。对一个仓库来说,文件就放在根目录。
GEMINI.md 和其他规则文件
几乎每个 AI 编程工具都有自己这么一个文件。GEMINI.md 是 Gemini 的:
| 工具 | 它的规则文件 | 出自 |
|---|---|---|
| Gemini CLI | GEMINI.md | Google 的终端编程 agent |
| Claude Code | CLAUDE.md | Anthropic |
| Cursor | .cursorrules 或 .cursor/rules/*.mdc | Cursor 编辑器 |
| 跨工具 | AGENTS.md | 通用开放标准 |
Gemini CLI 也认 AGENTS.md 这个跨工具开放格式,所以想要一个多数 agent 都读的文件,那个更保险。按工具的完整地图看 我的 AI 工具读哪个规则文件;里面写什么看 AGENTS.md、CLAUDE.md 是什么;Cursor 的版本看 .cursorrules 是什么。
用 NoteLoom 读、改 GEMINI.md
GEMINI.md 就是纯 Markdown,读它只是读 Markdown。NoteLoom 在浏览器里打开你的项目文件夹,把它在干净的 reading 视图里渲染出来,当你是给 Gemini 写规则的那个人时,在 source 视图里改。
先说清边界:NoteLoom 没有任何 AI,也不连接 Gemini CLI 或任何编程工具。它只打开、渲染、存回本地的 Markdown 文件;Gemini 听不听规则,在你和 CLI 之间。
用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc,挂载你的项目文件夹,打开 GEMINI.md 读或改。直接存回本地,不上云、不用账号。
FAQ
GEMINI.md 文件是什么？
GEMINI.md 放在哪？
GEMINI.md 该写什么？
GEMINI.md 和 AGENTS.md 一样吗？
NoteLoom 能帮我读写 GEMINI.md 吗？
手机或 Safari 能用 NoteLoom 弄吗？
把你的 GEMINI.md 干净地读一遍
用 Chrome / Edge / Arc 打开 NoteLoom,挂载你的项目文件夹,把它的 GEMINI.md 当干净排版读或改。直接存回本地,不用装软件,也不用注册账号。