feat: Add Antigravity agent support #1368

serhiishtokal · 2025-12-21T02:08:36Z

Summary

This PR adds support for Antigravity (Google's Antigravity IDE) as an AI assistant option in Specify CLI.

Relates to #1213, #1217, and #1220. This is an alternative implementation that:

Uses the full name antigravity (as requested by maintainers in Feat: add a new agent: Google Anti Gravity #1220)
Is rebased on latest main with no merge conflicts
Includes proper version bump and CHANGELOG entry

Changes

CLI (src/specify_cli/init.py)

Added Antigravity to AGENT_CONFIG dictionary

Release Scripts

Updated create-release-packages.sh and create-release-packages.ps1 to generate Antigravity templates
Updated create-github-release.sh to include Antigravity packages

Context Update Scripts

Updated scripts/bash/update-agent-context.sh
Updated scripts/powershell/update-agent-context.ps1

Documentation

Updated AGENTS.md with Antigravity details
Updated README.md supported agents table

Versioning

Bumped version to 0.0.23 in pyproject.toml
Added CHANGELOG entry for 0.0.23

Copilot

Pull request overview

This PR adds support for Antigravity (described as Google's Antigravity IDE) as a new AI assistant option in the Specify CLI. The implementation follows the established pattern for adding new agents by updating configuration, scripts, documentation, and release tooling.

Key Changes

Added Antigravity to the agent configuration with IDE-based settings (requires_cli: False)
Updated all release package generation scripts to include Antigravity templates
Updated context update scripts (bash and PowerShell) to support Antigravity agent files
Added documentation entries and bumped version to 0.0.23

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
`src/specify_cli/__init__.py`	Added Antigravity to AGENT_CONFIG dictionary and updated help text for --ai option
`scripts/bash/update-agent-context.sh`	Added Antigravity file path, case handling, and updated agent lists in comments
`scripts/powershell/update-agent-context.ps1`	Added Antigravity file path, switch case, validation set, and updated usage documentation
`.github/workflows/scripts/create-release-packages.sh`	Added Antigravity case block and included in ALL_AGENTS array
`.github/workflows/scripts/create-release-packages.ps1`	Added Antigravity case block and included in $AllAgents array
`.github/workflows/scripts/create-github-release.sh`	Added Antigravity package files to release artifacts
`AGENTS.md`	Added Antigravity to supported agents table, CLI categories, format documentation, and example code
`README.md`	Added Antigravity to supported agents table and CLI reference documentation
`pyproject.toml`	Bumped version from 0.0.22 to 0.0.23
`CHANGELOG.md`	Added version 0.0.23 entry documenting Antigravity support

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-12-21T02:12:24Z

AGENTS.md

 | **Gemini CLI**             | `.gemini/commands/`    | TOML     | `gemini`        | Google's Gemini CLI         |
 | **GitHub Copilot**         | `.github/agents/`      | Markdown | N/A (IDE-based) | GitHub Copilot in VS Code   |
 | **Cursor**                 | `.cursor/commands/`    | Markdown | `cursor-agent`  | Cursor CLI                  |
+| **Antigravity**            | `.agent/workflows/`    | Markdown | `antigravity`   | Google's Antigravity IDE    |


In the CLI Tool column, Antigravity is listed as "antigravity", but based on the AGENT_CONFIG in init.py where "requires_cli": False, and the Description column calling it "Google's Antigravity IDE", it should be "N/A (IDE-based)" to match the pattern of other IDE-based agents like Windsurf, GitHub Copilot, and IBM Bob.

Suggested change

| **Antigravity** | `.agent/workflows/` | Markdown | `antigravity` | Google's Antigravity IDE |

| **Antigravity** | `.agent/workflows/` | Markdown | N/A (IDE-based) | Google's Antigravity IDE |

Copilot · 2025-12-21T02:12:25Z

scripts/bash/update-agent-context.sh

 GEMINI_FILE="$REPO_ROOT/GEMINI.md"
 COPILOT_FILE="$REPO_ROOT/.github/agents/copilot-instructions.md"
 CURSOR_FILE="$REPO_ROOT/.cursor/rules/specify-rules.mdc"
+ANTIGRAVITY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"


The directory path for Antigravity is inconsistent across files. In AGENTS.md and the release package scripts, it's documented as .agent/workflows/, but in the update-agent-context scripts (both bash and PowerShell), it's implemented as .agent/rules/specify-rules.md. These need to be aligned. Based on the pattern of similar IDE-based agents like Windsurf which uses .windsurf/workflows/, the .agent/workflows/ path appears to be the correct choice.

Suggested change

ANTIGRAVITY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"

ANTIGRAVITY_FILE="$REPO_ROOT/.agent/workflows/specify-rules.md"

Thanks for the suggestion, but the paths are intentionally different and serve different purposes:

.agent/workflows/ (in AGENTS.md and release scripts) → Where spec-kit command files are generated (e.g., speckit.plan.md, speckit.spec.md)

.agent/rules/ (in update-agent-context scripts) → Where the agent context/rules file (specify-rules.md) is stored

This is consistent with other IDE-based agents like Windsurf:

Commands go to .windsurf/workflows/

Rules go to .windsurf/rules/specify-rules.md

The AGENTS.md table documents where command files are stored, while the update-agent-context scripts manage per-project agent rules/instructions files. These are two distinct concepts with different file locations.

Copilot · 2025-12-21T02:12:25Z

scripts/powershell/update-agent-context.ps1

 $GEMINI_FILE   = Join-Path $REPO_ROOT 'GEMINI.md'
 $COPILOT_FILE  = Join-Path $REPO_ROOT '.github/agents/copilot-instructions.md'
 $CURSOR_FILE   = Join-Path $REPO_ROOT '.cursor/rules/specify-rules.mdc'
+$ANTIGRAVITY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'


The directory path for Antigravity is inconsistent across files. In AGENTS.md and the release package scripts, it's documented as .agent/workflows/, but in the update-agent-context scripts (both bash and PowerShell), it's implemented as .agent/rules/specify-rules.md. These need to be aligned. Based on the pattern of similar IDE-based agents like Windsurf which uses .windsurf/workflows/, the .agent/workflows/ path appears to be the correct choice.

Suggested change

$ANTIGRAVITY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'

$ANTIGRAVITY_FILE = Join-Path $REPO_ROOT '.agent/workflows/specify-rules.md'

Thanks for the suggestion, but the paths are intentionally different and serve different purposes:

.agent/workflows/ (in AGENTS.md and release scripts) → Where spec-kit command files are generated (e.g., speckit.plan.md, speckit.spec.md)

.agent/rules/ (in update-agent-context scripts) → Where the agent context/rules file (specify-rules.md) is stored

This is consistent with other IDE-based agents like Windsurf:

Commands go to .windsurf/workflows/

Rules go to .windsurf/rules/specify-rules.md

The AGENTS.md table documents where command files are stored, while the update-agent-context scripts manage per-project agent rules/instructions files. These are two distinct concepts with different file locations.

Copilot · 2025-12-21T02:12:25Z

AGENTS.md

 - **Claude Code**: `claude` CLI
 - **Gemini CLI**: `gemini` CLI
 - **Cursor**: `cursor-agent` CLI
+- **Antigravity**: `antigravity` CLI


There's a contradiction about whether Antigravity is CLI-based or IDE-based. In the AGENT_CONFIG, it's set with "requires_cli": False, but in AGENTS.md at line 313, it's listed under "CLI-Based Agents" with the note "Antigravity: antigravity CLI". Additionally, line 38 of AGENTS.md describes it as "Google's Antigravity IDE" (IDE-based), but then line 313 treats it as CLI-based. This needs to be clarified and made consistent across all documentation and configuration.

- Update AGENTS.md table to use "Antigravity IDE" naming - Change CLI tool column from 'antigravity' to 'N/A (IDE-based)' - Update display name in AGENT_CONFIG in __init__.py - Update agent context scripts (bash and PowerShell)

MahmoudKhodier · 2025-12-24T17:40:06Z

i have tried to install speckit from this pull by installing speckit then merging this into it and reinstalling to use it with antigravity. but i get this error "╭──────────────────── Agent Detection Error ─────────────────────╮
│ │
│ agy not found │
│ Install from: None │
│ Antigravity is required to continue with this project type. │
│ │
│ Tip: Use --ignore-agent-tools to skip this check "

am i doing something wrong or must i wait for proper merge

serhiishtokal · 2025-12-24T23:19:37Z

i have tried to install speckit from this pull by installing speckit then merging this into it and reinstalling to use it with antigravity. but i get this error "╭──────────────────── Agent Detection Error ─────────────────────╮ │ │ │ agy not found │ │ Install from: None │ │ Antigravity is required to continue with this project type. │ │ │ │ Tip: Use --ignore-agent-tools to skip this check "

am i doing something wrong or must i wait for proper merge

@MahmoudKhodier I think you may have commented on the wrong PR — your note looks like it belongs to #1220.
FYI, you can’t test the new changes with CLI locally.
Please follow the workaround for testing changes locally:
https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md#testing-template-and-command-changes-locally.

- Applied upstream PR github#1368 to add Antigravity IDE support - Version bumped from 0.0.22 to 0.0.23 - Added Antigravity to AGENT_CONFIG with IDE-based configuration - Updated all documentation (AGENTS.md, README.md, CHANGELOG.md) - Enhanced release scripts to include Antigravity templates - Added agent context update scripts for Antigravity - Validated directory structure follows established IDE agent pattern - No fixes required - PR implements correct dual-directory pattern Implementation Details: - Antigravity uses .agent/workflows/ for command files - Antigravity uses .agent/rules/specify-rules.md for context - Marked as IDE-based (requires_cli: False) - Consistent with Windsurf and Cursor agent patterns Evaluation Results: - ✅ All static analysis passed - ✅ Pattern consistency validated - ✅ Documentation complete and accurate - ✅ No breaking changes identified - ✅ APPROVED for integration Files Modified: 10 core files Documentation: Created evaluation report and LOCAL_MODIFICATIONS tracker Upstream PR: github#1368 Change ID: evaluate-spec-kit-pr-1368 OpenSpec Workflow: /2-openspec-global-apply

Merged feature branch implementing spec-kit PR github#1368 evaluation and application. Key Changes: - Added Antigravity IDE as supported agent (version 0.0.23) - Applied upstream PR github#1368 with comprehensive evaluation - Validated dual-directory pattern (.agent/workflows/ + .agent/rules/) - Created evaluation report and local modifications tracker All validation passed: ✅ Pattern consistency confirmed ✅ Documentation complete ✅ No breaking changes ✅ Ready for production use Branch: feat/evaluate-spec-kit-pr-1368 Change ID: evaluate-spec-kit-pr-1368 OpenSpec Workflow: /2-openspec-global-apply

Syncing guardian-state backup branch with main after successful merge of feat/evaluate-spec-kit-pr-1368. Includes: - Spec-kit PR github#1368 (Antigravity IDE support, v0.0.23) - All recent main branch updates - Evaluation documentation and local modifications tracker Branch Protection: guardian-state updated per Rule github#8 Purpose: Backup of main in case rollback needed

feat: antigravity agent

f3ba03e

Copilot AI review requested due to automatic review settings December 21, 2025 02:08

serhiishtokal requested a review from localden as a code owner December 21, 2025 02:08

Copilot started reviewing on behalf of serhiishtokal December 21, 2025 02:08 View session

Copilot AI reviewed Dec 21, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Add Antigravity agent support #1368

feat: Add Antigravity agent support #1368

serhiishtokal commented Dec 21, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Dec 21, 2025

Uh oh!

Copilot AI Dec 21, 2025

Uh oh!

serhiishtokal Dec 21, 2025

Uh oh!

Copilot AI Dec 21, 2025

Uh oh!

serhiishtokal Dec 21, 2025

Uh oh!

Copilot AI Dec 21, 2025

Uh oh!

MahmoudKhodier commented Dec 24, 2025

Uh oh!

serhiishtokal commented Dec 24, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	\| Antigravity \| `.agent/workflows/` \| Markdown \| `antigravity` \| Google's Antigravity IDE \|
	\| Antigravity \| `.agent/workflows/` \| Markdown \| N/A (IDE-based) \| Google's Antigravity IDE \|

	ANTIGRAVITY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"
	ANTIGRAVITY_FILE="$REPO_ROOT/.agent/workflows/specify-rules.md"

	$ANTIGRAVITY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'
	$ANTIGRAVITY_FILE = Join-Path $REPO_ROOT '.agent/workflows/specify-rules.md'

feat: Add Antigravity agent support #1368

Are you sure you want to change the base?

feat: Add Antigravity agent support #1368

Conversation

serhiishtokal commented Dec 21, 2025

Summary

Changes

CLI (src/specify_cli/init.py)

Release Scripts

Context Update Scripts

Documentation

Versioning

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Key Changes

Reviewed changes

Uh oh!

Copilot AI Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

serhiishtokal Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

serhiishtokal Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 21, 2025

Choose a reason for hiding this comment

Uh oh!

MahmoudKhodier commented Dec 24, 2025

Uh oh!

serhiishtokal commented Dec 24, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants