While Constellation's MCP server provides raw code intelligence capabilities, this plugin enhances your Antigravity experience with:
| Feature | Benefit |
|---|---|
| Slash Commands | Quick access to common workflows |
| Contextual Skills | Antigravity automatically loads relevant knowledge — including proactive impact analysis before risky changes |
| Rules | Always-on guidance steering the agent toward graph-backed code understanding |
| Hooks | Transparent steering toward code_intel for structural code queries |
| MCP Server | Bundled code_intel server connection, no separate setup |
Execute powerful analysis with simple slash commands:
| Command | Description |
|---|---|
/constellation:status |
Check API connectivity and authentication status |
/constellation:diagnose |
Quick health check for connectivity and authentication |
/constellation:impact <symbol> <file> |
Analyze blast radius before changing a symbol |
/constellation:deps <file> [--reverse] |
Map dependencies or find what depends on a file |
/constellation:unused |
Discover orphaned exports and dead code |
/constellation:architecture |
Get a high-level overview of your codebase structure |
Antigravity automatically activates specialized knowledge based on your questions:
| Skill | Triggers When You Ask About... |
|---|---|
| constellation-troubleshooting | Error codes, connectivity issues, debugging problems |
| impact-analysis | Renaming, refactoring, deleting, or moving symbols/files; "what would break if...", "is X dead code", "what depends on X" |
Example Trigger:
You: "Rename AuthService to AuthenticationService"
Antigravity: "Before renaming, let me analyze the potential impact..."
[impact-analysis skill activates, runs api.impactAnalysis, reports risk + dependents]
rules/constellation.md establishes Constellation as the agent's primary code sense: structural queries, impact analysis, and architecture questions go to code_intel; literal text search falls back to grep.
Event hooks transparently steer Antigravity toward code_intel for structural code questions. All hooks are gated on CONSTELLATION_ACCESS_KEY being set (prefix ak:) and never block execution:
| Hook | Event | Matcher | Behavior |
|---|---|---|---|
| constellation-context | PreInvocation |
— | Injects code_intel awareness as an ephemeral message on the first model invocation of each conversation |
| constellation-tool-steering | PreToolUse |
^(grep_search|find_by_name|run_command)$ |
Reminds Antigravity to prefer code_intel when it reaches for text search, file search, or shell commands containing grep, rg, glob, awk, or findstr |
The PreToolUse hook always returns decision ask, which defers to the host's normal permission flow. It never grants (allow) or blocks (deny) tool calls; it only attaches a steering reason.
- Constellation Account (see Constellation)
- Project indexed in Constellation
- Access key configured (
CONSTELLATION_ACCESS_KEYenvironment variable)
agy plugin install https://github.com/ShiftinBits/constellation-antigravityClone (or copy) this repository into one of Antigravity's plugin locations:
| Scope | Location |
|---|---|
| Workspace | <workspace-root>/.agents/plugins/constellation/ |
| Global | ~/.gemini/config/plugins/constellation/ |
Antigravity scans these directories automatically and loads the plugin's commands, skills, rules, hooks, and MCP server.
> /constellation:status
Status: Connected
- Authentication valid, project access confirmed
- Note: Use /constellation:diagnose to check indexing status
> /constellation:impact validateUser src/auth/validator.ts
Symbol: validateUser (function)
Risk Level: MEDIUM
Files Affected: 12
Symbols Affected: 34
Test Coverage: 67%
Recommendations:
- Update unit tests in auth.spec.ts
- Check integration with UserController
> /constellation:unused --kind function
Found 7 orphaned functions:
├── src/utils/legacy.ts
│ ├── formatLegacyDate (line 23)
│ └── parseLegacyConfig (line 45)
├── src/helpers/deprecated.ts
│ └── oldValidation (line 12)
...
> /constellation:deps src/services/payment.service.ts
Dependencies (12):
├── Internal (8)
│ ├── src/models/payment.model.ts
│ ├── src/utils/currency.ts
│ └── ...
└── External (4)
├── stripe
├── lodash
└── ...
No circular dependencies detected.
| Issue | Solution |
|---|---|
AUTH_ERROR |
Check CONSTELLATION_ACCESS_KEY is set correctly, use npx @constellationdev/cli auth to set |
PROJECT_NOT_INDEXED |
Run constellation index --full in your project |
| Commands or skills not appearing | Restart Antigravity, check the plugin path, or browse /skills |
| MCP server not connecting | Check /mcp in the Antigravity CLI for server status and logs |
- Constellation Documentation — Full platform documentation
- MCP Server — Underlying MCP server
- Antigravity Plugins — Plugin structure reference
- Antigravity CLI Plugins & Skills — CLI plugin guide
GNU Affero General Public License v3.0 (AGPL-3.0)
Copyright © 2026 ShiftinBits Inc.
See LICENSE file for details.