Skip to content

docs: migrate Gemini CLI documentation to Antigravity CLI #5252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
HARSHVARANDANI wants to merge 2 commits into
base: master
Choose a base branch
from
Open

docs: migrate Gemini CLI documentation to Antigravity CLI #5252

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8b5967b
docs: replace Gemini CLI example with Antigravity CLI
HARSHVARANDANI Jul 15, 2026
963548c
docs: migrate Gemini CLI guide to Antigravity CLI
HARSHVARANDANI Jul 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 12 additions & 11 deletions ...ntent/en/docs/config/ai/outside/gemini.md → .../en/docs/config/ai/outside/antigravity.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
---
title: Gemini
title: Antigravity

@AkihiroSuda AkihiroSuda Jul 15, 2026

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?

@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 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.

@AkihiroSuda AkihiroSuda Jul 18, 2026

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

👍

weight: 20

---

| ⚡ Requirement | Lima >= 2.0 |
|---------------|-------------|

This page describes how to use Lima as an sandbox for [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
This page describes how to use Lima as a sandbox for [Google Antigravity CLI](https://github.com/google-antigravity/antigravity-cli).

## Prerequisite
In addition to Gemini and Lima, make sure that `limactl mcp` plugin is installed:
In addition to Antigravity CLI and Lima, make sure that `limactl mcp` plugin is installed:

```console
$ limactl mcp -v
Expand All @@ -28,11 +28,9 @@ limactl start --mount-only "$(pwd):w" default

Drop the `:w` suffix if you do not want to allow writing to the mounted directory.

2. Create `.gemini/extensions/lima/gemini-extension.json` as follows:
2. Create `~/.gemini/antigravity-cli/mcp_config.json` as follows:
```json
{
"name": "lima",
"version": "2.0.0",
"mcpServers": {
"lima": {
"command": "limactl",
Expand All @@ -46,15 +44,18 @@ Drop the `:w` suffix if you do not want to allow writing to the mounted director
}
```

3. Modify `.gemini/settings.json` so as to disable Gemini CLI's [built-in tools](https://github.com/google-gemini/gemini-cli/tree/main/docs/tools)
except ones that do not relate to local command execution and file I/O:
3. Modify `~/.gemini/antigravity-cli/settings.json` to configure the permissions granted to Antigravity CLI. For example:
```json
{
"coreTools": ["WebFetchTool", "WebSearchTool", "MemoryTool"]

@AkihiroSuda AkihiroSuda Jul 15, 2026

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

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

@AkihiroSuda AkihiroSuda Jul 15, 2026

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?

}
```

## Usage
Just run `gemini` in your project directory.
Just run `agy` in your project directory.

Gemini automatically recognizes the MCP tools provided by Lima.
Antigravity CLI automatically recognizes the configured MCP server provided by Lima.
30 changes: 13 additions & 17 deletions website/content/en/docs/examples/ai.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,18 @@ lima vi "/home/${USER}.linux/.bash_profile"

See also <https://github.com/Aider-AI/aider>.
{{% /tab %}}
{{% tab header="Antigravity" %}}
```bash
lima curl -fsSL https://antigravity.google/cli/install.sh | bash

@AkihiroSuda AkihiroSuda Jul 15, 2026

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 •
edited
Loading

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

@AkihiroSuda AkihiroSuda Jul 18, 2026

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.

lima agy
```

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.

@AkihiroSuda AkihiroSuda Jul 15, 2026

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?

@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 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?


See also <https://github.com/google-antigravity/antigravity-cli>.
{{% /tab %}}
{{% tab header="Claude Code" %}}
```
lima sudo snap install node --classic
Expand Down Expand Up @@ -83,22 +95,6 @@ lima vi "/home/${USER}.linux/.bash_profile"

See also <https://github.com/openai/codex>.
{{% /tab %}}
{{% tab header="Gemini" %}}
```
lima sudo snap install node --classic
lima sudo npm install -g @google/gemini-cli
lima gemini
```

Follow the guide shown in the first session for authentication.

Alternatively, you can set `export GEMINI_API_KEY...` via:
```
lima vi "/home/${USER}.linux/.bash_profile"
```

See also <https://github.com/google-gemini/gemini-cli>.
{{% /tab %}}
{{% tab header="GitHub Copilot" %}}
```
lima sudo snap install node --classic
Expand Down Expand Up @@ -136,7 +132,7 @@ See also <https://github.com/anomalyco/opencode>.
| ⚡ Requirement | Lima >= 2.1 |
|----------------|-------------|

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.

@AkihiroSuda AkihiroSuda Jul 15, 2026

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/website/content/en/docs/config/ai/inside/_index.md

Line 6 in de48002

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

@afbjorklund afbjorklund Jul 19, 2026

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


### Comparison with `mount`

Expand Down