MediaMetz/gemini-cli
1
0
Fork 0
mirror of https://github.com/google-gemini/gemini-cli.git synced 2026-03-15 00:21:09 -07:00
Code Issues Packages Projects Releases Wiki Activity

Fix: Enable write_file in Plan Mode via workspace policy

Browse Source
This commit is contained in:
Mahima Shanware
2026-02-18 05:27:04 +00:00
parent c1dfcd9a2d
commit 12ee556f3b
11 changed files with 300 additions and 17728 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
docs/cli/plan-mode.md
View File

@@ -119,7 +119,8 @@ from writing to your custom directory by the default safety policies.
#### 1. Configure the directory in `settings.json`
Add the `plan.directory` setting to your `~/.gemini/settings.json` file. This
path can be **absolute** or **relative** to your project root.
path can be **absolute** or **relative** to your project root, and **can be
located outside your project directory**.
```json
{
@@ -144,8 +145,8 @@ passed to the tool.
[[rule]]
toolName = ["write_file", "replace"]
# Allow writing to any path within the "conductor/" directory
# This regex matches a relative path.
argsPattern = "\"(?:file_path|path)\":\"conductor/[^\"]+\""
# This regex matches both relative ("conductor/file") and absolute ("/path/to/conductor/file") paths.
argsPattern = "\"(?:file_path|path)\":\"(?:.*\/)?conductor/[^\"]+\""
decision = "allow"
priority = 100
modes = ["plan"]
@@ -153,15 +154,20 @@ modes = ["plan"]
**Relative vs. Absolute Paths:**
- **Relative Paths:** If you use a relative path like `"conductor"` in
`settings.json`, the agent will typically use `conductor/plan.md`. Your
`argsPattern` should reflect this relative structure.
- **Absolute Paths:** If you use an absolute path like `"/usr/local/plans"`,
your `argsPattern` must match that absolute path:
`\"(?:file_path|path)\":\"/usr/local/plans/[^\"]+\"`.
- **Best Practice:** Use a regex that handles both relative and absolute paths
by making the prefix optional:
`\"(?:file_path|path)\":\"(?:.*\/)?conductor/[^\"]+\"`.
- **Relative Paths:** If the agent uses a relative path (e.g.,
`conductor/plan.md`), the regex `conductor/` matches.
- **Absolute Paths:** If the agent uses an absolute path (e.g.,
`/abs/path/to/conductor/plan.md`), the regex `.*/conductor/` matches.
> **Tip:** For Windows users, the regex pattern must match double-backslashes in
> the JSON-stringified arguments: `conductor\\\\[^"]+`.
> **Tip:** If you choose a directory inside your project, you should add it to
> your `.gitignore` file to avoid accidentally committing temporary plans to
> version control.
> **Tip:** For Windows users, you may need to adjust the regex to match
> backslashes.
### Customizing Planning with Skills