newspaperPress Guidelines
Pricing
Blog
Downloaddownload

Explore our next generation products

See overview

Products

antigravityAntigravity 2.0terminalAntigravity CLIcodeAntigravity IDEsdkAntigravity SDK

Built for developers in the agent-first era

See overview
EnterpriseFrontendFullstackScienceMarketer

Everything you need to stay up-to-date and get help

Documentationkeyboard_arrow_rightChangelogSupportPressReleases

Explore our next generation products

See overview

Products

antigravityAntigravity 2.0terminalAntigravity CLIcodeAntigravity IDEsdkAntigravity SDK

Built for developers in the agent-first era

See overview
EnterpriseFrontendFullstackScienceMarketer
Pricing
Blog

Everything you need to stay up-to-date and get help

Documentationkeyboard_arrow_rightChangelogSupportPressReleases
Home
Antigravity 2.0v2.3.1keyboard_arrow_right
Overview
Getting Started
Build with Google
Feature Overview
Models
Projects
Settingskeyboard_arrow_right
Overview
Agent Settings
Artifact Review
Customizationskeyboard_arrow_right
MCP
Skills
Rules
Plugins
Hooks
Sidecars
Agent Capabilitieskeyboard_arrow_right
Permissions
Subagents
Artifactskeyboard_arrow_right
Overview
Plan
Walkthrough
Screenshots
Antigravity CLIv1.1.5keyboard_arrow_right
Overview
Getting Started
Installation & Auth
Tutorial
Using AGY CLI
Features
Gemini Migration
Prompting
Artifactskeyboard_arrow_right
Overview
Conversations
Agent Capabilitieskeyboard_arrow_right
Choose an execution mode
Subagents
Sandbox
Permissions
Projects
Settingskeyboard_arrow_right
Overview
AI Credits
Customizationskeyboard_arrow_right
MCP
Plugins & Skills
Status Line
Window Title
Commandskeyboard_arrow_right
Agents (/agents)
Code Search (/codesearch)
AI Credits (/credits)
Diff (/diff)
Permissions (/permissions)
Resume (/resume)
Status Line (/statusline)
Window Title (/title)
Model Quotas (/usage, /quota)
Best Practices
Troubleshooting
Reference
Antigravity SDKv0.1.7keyboard_arrow_right
Overview + Quick Start
Customizationskeyboard_arrow_right
MCP
Antigravity IDEv2.1.1keyboard_arrow_right
Overview
Getting Started
Featureskeyboard_arrow_right
Tab
Side Panel
Review Changes
Artifactskeyboard_arrow_right
Plan
Walkthrough
Screenshots
Browser Recordings
Browserkeyboard_arrow_right
Overview
Allowlist / Denylist
Separate Chrome Profile
Customizationskeyboard_arrow_right
MCP
Skills
Rules
Workflows
Plugins
Hooks
Settings
Migrationkeyboard_arrow_right
Firebase Studio Migration
Enterprise
Plans
FAQ
  • side_navigation
  • Antigravity CLI
  • >
  • Commands
  • >
  • Permissions (/permissions)

Permissions Command (/permissions)link

Manage your fine-grained agent permission rules interactively within the TUI.

Overviewlink

Antigravity CLI uses a fine-grained permissions engine to secure your workstation. While you can configure these rules manually in your settings file, the /permissions command opens an interactive Permissions Manager TUI panel to view, add, edit, and delete rules live.
For details on how the permission engine works, supported actions, and manual configuration, see the conceptual Permissions Guide.

Managing permissions interactivelylink

To open the Permissions Manager:
  1. Type /permissions in the prompt box.
  2. Press Enter.
text
/permissions

Navigation and controlslink

The Permissions Manager operates in three panels:
  1. Scope Picker: Select the configuration scope you want to edit:
  • Project: Rules applying only to the active project (disabled if no project is open).
  • Shared: Rules shared across all Antigravity products.
  • Global: Global rules applying to all your sessions.
Use ↑/↓ (or j/k) to navigate, Enter to select, and Esc to exit.
  1. Rule Viewer: View the rules configured for the selected scope.
  • Switch between allowlist, denylist, and asklist tabs using ←/→ (or Tab).
  • Scroll through the rules using ↑/↓ (or j/k).
  • Press a to add a new rule.
  • Press e (or Ctrl+G) to edit the highlighted rule.
  • Press d (or Backspace) to delete the highlighted rule.
  • Press Esc to return to the Scope Picker.
  1. Add/Edit Rule: Type or edit a rule in the input field.
  • Rules must follow the action(target) format (e.g., command(git)).
  • Press Enter to validate and save the rule.
  • Press Esc to cancel.
---

Step-by-step walkthroughlink

Here is how to view, add, edit, and delete rules live in the TUI.

1. Selecting a scope and viewing ruleslink

When you run /permissions, you first see the Scope Picker. Select Global to manage your global rules:
Selecting Global Scope
Press Enter to open the Rule Viewer for the selected scope. You can use ←/→ to switch between the allow, deny, and ask tabs:
Global Rule Viewer

2. Adding a permission rulelink

To allow the agent to run git commands automatically without prompting:
  1. In the Rule Viewer, press a. The Add Rule panel opens at the bottom:
Add Rule Panel
  1. Type command(git) in the input field:
Typing the Rule
  1. Press Enter. The rule is validated and saved. You are returned to the Rule Viewer, and command(git) now appears in your allowlist:
Rule Saved Successfully

3. Editing a permission rulelink

If you want to restrict the agent so it can only run git diff automatically, you can edit the rule:
  1. In the Rule Viewer, use ↑/↓ to highlight command(git).
  2. Press e (or Ctrl+G). The input panel opens, prefilled with command(git).
  3. Modify the text to command(git diff).
  4. Press Enter to save. The old rule is replaced by the new one.

4. Deleting a permission rulelink

To remove a rule and revert to prompting for those actions:
  1. In the Rule Viewer, highlight the rule you want to delete (e.g., command(git diff)).
  2. Press d (or Backspace).
  3. The rule is immediately removed from the list.

Next stepslink

  • Permissions Guide: Learn about the security model, action types, and wildcard matching.
  • Sandbox & Security: Configure the native OS container for running commands.
  • CLI Reference: See all available slash commands and keybindings.
Diff Command (/diff)
Resume Command (/resume)
On this Page
Permissions Command (/permissions)OverviewManaging permissions interactivelyStep-by-step walkthroughNext steps