Skip to content
Google Antigravity Docs

Explore Antigravity

Getting StartedInstall & launch your first agentRemote ControlDrive desktop & CLI sessions from any browserAgent Skills & RulesReusable workflows & workspace instructionsSubagents & TeamworkParallel multi-agent orchestrationAntigravity SDKBuild custom Python agents & hooksPermissions & SandboxFile access controls & safe execution
Try searching
    Remote Control
    NewIntroducing the Plugin Marketplace in Google AntigravityRead post
    Plugins2-0Antigravity AppFeaturesPlugins Antigravity App FeaturesAntigravity AppAntigravity CLIAntigravity IDE
    Available on:
    Antigravity AppAntigravity CLIAntigravity IDE

    Plugins

    Section titled “Plugins”

    Plugins package reusable skills, Model Context Protocol (MCP) servers, custom agents and subagents, rules, and lifecycle hooks into a single versioned unit. You can install curated plugins from the Antigravity Marketplace, install plugins from a GitHub repository or local directory, or build and publish your own plugins.

    GoalGuide
    Browse the Marketplace catalogMarketplace — discover, install, and configure Google and partner plugins in the App and CLI.
    Use and manage installed pluginsThis page — learn what plugins bundle, how to use installed plugins, and how to manage plugins by surface.
    Build, validate, and publish a pluginBuild plugins — follow the 3-step quickstart, plugin.json manifest schema, component authoring guides, agy plugin validate --strict, and Marketplace submission.

    What a plugin bundles

    Section titled “What a plugin bundles”

    A single plugin can bundle any combination of five customization components:

    ComponentHow it extends Antigravity
    SkillsTask-specific workflows, helper scripts, and reference docs loaded on demand or invoked explicitly via /<skill-name>.
    MCP serversRemote HTTPS or local stdio Model Context Protocol tool servers (<plugin-name>_<server-name>), including OAuth sign-in and user-prompted API key variables.
    Custom agents & subagentsSpecialized agents with dedicated system prompts, model tiers, and tool allowlists that can run as background subagents or as your primary session agent.
    RulesPersistent coding conventions, architectural constraints, or file-glob-scoped instructions.
    Lifecycle hooksSynchronous shell commands or prompt evaluations that inspect, block, or augment agent lifecycle events and tool calls.

    Using installed plugins

    Section titled “Using installed plugins”

    Once a plugin is installed and enabled, its bundled components are available across your workspace sessions automatically:

    Starter prompts and skills

    Section titled “Starter prompts and skills”

    • Starter prompt chips: In the Antigravity App (Customizations > Marketplace or Customizations > Installed), open a plugin’s detail page and click any suggested prompt chip at the top of the page to start a guided task immediately:

      Plugin detail view showing starter prompt chips, component tabs, and README documentation

    • Automatic skill loading: Describe your task in natural language. At session startup, Antigravity loads only the name and description of each enabled plugin skill and reads the full SKILL.md instructions on demand when your prompt matches.

    • Slash command invocation: Type /<skill-name> in chat (for example, /dart-add-unit-test or /hello) to trigger a plugin skill explicitly.

    MCP tools and credential setup

    Section titled “MCP tools and credential setup”
    • Calling MCP tools: Ask the agent to query or act on the connected service (such as Firebase, Dart and Flutter, Stripe, Datadog, Figma, or Jira). Bundled MCP tools are namespaced as <plugin-name>_<server-name>.
    • API keys and configuration variables: If a plugin declares required configuration variables (such as an API token or project URL), installing the plugin via the CLI leaves it disabled until configured. Toggling the plugin on in Customizations > Installed (or pressing Space on the plugin in the CLI’s /plugin Installed tab) opens a setup dialog prompting for each variable.
    • OAuth sign-in: If a plugin uses OAuth 2.0 without required configuration variables, it installs in an enabled state and prompts you in the browser to complete sign-in when its MCP server connects.

    Custom agents and subagents

    Section titled “Custom agents and subagents”
    • Automatic background delegation: When subagent: true (the default), the primary agent automatically delegates specialized tasks—such as security reviews, accessibility audits, or framework migrations—to the plugin’s bundled subagents in the background.
    • Running a plugin agent directly: When mainAgent: true (the default), you can select the plugin’s custom agent as your primary session agent:
      • Antigravity App: Choose the agent from the agent selector in the conversation view or under Customizations > Installed > Custom Agents.
      • Antigravity CLI (interactive): Run /agents to inspect and switch agents.
      • Antigravity CLI (shell): List all available agents (including plugin agents) and launch a session with a specific agent: 
        # List built-in, workspace, and plugin agents
agy agents

# Start an interactive or headless session with a plugin agent
agy --agent <agent-name>

    Rules and lifecycle hooks

    Section titled “Rules and lifecycle hooks”
    • Rules: Always-on plugin rules and glob- or model-triggered rules apply automatically whenever the plugin is enabled.
    • Lifecycle hooks: Bundled PreToolUse, PostToolUse, SessionStart, and Stop hooks run automatically in the background while the plugin is enabled.

    Managing plugins by surface

    Section titled “Managing plugins by surface”

    Follow the instructions below to install, configure, enable, disable, or uninstall plugins on your preferred surface:

    Antigravity App

    Section titled “Antigravity App”

    Browse and manage plugins in the App

    Section titled “Browse and manage plugins in the App”

    1. Open the Customizations tab, located below Automations in the left sidebar.

    2. Use the top segmented toggle to switch between Marketplace (all available plugins) and Installed (your installed plugins, skills, rules, and custom agents):

      Installed plugins tab in Customizations

    3. In the Marketplace tab, click + on a plugin card to install it, or click the card to inspect its starter prompts, Overview, Skills, MCP, Agents, and Rules tabs before clicking Add.

    4. In the Installed tab, click the ⋮ menu beside any plugin (or open the plugin card) to enable, disable, or uninstall it.

    For a complete step-by-step walkthrough with screenshots, refer to the Marketplace guide.

    Manual plugin installation

    Section titled “Manual plugin installation”

    You can also install custom or local plugins by placing their directories in either of the following locations:

    • Workspace level: Place your plugin folder in .agents/plugins/ at the root of your workspace. The plugin activates only when working in that project.
    • Global level: Place your plugin folder in ~/.gemini/config/plugins/. The plugin activates across all workspaces on your workstation.

    Build and publish your own plugin

    Section titled “Build and publish your own plugin”

    A plugin is a self-contained directory defined by a plugin.json manifest (or .antigravity-plugin/plugin.json) alongside optional skills, MCP server configurations, custom agents, rules, and lifecycle hooks:

    {
  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
  "name": "my-first-plugin",
  "displayName": "My First Plugin",
  "version": "1.0.0",
  "description": "Starter plugin that bundles custom skills and MCP tools.",
  "logo": "assets/logo.svg",
  "suggestedPrompts": [
    "Run a readiness check on the current project"
  ]
}

    Ready to create a custom plugin for your team or publish a partner integration to the Antigravity Marketplace? Continue to Build plugins for: