多目录工作区

多目录工作区适合同一任务需要读取相邻项目、共享规范或组件库的情况。把目录加入工作区与把其全部内容放进每次提示不同；按任务用文件工具或 @path 选择材料。

启动时加入目录

gemini --include-directories ../shared,../docs

也可以重复使用该参数：

gemini --include-directories ../shared --include-directories ../docs

官方配置参考注明该参数最多添加 5 个目录；CLI 速查表只列出数组和逗号/重复参数形式。更高数量的支持以所用版本和官方更新为准，不据此推断所有加入目录的方式都有同一限制。

会话内添加与查看

/directory add ../shared,~/project-notes
/directory show

/dir 是 /directory 的别名。add 支持相对当前工作目录、绝对路径和 home 路径；show 展示通过命令和启动参数加入的目录。

限制较强的 sandbox profile 会禁用会话内 add。此时在启动时用 --include-directories 声明所需目录，按沙箱配置检查实际访问范围。

持久配置与记忆加载

{
  "context": {
    "includeDirectories": ["../shared", "../docs"],
    "loadMemoryFromIncludeDirectories": true
  }
}

context.includeDirectories 默认空数组，不存在的目录会被跳过并给出警告。context.loadMemoryFromIncludeDirectories 默认 false；设置为 true 后，重新加载记忆会扫描附加目录中的 GEMINI.md。

官方配置参考的大段示例还出现 loadFromIncludeDirectories，但字段定义和官方 settings Schema 使用 loadMemoryFromIncludeDirectories，本页采用后者。配置参考将重载命令写为 /memory reload，命令参考列出 /memory refresh；按当前版本的补全确认可用入口，再用 /memory list 和 /memory show 检查结果，见记忆文件。