Mete Atamel

Antigravity (AGY) has an extensive permission system that defines how the agent should behave and what it has access to. However, these permissions are scattered across different settings and saved in various files that might make reasoning them difficult.

In this post, I’ll deep dive into these permission settings and share my learnings.

Permission Hierarchy

Before looking at the permission settings in detail, it’s important to note that the permissions in AGY are organized in a hierarchy:

💡 This post is the concluding summary of a series on Antigravity configuration:

• Where does Antigravity look for Skills?
• Where does Antigravity look for MCP Servers?
• Where does Antigravity look for Rules and Workflows?
• Where does Antigravity look for Hooks?
• Where does Antigravity look for Sidecars?
• Where does Antigravity look for Agents?
• Where does Antigravity look for Plugins?

Over the past few weeks, I explored the ways to configure and extend Google Antigravity (AGY). What started as a simple exploration into agent skills quickly grew into a journey uncovering MCP servers, rules, workflows, lifecycle hooks, background sidecars, custom agents, and plugins.

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

Custom Agents have been recently announced in Antigravity (AGY). In today’s post, I’ll explore how to configure and use Custom Agents.

Custom Agents

Custom Agents in AGY are a way to create customized agents that can be used as main or sub-agents. This can be useful to limit the agent to a particular role with its specialized instructions, tools, and constraints. Currently, custom agents are only supported in AGY and AGY CLI, but not in AGY IDE.

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

I’ve been exploring how to configure and extend Antigravity (AGY).

In today’s post, I’ll explore Plugins, yet another way of configuring AGY. We’ll also explore Build with Google plugins and the differences between AGY plugins and Agent plugins.

Plugins

Plugins in AGY are a way to package and group **Agents, Skills, MCP Servers, Rules, and Hooks together. This can be useful when you want to distribute and install a collection of these configuration options in one go. It’s also another way of configuring and extending AGY.

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

Sidecars are a less known feature of Antigravity (AGY) with limited samples and documentation but still worth knowing about and that’s the topic of today’s post.

Sidecars

Sidecars are background processes that can run alongside AGY with their lifecycle managed by AGY. They can be useful to run background scripts (e.g. sending telemetry data) or recurring tasks that you want to run on a schedule (e.g. summarize across sessions).

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

In today’s post, I’ll talk about Hooks in Antigravity, what they are, how to configure them, and some shortcomings.

Hooks

Hooks allow you to run custom scripts or programs at specific points in the Antigravity agent lifecycle, such as before or after model or tool calls. They are a way to extend the functionality of the agent. Hooks run synchronously as part of the agent loop and they can be useful for things like adding context, validating actions, enforce policies or logging interactions.

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

I’ve been exploring different ways of customizing Antigravity and where it saves its various configuration files. For Agent Skills, see Where does Antigravity look for Agent Skills? and for MCP Servers, see Where does Antigravity look for MCP Servers?.

In today’s post, I’ll revisit Rules and Workflows. Back in November, I blogged about them in Customize Google Antigravity with rules and workflows but a few things changed since then, so let’s do a refresh.

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

In my previous post, I explored where Antigravity (AGY) looks for agent skills. In this post, I’ll briefly explore the same for Model Context Protocol (MCP) servers and mention the MCP server caching that’s worth knowing about.

MCP Configuration

AGY docs on MCP: https://antigravity.google/docs/mcp

Thankfully, MCP server configuration is more straightforward than skills. There are two places for MCP configuration:

ℹ️ Note

This post blog is part of a series, see Summary : Where does Antigravity look for configurations?

Skills are an open standard for extending agent capabilities. A skill is a folder containing a SKILL.md file with instructions that the agent can follow when working on specific tasks.

Antigravity (AGY) also supports agent skills, but it’s not obvious at all where to save these skills. This is mainly because:

In my Agent Protocols - MCP, A2A, A2UI, AG-UI post, I provided a high-level overview of some of the main agent protocols: MCP, A2A, A2UI, and AG-UI. In the Agent-User Interaction Protocol (AG-UI) with Agent Development Kit (ADK) post, I zoomed into the AG-UI protocol and showed how it can be used with Google’s Agent Development Kit (ADK).

In today’s post, I’ll zoom into the A2UI protocol and show how it can be used with Google’s Agent Development Kit (ADK).