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

docs(policy): document project-level policy support

Browse Source 
Adds the 'Project' tier (Base 3) to the policy engine documentation.
Updates the priority hierarchy, location table, and formula examples
to reflect the new Project -> User precedence.
This commit is contained in:
Abhijit Balaji
2026-02-09 13:53:54 -08:00
parent 322de4309d
commit f34a3ee1df
1 changed files with 11 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/core/policy-engine.md
+11 -7
View File
@@ -96,7 +96,8 @@ has a designated number that forms the base of the final priority calculation.
| :------ | :--- | :------------------------------------------------------------------------- | | :------ | :--- | :------------------------------------------------------------------------- |
| Default | 1 | Built-in policies that ship with the Gemini CLI. | | Default | 1 | Built-in policies that ship with the Gemini CLI. |
| User | 2 | Custom policies defined by the user. | | User | 2 | Custom policies defined by the user. |
| Admin | 3 | Policies managed by an administrator (e.g., in an enterprise environment). | | Project | 3 | Policies defined in the current project's configuration directory. |
| Admin | 4 | Policies managed by an administrator (e.g., in an enterprise environment). |
Within a TOML policy file, you assign a priority value from **0 to 999**. The Within a TOML policy file, you assign a priority value from **0 to 999**. The
engine transforms this into a final priority using the following formula: engine transforms this into a final priority using the following formula:
@@ -105,7 +106,8 @@ engine transforms this into a final priority using the following formula:
This system guarantees that: This system guarantees that:
- Admin policies always override User and Default policies. - Admin policies always override Project, User, and Default policies.
- Project policies override User and Default policies.
- User policies always override Default policies. - User policies always override Default policies.
- You can still order rules within a single tier with fine-grained control. - You can still order rules within a single tier with fine-grained control.
@@ -113,7 +115,8 @@ For example:
- A `priority: 50` rule in a Default policy file becomes `1.050`. - A `priority: 50` rule in a Default policy file becomes `1.050`.
- A `priority: 100` rule in a User policy file becomes `2.100`. - A `priority: 100` rule in a User policy file becomes `2.100`.
- A `priority: 20` rule in an Admin policy file becomes `3.020`. - A `priority: 10` rule in a Project policy file becomes `3.010`.
- A `priority: 20` rule in an Admin policy file becomes `4.020`.
### Approval modes ### Approval modes
@@ -156,10 +159,11 @@ User, and (if configured) Admin directories.
### Policy locations ### Policy locations
| Tier | Type | Location | | Tier | Type | Location |
| :-------- | :----- | :-------------------------- | | :---------- | :----- | :-------------------------------------- |
| **User** | Custom | `~/.gemini/policies/*.toml` | | **User** | Custom | `~/.gemini/policies/*.toml` |
| **Admin** | System | _See below (OS specific)_ | | **Project** | Custom | `$PROJECT_ROOT/.gemini/policies/*.toml` |
| **Admin** | System | _See below (OS specific)_ |
#### System-wide policies (Admin) #### System-wide policies (Admin)