Skip to content

docs: Add Antigravity IDE integration#488

Open
js-krinay wants to merge 2 commits intoobra:mainfrom
js-krinay:feat/antigravity-integration
Open

docs: Add Antigravity IDE integration#488
js-krinay wants to merge 2 commits intoobra:mainfrom
js-krinay:feat/antigravity-integration

Conversation

@js-krinay
Copy link

@js-krinay js-krinay commented Feb 16, 2026

Summary

  • Add .antigravity/INSTALL.md with platform-specific install instructions (clone + symlink)
  • Add docs/README.antigravity.md with full usage guide, troubleshooting, and personal skills docs
  • Add Antigravity IDE section to README.md following the existing Codex/OpenCode pattern

Motivation

Antigravity IDE has native skill discovery using the same SKILL.md format. This PR adds documentation to let Antigravity users install and use Superpowers, following the same symlink-based architecture used by Codex and OpenCode integrations.

Consolidates the approaches from #192 and #281, addressing reviewer feedback from both:

  • Uses symlinks instead of copying (auto-updates via git pull)
  • Uses %USERPROFILE% instead of hardcoded Windows paths
  • Uses text language specifier on non-code fenced blocks (markdownlint MD040)
  • Includes Windows equivalents for all commands
  • Bootstrap via GEMINI.md instead of a CLI script (no code, no security surface)

Test plan

  • Verify .antigravity/INSTALL.md renders correctly on GitHub
  • Verify docs/README.antigravity.md renders correctly on GitHub
  • Verify README.md Antigravity section matches Codex/OpenCode pattern
  • Test install steps on Linux/macOS
  • Test install steps on Windows

Summary by CodeRabbit

  • Documentation
    • Added installation guide for Antigravity IDE with step-by-step setup instructions for Linux/macOS and Windows environments.
    • Published comprehensive Antigravity IDE documentation covering quick installation, configuration, skill management, troubleshooting, and update procedures.
    • Updated README to introduce Antigravity IDE support with command reference and documentation links.
image

Add installation and usage documentation for Google Antigravity IDE,
following the same symlink-based pattern used by Codex and OpenCode.
Includes platform-specific instructions for Linux/macOS and Windows.
@coderabbitai
Copy link

coderabbitai bot commented Feb 16, 2026

📝 Walkthrough

Walkthrough

This PR introduces comprehensive documentation and installation guides for integrating Superpowers with the Antigravity IDE. It adds three documentation files covering installation steps, setup instructions for Linux/macOS and Windows, and detailed usage guidance for the new IDE integration.

Changes

Cohort / File(s) Summary
Antigravity IDE Integration Documentation
.antigravity/INSTALL.md, README.md, docs/README.antigravity.md
Added installation guide, README reference, and comprehensive documentation covering prerequisites, setup procedures for multiple platforms (Linux/macOS/Windows), bootstrap configuration, verification steps, skill management, project structure, update/uninstall procedures, and troubleshooting guidance.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

Poem

🐰 Antigravity takes flight today,
New docs light the skillful way,
With symlinks bound and shells aligned,
An IDE enhanced, wonderfully designed!
Superpowers bloom in code so free,
Welcome aboard—hop with glee! 🚀✨

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs: Add Antigravity IDE integration' accurately summarizes the main change: adding documentation for Antigravity IDE integration across three files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into main
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In @.antigravity/INSTALL.md:
- Around line 37-45: The install docs assume the bootstrap file exists; update
the step that tells users to add the "## Superpowers" section to GEMINI.md (or
%USERPROFILE%\.gemini\GEMINI.md) to explicitly instruct users to create that
file and its parent directory if they don't already exist before appending the
section; mention the exact target filename "GEMINI.md" and the section header
"## Superpowers" so readers know where to add the `using-superpowers` line.

In `@docs/README.antigravity.md`:
- Around line 48-54: Update the README.antigravity.md section that instructs
users to add to GEMINI.md so it mirrors the install guide: explicitly state both
paths (~/.gemini/GEMINI.md for Linux/macOS and %USERPROFILE%\.gemini\GEMINI.md
for Windows), include the example markdown block shown (the "## Superpowers"
snippet), and add a clear note to create the GEMINI.md file and its parent
.gemini directory if they do not exist so the user knows to create the file when
missing.

Comment on lines 37 to 45
3. **Configure bootstrap** (ensures skills activate automatically):

Add to `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows):

```markdown
## Superpowers

You have superpowers. Use the **using-superpowers** skill before any task.
```
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Clarify GEMINI.md creation for first-time setup.

If the bootstrap file doesn’t exist yet, users need to create it before adding the section. Add a short note to prevent confusion.

✍️ Suggested clarification
-3. **Configure bootstrap** (ensures skills activate automatically):
+3. **Configure bootstrap** (ensures skills activate automatically):
 
-   Add to `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows):
+   Create `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows) if it doesn't exist, then add:
🤖 Prompt for AI Agents
In @.antigravity/INSTALL.md around lines 37 - 45, The install docs assume the
bootstrap file exists; update the step that tells users to add the "##
Superpowers" section to GEMINI.md (or %USERPROFILE%\.gemini\GEMINI.md) to
explicitly instruct users to create that file and its parent directory if they
don't already exist before appending the section; mention the exact target
filename "GEMINI.md" and the section header "## Superpowers" so readers know
where to add the `using-superpowers` line.

Comment on lines 48 to 54
3. Configure bootstrap — add to `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows):

```markdown
## Superpowers

You have superpowers. Use the **using-superpowers** skill before any task.
```
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Mirror GEMINI.md creation guidance here too.

For consistency with the install guide, note that the file should be created if missing.

✍️ Suggested clarification
-3. Configure bootstrap — add to `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows):
+3. Configure bootstrap — create `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows) if needed, then add:
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
3. Configure bootstrap — add to `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows):
```markdown
## Superpowers
You have superpowers. Use the **using-superpowers** skill before any task.
```
3. Configure bootstrap — create `~/.gemini/GEMINI.md` (Linux/macOS) or `%USERPROFILE%\.gemini\GEMINI.md` (Windows) if needed, then add:
🤖 Prompt for AI Agents
In `@docs/README.antigravity.md` around lines 48 - 54, Update the
README.antigravity.md section that instructs users to add to GEMINI.md so it
mirrors the install guide: explicitly state both paths (~/.gemini/GEMINI.md for
Linux/macOS and %USERPROFILE%\.gemini\GEMINI.md for Windows), include the
example markdown block shown (the "## Superpowers" snippet), and add a clear
note to create the GEMINI.md file and its parent .gemini directory if they do
not exist so the user knows to create the file when missing.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant