Skip to content

docs: migrate Gemini CLI documentation to Antigravity CLI#5252

Open
HARSHVARANDANI wants to merge 2 commits into
lima-vm:masterfrom
HARSHVARANDANI:docs/antigravity-cli
Open

docs: migrate Gemini CLI documentation to Antigravity CLI#5252
HARSHVARANDANI wants to merge 2 commits into
lima-vm:masterfrom
HARSHVARANDANI:docs/antigravity-cli

Conversation

@HARSHVARANDANI

Copy link
Copy Markdown

What This PR Changes

Updates the AI documentation to reflect the migration from Gemini CLI to Antigravity CLI.

Specifically, this PR:

  • Replaces the Gemini CLI setup instructions in the AI agents example with Antigravity CLI.
  • Renames the dedicated configuration guide from gemini.md to antigravity.md.
  • Updates the installation commands, CLI invocation (agy), documentation links, and MCP configuration to match the current Antigravity CLI documentation.
  • Removes outdated Gemini-specific configuration and permissions references.

Linked Issue (Required in most cases)

Closes #5249

How I Tested This

N/A

AI Usage

Assisted-by: ChatGPT (GPT-5.5) — used to cross-check the Antigravity CLI installation commands, MCP configuration, and documentation links against the official documentation. All changes were manually reviewed before submission.

Signed-off-by: HARSHVARANDANI <hpvarandani@gmail.com>
Signed-off-by: HARSHVARANDANI <hpvarandani@gmail.com>
3. Modify `~/.gemini/antigravity-cli/settings.json` to configure the permissions granted to Antigravity CLI. For example:
```json
{
"coreTools": ["WebFetchTool", "WebSearchTool", "MemoryTool"]

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why not allow the equivalents of these tools?
e.g. read_url execute_url
https://antigravity.google/docs/cli/permissions

"allow": [],
"ask": [],
"deny": []
}

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesn't it need to allow mcp for our MCP server?

How did you test these permissions?

{{% /tab %}}
{{% tab header="Antigravity" %}}
```bash
lima curl -fsSL https://antigravity.google/cli/install.sh | bash

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you really test this?
curl is executed inside the VM, but bash is not.

@HARSHVARANDANI HARSHVARANDANI Jul 15, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm sorry I wasnt aware of this
is this the correct method?

lima sh -c 'curl -fsSL https://antigravity.google/cli/install.sh | bash'
lima agy

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, but please confirm how you tested this PR.

|----------------|-------------|

The `--sync` flag for [`limactl shell`](../reference/limactl_shell) enables bidirectional synchronization of your host working directory with the guest VM. This is particularly useful when running AI agents (like Claude, Copilot, or Gemini) inside VMs to prevent them from accidentally modifying or breaking files on your host system.
The `--sync` flag for [`limactl shell`](../reference/limactl_shell) enables bidirectional synchronization of your host working directory with the guest VM. This is particularly useful when running AI agents (like Claude, Copilot, or Antigravity) inside VMs to prevent them from accidentally modifying or breaking files on your host system.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This line needs to be updated too

Lima is useful for running AI agents (e.g., Claude Code, Codex, Gemini)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we actually have to keep these ads (and maintain them)? There is another one for AGENTS.md

@AkihiroSuda AkihiroSuda left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please verify the content before submission
#5252 (comment)


Follow the guide shown in the first session for authentication.

Authentication uses your browser (or an authorization URL when running over SSH), so no additional environment variable configuration is typically required.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"when running over SSH" is always true, no?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I took that line from the antigravity docs but yeah this will always be true in this case since the commands are executed over ssh in lima so we can change it to the same that it was before

Follow the guide shown in the first session for authentication.

Or should we specifically mention this?

@AkihiroSuda AkihiroSuda added the documentation Improvements or additions to documentation label Jul 15, 2026
@@ -1,16 +1,16 @@
---
title: Gemini
title: Antigravity

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The old /gemini URL should redirect to the new /antigravity URL?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I renamed the file to antigravity.md because the _index.md page automatically lists the pages in that directory using their front matter/title, and keeping the file as gemini.md would have been confusing given that the page now documents Antigravity CLI.
The URL doesn't redirect automatically. If we want to preserve that URL, we could add a Hugo aliases entry to the new page. I didn't do that because I wasn't sure it was necessary for this particular documentation page, especially since I couldn't find any references to the old URL in the repository. If you'd prefer to keep the old URL working, I'm happy to add the alias as well.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a Hugo aliases entry

👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(ai): replace deprecated Gemini CLI example with Antigravity CLI

3 participants