Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

fix(cua-driver): install Antigravity skills in IDE and CLI directories (#5226)

injaneity3bd8f65896d0
diff --git a/docs/content/docs/cua-driver/guides/connect-your-agent.mdx b/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
index b5a2da3ecc..d41a807795 100644
--- a/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
+++ b/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
@@ -81,7 +81,9 @@ cua-driver skills status
```
If `status` reports a client's skill directory as absent, create it
-(`~/.agents/skills` for Codex, `~/.claude/skills` for Claude Code) and rerun.
+(`~/.agents/skills` for Codex, `~/.claude/skills` for Claude Code,
+`~/.gemini/config/skills` for the Antigravity IDE,
+`~/.gemini/antigravity-cli/skills` for the Antigravity CLI) and rerun.
Add `--all-platforms` to keep the macOS, Windows, and Linux guides together.
OpenClaw can use ClawHub instead: `clawhub install @cua/driver`. Cua Driver
0.28.0+ also serves the skill as MCP resources; whether that activates it as a
diff --git a/libs/cua-driver/rust/crates/cua-driver/src/skills.rs b/libs/cua-driver/rust/crates/cua-driver/src/skills.rs
index 1b184b2594..48a0a87637 100644
--- a/libs/cua-driver/rust/crates/cua-driver/src/skills.rs
+++ b/libs/cua-driver/rust/crates/cua-driver/src/skills.rs
@@ -47,9 +47,10 @@
//! - OpenClaw: `~/.openclaw/skills/`
//! - OpenCode: `~/.config/opencode/skills/` (macOS / Linux),
//! `%APPDATA%\opencode\skills\` (Windows)
-//! - Antigravity: `~/.gemini/skills/` — shared between Antigravity CLI
-//! (`agy`) and Antigravity IDE; same dir Google Gemini CLI used before the
-//! May-2026 transition, so existing installs migrate forward unchanged.
+//! - Antigravity IDE: `~/.gemini/config/skills/` (global skills directory),
+//! plus the legacy `~/.gemini/antigravity/skills/` it still accepts
+//! - Antigravity CLI (`agy`): `~/.gemini/antigravity-cli/skills/`
+//! - Gemini CLI (legacy): `~/.gemini/skills/`
//! - Hermes: `$HERMES_HOME/skills/` when set, otherwise `~/.hermes/skills/` on
//! macOS/Linux or `%LOCALAPPDATA%\hermes\skills\` on Windows. This is the
//! user-level skill space Hermes resolves at agent load time (separate from
@@ -247,11 +248,23 @@ const AGENTS: &[Agent] = &[
parent: AgentParent::Home(".config/opencode/skills"),
install_marker: None,
},
- // Antigravity CLI + Antigravity IDE share the `.gemini/skills/` dir
- // (the same path Gemini CLI used pre-May-2026). Registering the
- // single shared path means both surfaces pick up the same symlink.
Agent {
- label: "Antigravity",
+ label: "Antigravity IDE",
+ parent: AgentParent::Home(".gemini/config/skills"),
+ install_marker: None,
+ },
+ Agent {
+ label: "Antigravity IDE (legacy dir)",
+ parent: AgentParent::Home(".gemini/antigravity/skills"),
+ install_marker: None,
+ },
+ Agent {
+ label: "Antigravity CLI",
+ parent: AgentParent::Home(".gemini/antigravity-cli/skills"),
+ install_marker: None,
+ },
+ Agent {
+ label: "Gemini CLI (legacy)",
parent: AgentParent::Home(".gemini/skills"),
install_marker: None,
},
@@ -1097,6 +1110,56 @@ mod tests {
));
}
+ #[test]
+ fn antigravity_ide_target_matches_its_global_skill_directory() {
+ let target = AGENTS
+ .iter()
+ .find(|agent| agent.label == "Antigravity IDE")
+ .expect("Antigravity IDE must be a supported skill target");
+
+ assert!(matches!(
+ target.parent,
+ AgentParent::Home(".gemini/config/skills")
+ ));
+ }
+
+ #[test]
+ fn antigravity_ide_legacy_skill_directory_is_also_a_target() {
+ let target = AGENTS
+ .iter()
+ .find(|agent| agent.label == "Antigravity IDE (legacy dir)")
+ .expect("the legacy Antigravity IDE directory must be a supported skill target");
+
+ assert!(matches!(
+ target.parent,
+ AgentParent::Home(".gemini/antigravity/skills")
+ ));
+ }
+
+ #[test]
+ fn antigravity_cli_target_matches_its_global_skill_directory() {
+ let target = AGENTS
+ .iter()
+ .find(|agent| agent.label == "Antigravity CLI")
+ .expect("Antigravity CLI must be a supported skill target");
+
+ assert!(matches!(
+ target.parent,
+ AgentParent::Home(".gemini/antigravity-cli/skills")
+ ));
+ }
+
+ #[test]
+ fn legacy_gemini_skill_directory_stays_a_separate_target() {
+ let legacy: Vec<_> = AGENTS
+ .iter()
+ .filter(|agent| matches!(agent.parent, AgentParent::Home(".gemini/skills")))
+ .collect();
+
+ assert_eq!(legacy.len(), 1);
+ assert_eq!(legacy[0].label, "Gemini CLI (legacy)");
+ }
+
#[test]
fn hermes_target_prefers_hermes_home() {
let path = resolve_hermes_skills_dir(Some("/profiles/work"), || {
diff --git a/libs/cua-driver/scripts/tests/test_uninstall_antigravity_skill_links.py b/libs/cua-driver/scripts/tests/test_uninstall_antigravity_skill_links.py
new file mode 100644
index 0000000000..ce10752611
--- /dev/null
+++ b/libs/cua-driver/scripts/tests/test_uninstall_antigravity_skill_links.py
@@ -0,0 +1,41 @@
+"""Release uninstall: Antigravity skill links are removed only when the driver owns them."""
+
+import pytest
+
+
+ANTIGRAVITY_SKILL_DIRS = [
+ ".gemini/config/skills",
+ ".gemini/antigravity/skills",
+ ".gemini/antigravity-cli/skills",
+]
+
+
[email protected]("skills_dir", ANTIGRAVITY_SKILL_DIRS)
+def test_driver_owned_antigravity_link_is_removed(release_install, skills_dir):
+ f = release_install
+ pack = f.home / ".cua-driver/skills/cua-driver"
+ pack.mkdir(parents=True)
+ link = f.home / skills_dir / "cua-driver"
+ link.parent.mkdir(parents=True)
+ link.symlink_to(pack)
+
+ result = f.run()
+
+ assert result.returncode == 0, result.stdout + result.stderr
+ assert not link.is_symlink(), result.stdout
+
+
[email protected]("skills_dir", ANTIGRAVITY_SKILL_DIRS)
+def test_hand_managed_antigravity_link_is_preserved(release_install, tmp_path, skills_dir):
+ f = release_install
+ own_copy = tmp_path / "work/cua-driver-skill"
+ own_copy.mkdir(parents=True)
+ link = f.home / skills_dir / "cua-driver"
+ link.parent.mkdir(parents=True)
+ link.symlink_to(own_copy)
+
+ result = f.run()
+
+ assert result.returncode == 0, result.stdout + result.stderr
+ assert link.is_symlink(), result.stdout
+ assert link.resolve() == own_copy.resolve()
diff --git a/libs/cua-driver/scripts/uninstall-local.ps1 b/libs/cua-driver/scripts/uninstall-local.ps1
index 72a477d797..5e0883c4d3 100644
--- a/libs/cua-driver/scripts/uninstall-local.ps1
+++ b/libs/cua-driver/scripts/uninstall-local.ps1
@@ -184,6 +184,9 @@ $SkillLinks = @(
(Join-Path $env:USERPROFILE ".agents\skills\cua-driver"),
(Join-Path $env:USERPROFILE ".openclaw\skills\cua-driver"),
(Join-Path $env:APPDATA "opencode\skills\cua-driver"),
+ (Join-Path $env:USERPROFILE ".gemini\config\skills\cua-driver"),
+ (Join-Path $env:USERPROFILE ".gemini\antigravity\skills\cua-driver"),
+ (Join-Path $env:USERPROFILE ".gemini\antigravity-cli\skills\cua-driver"),
(Join-Path $env:USERPROFILE ".gemini\skills\cua-driver"),
(Join-Path $env:USERPROFILE ".hermes\skills\cua-driver")
)
diff --git a/libs/cua-driver/scripts/uninstall-local.sh b/libs/cua-driver/scripts/uninstall-local.sh
index 2a0258fe3f..dcdcdcbe38 100755
--- a/libs/cua-driver/scripts/uninstall-local.sh
+++ b/libs/cua-driver/scripts/uninstall-local.sh
@@ -135,6 +135,9 @@ for skill_link in \
"$HOME/.agents/skills/cua-driver" \
"$HOME/.openclaw/skills/cua-driver" \
"$HOME/.config/opencode/skills/cua-driver" \
+ "$HOME/.gemini/config/skills/cua-driver" \
+ "$HOME/.gemini/antigravity/skills/cua-driver" \
+ "$HOME/.gemini/antigravity-cli/skills/cua-driver" \
"$HOME/.gemini/skills/cua-driver" \
"$HOME/.hermes/skills/cua-driver"; do
if [[ -L "$skill_link" ]]; then
diff --git a/libs/cua-driver/scripts/uninstall.ps1 b/libs/cua-driver/scripts/uninstall.ps1
index a11a04f4c5..fefb35557b 100644
--- a/libs/cua-driver/scripts/uninstall.ps1
+++ b/libs/cua-driver/scripts/uninstall.ps1
@@ -199,6 +199,15 @@ $SkillJunctions = @(
(Join-Path $env:USERPROFILE ".hermes\skills\cua-driver-rs")
)
+$OwnedSkillJunctions = @(
+ (Join-Path $env:USERPROFILE ".gemini\config\skills\cua-driver"),
+ (Join-Path $env:USERPROFILE ".gemini\antigravity\skills\cua-driver"),
+ (Join-Path $env:USERPROFILE ".gemini\antigravity-cli\skills\cua-driver"),
+ (Join-Path $env:USERPROFILE ".gemini\config\skills\cua-driver-rs"),
+ (Join-Path $env:USERPROFILE ".gemini\antigravity\skills\cua-driver-rs"),
+ (Join-Path $env:USERPROFILE ".gemini\antigravity-cli\skills\cua-driver-rs")
+)
+
# ---------- Log helpers ----------------------------------------------------
function Write-Step($message) {
@@ -482,6 +491,31 @@ foreach ($skillLink in $SkillJunctions) {
Write-Step "no skill junction at $skillLink (skipping)"
}
}
+foreach ($skillLink in $OwnedSkillJunctions) {
+ if (-not (Test-Path -LiteralPath $skillLink)) {
+ Write-Step "no skill junction at $skillLink (skipping)"
+ continue
+ }
+ if (-not (Test-IsReparsePoint $skillLink)) {
+ Write-Step "$skillLink is a real directory (not a reparse point) - skipping"
+ continue
+ }
+ $targetProperty = (Get-Item -LiteralPath $skillLink -Force).PSObject.Properties['Target']
+ $owned = $false
+ $targets = if ($targetProperty) { @($targetProperty.Value) } else { @() }
+ foreach ($target in $targets) {
+ foreach ($root in @($HomeDir, $LegacyHomeDir)) {
+ $prefix = $root.TrimEnd('\') + '\'
+ if ($target -and $target.StartsWith($prefix, [StringComparison]::OrdinalIgnoreCase)) { $owned = $true }
+ }
+ }
+ if ($owned) {
+ Remove-Item -LiteralPath $skillLink -Force -Recurse -ErrorAction SilentlyContinue
+ Write-Step "removed skill junction $skillLink"
+ } else {
+ Write-Step "$skillLink points outside the driver home - skipping"
+ }
+}
# ---------- Closing message -----------------------------------------------
diff --git a/libs/cua-driver/scripts/uninstall.sh b/libs/cua-driver/scripts/uninstall.sh
index e22424f845..dc9e188a69 100755
--- a/libs/cua-driver/scripts/uninstall.sh
+++ b/libs/cua-driver/scripts/uninstall.sh
@@ -920,6 +920,26 @@ if [[ "$USE_RUST_BACKEND" == "1" ]]; then
log "no skill symlink at $SKILL_LINK (skipping)"
fi
done
+ for SKILL_LINK in \
+ "$HOME/.gemini/config/skills/$SKILL_PACK_NAME" \
+ "$HOME/.gemini/antigravity/skills/$SKILL_PACK_NAME" \
+ "$HOME/.gemini/antigravity-cli/skills/$SKILL_PACK_NAME" \
+ "$HOME/.gemini/config/skills/$LEGACY_SKILL_PACK_NAME" \
+ "$HOME/.gemini/antigravity/skills/$LEGACY_SKILL_PACK_NAME" \
+ "$HOME/.gemini/antigravity-cli/skills/$LEGACY_SKILL_PACK_NAME"; do
+ if [[ -L "$SKILL_LINK" ]]; then
+ SKILL_LINK_TARGET="$(readlink "$SKILL_LINK")"
+ case "$SKILL_LINK_TARGET" in
+ "$HOME_DIR"/*|"$LEGACY_HOME_DIR"/*)
+ rm -f "$SKILL_LINK"
+ log "removed skill symlink $SKILL_LINK" ;;
+ *)
+ log "$SKILL_LINK points outside the driver home (skipping)" ;;
+ esac
+ else
+ log "no skill symlink at $SKILL_LINK (skipping)"
+ fi
+ done
else
log "no Rust install marker; leaving agent skill symlinks untouched"
fi
@@ -1047,6 +1067,9 @@ for SKILL_LINK in \
"$HOME/.agents/skills/cua-driver" \
"$HOME/.openclaw/skills/cua-driver" \
"$HOME/.config/opencode/skills/cua-driver" \
+ "$HOME/.gemini/config/skills/cua-driver" \
+ "$HOME/.gemini/antigravity/skills/cua-driver" \
+ "$HOME/.gemini/antigravity-cli/skills/cua-driver" \
"$HOME/.gemini/skills/cua-driver" \
"$HOME/.hermes/skills/cua-driver"; do
if [[ -L "$SKILL_LINK" ]] && [[ "$(readlink "$SKILL_LINK")" == "$SKILL_TARGET_EXPECTED" ]]; then