Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

feat(install-skills): add an Antigravity skill root family and use it in setup

4nrry5bd99a47456f
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d3648063..f7cea2e4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -58,6 +58,15 @@ version in [`docs/changelog/`](docs/changelog/):
`SessionStart` detached, so finished sessions close with
`finalize-session --agent dsh` and pending handoffs are recovered via
`memory_handoff_list` / `memory_handoff_accept`. (#1337)
+- Added an Antigravity skill root family. `install-skills --agent antigravity`
+ (aliases `antigravity-cli`, `agy`; also `install-instructions
+ --skills-agent antigravity`) writes the managed Agent Skills to both global
+ roots Antigravity reads, `~/.gemini/config/skills` (App and IDE) and
+ `~/.gemini/antigravity-cli/skills` (CLI), or to the workspace
+ `.agents/skills` with `--scope project`. `ai-memory setup` now uses it for
+ Antigravity, which until now got its skills only in `~/.agents/skills`, a
+ directory Antigravity does not read globally, and `uninstall --only skills`
+ sweeps both roots.
## [3.1.0] - 2026-10-16
diff --git a/crates/ai-memory-cli/src/cli.rs b/crates/ai-memory-cli/src/cli.rs
index b1f49db3..5475a9a5 100644
--- a/crates/ai-memory-cli/src/cli.rs
+++ b/crates/ai-memory-cli/src/cli.rs
@@ -1778,6 +1778,11 @@ pub enum InstallSkillsAgent {
CopilotCli,
/// Hermes Agent's `.hermes/skills` directory.
Hermes,
+ /// Google Antigravity: the workspace `.agents/skills` (project), or both
+ /// global directories, `~/.gemini/config/skills` (App and IDE) and
+ /// `~/.gemini/antigravity-cli/skills` (CLI).
+ #[value(alias = "antigravity-cli", alias = "agy")]
+ Antigravity,
/// Install into both Claude Code and `.agents` skill directories.
Both,
}
@@ -4344,6 +4349,13 @@ mod tests {
panic!("expected install-hooks command for alias {alias}");
};
assert!(matches!(hook_args.agent, AgentChoice::AntigravityCli));
+
+ let skills_cli = Cli::try_parse_from(["ai-memory", "install-skills", "--agent", alias])
+ .unwrap_or_else(|e| panic!("failed to parse install-skills alias {alias}: {e}"));
+ let Command::InstallSkills(skills_args) = skills_cli.command else {
+ panic!("expected install-skills command for alias {alias}");
+ };
+ assert_eq!(skills_args.agent, InstallSkillsAgent::Antigravity);
}
}
diff --git a/crates/ai-memory-cli/src/commands/install_skills.rs b/crates/ai-memory-cli/src/commands/install_skills.rs
index cf29eee8..7ddc7cd6 100644
--- a/crates/ai-memory-cli/src/commands/install_skills.rs
+++ b/crates/ai-memory-cli/src/commands/install_skills.rs
@@ -4,7 +4,8 @@ use std::fs;
use std::path::{Path, PathBuf};
use ai_memory_core::routing_skills::{
- AGENTS_SKILL_DIR, CLAUDE_SKILL_DIR, COPILOT_SKILL_DIR, DEVIN_SKILL_DIR, GITHUB_SKILL_DIR,
+ AGENTS_SKILL_DIR, ANTIGRAVITY_APP_SKILL_DIR, ANTIGRAVITY_CLI_SKILL_DIR, ANTIGRAVITY_HOME_DIR,
+ CLAUDE_SKILL_DIR, COPILOT_SKILL_DIR, DEVIN_SKILL_DIR, GITHUB_SKILL_DIR,
GROK_HANDOFF_RULE_CONTENT, GROK_HANDOFF_RULE_FILENAME, GROK_HANDOFF_RULE_MARKER,
GROK_RULES_DIR, GROK_SKILL_DIR, HERMES_SKILL_DIR, MANAGED_MARKER, MANAGED_SKILLS, ManagedSkill,
SKILLS_DIR,
@@ -308,6 +309,23 @@ fn resolve_target_roots_for_platform(
platform,
)?]
}
+ // Antigravity reads workspace skills from the cross-agent root.
+ InstallSkillsAgent::Antigravity if args.scope == InstallSkillsScope::Project => {
+ vec![agent_root(
+ args.scope,
+ SkillRootKind::Agents,
+ cwd,
+ home,
+ appdata,
+ agent_home,
+ claude_config_dir,
+ platform,
+ )?]
+ }
+ InstallSkillsAgent::Antigravity => antigravity_global_skill_roots(
+ home.context("could not locate $HOME for global skill install")?,
+ )
+ .to_vec(),
InstallSkillsAgent::Both => vec![
agent_root(
args.scope,
@@ -335,6 +353,18 @@ fn resolve_target_roots_for_platform(
Ok(roots.into_iter().map(TargetRoot::new).collect())
}
+/// Antigravity's global skill roots under `home`: `~/.gemini/config/skills`,
+/// which the App and IDE read, and `~/.gemini/antigravity-cli/skills`, which
+/// the CLI reads. Antigravity documents `.agents/skills` only as a workspace
+/// root (<https://antigravity.google/docs/skills/>).
+pub(super) fn antigravity_global_skill_roots(home: &Path) -> [PathBuf; 2] {
+ let antigravity = home.join(ANTIGRAVITY_HOME_DIR);
+ [
+ antigravity.join(ANTIGRAVITY_APP_SKILL_DIR).join(SKILLS_DIR),
+ antigravity.join(ANTIGRAVITY_CLI_SKILL_DIR).join(SKILLS_DIR),
+ ]
+}
+
#[derive(Debug, Clone, Copy, Eq, PartialEq)]
enum SkillHostPlatform {
Windows,
@@ -661,6 +691,45 @@ mod tests {
assert_eq!(root_names(&global_grok), ["/home/alice/.grok/skills"]);
}
+ /// Antigravity's global skills go to the two roots its docs list, one per
+ /// product, never `~/.agents/skills`; its workspace root is the shared
+ /// `.agents/skills` (<https://antigravity.google/docs/skills/>).
+ #[test]
+ fn antigravity_skill_roots_are_the_documented_workspace_and_global_roots() {
+ let cwd = Path::new("/repo");
+ let home = Path::new("/home/alice");
+
+ let project = resolve_target_roots(
+ &args(InstallSkillsScope::Project, InstallSkillsAgent::Antigravity),
+ cwd,
+ Some(home),
+ )
+ .unwrap();
+ assert_eq!(root_names(&project), ["/repo/.agents/skills"]);
+
+ let global = resolve_target_roots(
+ &args(InstallSkillsScope::Global, InstallSkillsAgent::Antigravity),
+ cwd,
+ Some(home),
+ )
+ .unwrap();
+ assert_eq!(
+ root_names(&global),
+ [
+ "/home/alice/.gemini/config/skills",
+ "/home/alice/.gemini/antigravity-cli/skills"
+ ]
+ );
+
+ let error = resolve_target_roots(
+ &args(InstallSkillsScope::Global, InstallSkillsAgent::Antigravity),
+ cwd,
+ None,
+ )
+ .unwrap_err();
+ assert!(error.to_string().contains("$HOME"), "{error}");
+ }
+
#[test]
fn devin_global_skill_root_matches_confirmed_windows_path() {
let cwd = Path::new("/repo");
diff --git a/crates/ai-memory-cli/src/commands/setup.rs b/crates/ai-memory-cli/src/commands/setup.rs
index 4db7a48c..c4666135 100644
--- a/crates/ai-memory-cli/src/commands/setup.rs
+++ b/crates/ai-memory-cli/src/commands/setup.rs
@@ -181,6 +181,7 @@ fn skills_for(agent: AgentChoice) -> InstallSkillsAgent {
AgentChoice::CopilotCli => InstallSkillsAgent::CopilotCli,
AgentChoice::Devin => InstallSkillsAgent::Devin,
AgentChoice::Hermes => InstallSkillsAgent::Hermes,
+ AgentChoice::AntigravityCli => InstallSkillsAgent::Antigravity,
_ => InstallSkillsAgent::Agents,
}
}
@@ -1547,6 +1548,11 @@ mod tests {
InstallSkillsAgent::CopilotCli
);
assert_eq!(skills_for(AgentChoice::Codex), InstallSkillsAgent::Agents);
+ // Antigravity has no global `~/.agents/skills`; it reads its own roots.
+ assert_eq!(
+ skills_for(AgentChoice::AntigravityCli),
+ InstallSkillsAgent::Antigravity
+ );
assert_eq!(
skills_for(AgentChoice::KimiCode),
InstallSkillsAgent::Agents
diff --git a/crates/ai-memory-cli/src/commands/uninstall.rs b/crates/ai-memory-cli/src/commands/uninstall.rs
index 7828268e..91e3e1ab 100644
--- a/crates/ai-memory-cli/src/commands/uninstall.rs
+++ b/crates/ai-memory-cli/src/commands/uninstall.rs
@@ -607,7 +607,7 @@ fn skill_roots(
copilot_home: Option<&Path>,
claude_config_dir: Option<&Path>,
) -> Vec<PathBuf> {
- let mut roots = Vec::with_capacity(12);
+ let mut roots = Vec::with_capacity(14);
push_unique_skill_root(&mut roots, cwd.join(CLAUDE_SKILL_DIR).join(SKILLS_DIR));
push_unique_skill_root(&mut roots, cwd.join(AGENTS_SKILL_DIR).join(SKILLS_DIR));
push_unique_skill_root(&mut roots, cwd.join(DEVIN_SKILL_DIR).join(SKILLS_DIR));
@@ -625,6 +625,9 @@ fn skill_roots(
.map(Path::to_path_buf)
.unwrap_or_else(|| home.join(COPILOT_SKILL_DIR));
push_unique_skill_root(&mut roots, copilot_root.join(SKILLS_DIR));
+ for root in super::install_skills::antigravity_global_skill_roots(home) {
+ push_unique_skill_root(&mut roots, root);
+ }
}
// Windows global Devin installs live under %APPDATA%\devin\skills, not
// $HOME/.devin/skills — sweep it too or uninstall orphans those skills.
@@ -2106,8 +2109,9 @@ mod tests {
let without = skill_roots(cwd, Some(home), None, None, None, None);
assert_eq!(
without.len(),
- 10,
- "no phantom root when APPDATA is unset (claude/agents/devin/grok/copilot × project+global)"
+ 12,
+ "no phantom root when APPDATA is unset (claude/agents/devin/grok/copilot × \
+ project+global, plus Antigravity's two global roots)"
);
assert!(
without.contains(&cwd.join(GROK_SKILL_DIR).join(SKILLS_DIR)),
@@ -2258,6 +2262,24 @@ mod tests {
);
}
+ #[test]
+ fn skill_roots_sweep_both_antigravity_global_roots() {
+ let roots = skill_roots(
+ Path::new("/repo"),
+ Some(Path::new("/home/alice")),
+ None,
+ None,
+ None,
+ None,
+ );
+ for root in [
+ "/home/alice/.gemini/config/skills",
+ "/home/alice/.gemini/antigravity-cli/skills",
+ ] {
+ assert!(roots.contains(&PathBuf::from(root)), "{root}: {roots:?}");
+ }
+ }
+
#[test]
fn strip_instructions_round_trips_with_install_append() {
let original = "# Title\n";
diff --git a/crates/ai-memory-cli/tests/suite/removal.rs b/crates/ai-memory-cli/tests/suite/removal.rs
index 84ceb5af..5fc041be 100644
--- a/crates/ai-memory-cli/tests/suite/removal.rs
+++ b/crates/ai-memory-cli/tests/suite/removal.rs
@@ -1335,6 +1335,88 @@ fn install_skills_then_uninstall_only_skills_round_trips() {
);
}
+/// `install-skills --scope global --agent antigravity` writes the managed
+/// skills into both roots Antigravity reads, `~/.gemini/config/skills` (App
+/// and IDE) and `~/.gemini/antigravity-cli/skills` (CLI), and not into
+/// `~/.agents/skills`. A re-run changes nothing, and `uninstall --only skills`
+/// takes the skills back out of both roots while the user's own skill and
+/// Antigravity's MCP config beside them stay.
+#[test]
+fn antigravity_global_skills_install_idempotently_and_uninstall_from_both_roots() {
+ let _guard = cli_test_lock();
+ let project = tempfile::tempdir().unwrap();
+ let home = tempfile::tempdir().unwrap();
+ let roots = [
+ home.path().join(".gemini/config/skills"),
+ home.path().join(".gemini/antigravity-cli/skills"),
+ ];
+ let user_skill = roots[0].join("user-skill/SKILL.md");
+ write_file(&user_skill, "---\nname: user-skill\n---\nkeep me\n");
+ let mcp_config = home.path().join(".gemini/config/mcp_config.json");
+ write_file(&mcp_config, "{}\n");
+
+ let install = || {
+ command_with_home(home.path())
+ .args([
+ "install-skills",
+ "--scope",
+ "global",
+ "--agent",
+ "antigravity",
+ ])
+ .current_dir(project.path())
+ .output()
+ .unwrap()
+ };
+ let first = install();
+ assert!(
+ first.status.success(),
+ "install-skills failed: {}",
+ String::from_utf8_lossy(&first.stderr)
+ );
+ for root in &roots {
+ for skill in MANAGED_SKILLS {
+ assert!(
+ root.join(skill.relative_path).is_file(),
+ "{}",
+ root.join(skill.relative_path).display()
+ );
+ }
+ }
+ assert!(!home.path().join(".agents/skills").exists());
+
+ let second = install();
+ assert!(
+ second.status.success(),
+ "re-run failed: {}",
+ String::from_utf8_lossy(&second.stderr)
+ );
+ let stdout = String::from_utf8_lossy(&second.stdout);
+ assert_eq!(
+ stdout.matches("already up to date").count(),
+ roots.len() * MANAGED_SKILLS.len(),
+ "{stdout}"
+ );
+
+ let uninstall = run_uninstall(
+ project.path(),
+ home.path(),
+ &["uninstall", "--only", "skills", "--apply", "--yes"],
+ );
+ assert!(
+ uninstall.status.success(),
+ "uninstall failed: {}",
+ String::from_utf8_lossy(&uninstall.stderr)
+ );
+ for root in &roots {
+ for skill in MANAGED_SKILLS {
+ assert!(!root.join(skill.relative_path).exists());
+ }
+ }
+ assert!(user_skill.exists(), "the user's own skill must survive");
+ assert!(mcp_config.exists(), "Antigravity's MCP config must survive");
+}
+
#[test]
fn uninstall_only_skills_leaves_custom_target_dir_for_manual_cleanup() {
let _guard = cli_test_lock();
diff --git a/crates/ai-memory-core/src/routing_skills.rs b/crates/ai-memory-core/src/routing_skills.rs
index c9eeb719..84012b38 100644
--- a/crates/ai-memory-core/src/routing_skills.rs
+++ b/crates/ai-memory-core/src/routing_skills.rs
@@ -35,6 +35,16 @@ pub const GITHUB_SKILL_DIR: &str = ".github";
pub const COPILOT_SKILL_DIR: &str = ".copilot";
/// Hermes Agent Skill directory below a project or home root.
pub const HERMES_SKILL_DIR: &str = ".hermes";
+/// Google Antigravity's directory below the home root. Its global skills live
+/// in two directories under it, one per product; workspace skills use
+/// [`AGENTS_SKILL_DIR`] (<https://antigravity.google/docs/skills/>).
+pub const ANTIGRAVITY_HOME_DIR: &str = ".gemini";
+/// Below [`ANTIGRAVITY_HOME_DIR`]: the Antigravity App and IDE global skills
+/// parent, `~/.gemini/config`.
+pub const ANTIGRAVITY_APP_SKILL_DIR: &str = "config";
+/// Below [`ANTIGRAVITY_HOME_DIR`]: the Antigravity CLI global skills parent,
+/// `~/.gemini/antigravity-cli`.
+pub const ANTIGRAVITY_CLI_SKILL_DIR: &str = "antigravity-cli";
/// Leaf directory that contains individual Agent Skill directories.
pub const SKILLS_DIR: &str = "skills";
diff --git a/docs/install.md b/docs/install.md
index 15e869b7..28bd67e9 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -3250,7 +3250,7 @@ Linux, and macOS. This does not rewrite line endings in user-authored files.
|---|---|
| `--no-skills` | Refresh only the markered instruction block. |
| `--skills-scope <scope>` | Choose project-local or user-global skill roots. Values: `project`, `global`. Defaults to `project`. |
-| `--skills-agent <agent>` | Choose `.claude/skills`, `.agents/skills`, `.devin/skills`, `.grok/skills`, GitHub Copilot CLI's `.github/skills`, or both Claude/Agents roots. Values: `claude-code`, `agents`, `devin`, `grok`, `copilot-cli`, `both`. By default, `CLAUDE.md` targets imply `claude-code`, `AGENTS.md` targets imply `agents`, and both instruction files imply `both`. |
+| `--skills-agent <agent>` | Choose `.claude/skills`, `.agents/skills`, `.devin/skills`, `.grok/skills`, GitHub Copilot CLI's `.github/skills`, Google Antigravity's roots, or both Claude/Agents roots. Values: `claude-code`, `agents`, `devin`, `grok`, `copilot-cli`, `antigravity`, `both`. By default, `CLAUDE.md` targets imply `claude-code`, `AGENTS.md` targets imply `agents`, and both instruction files imply `both`. |
| `--skills-target-dir <dir>` | Write managed skill directories below an explicit root instead of inferring from scope and agent. |
| `--skills-force` | Replace unmanaged same-name skills during `install-instructions`; without it, they are left untouched and the command exits with an actionable error. |
@@ -3263,6 +3263,7 @@ ai-memory install-skills --scope global --agent agents
ai-memory install-skills --scope global --agent devin
ai-memory install-skills --scope global --agent grok
ai-memory install-skills --scope global --agent copilot-cli
+ai-memory install-skills --scope global --agent antigravity
ai-memory install-skills --agent both --print
ai-memory install-skills --target-dir .custom/skills --force
```
@@ -3272,17 +3273,17 @@ ai-memory install-skills --target-dir .custom/skills --force
| Flag | Meaning |
|---|---|
| `--scope <scope>` | Install into this project or the current user's global skill roots. Values: `project`, `global`. Defaults to `project`. |
-| `--agent <agent>` | Install into Claude Code's skill root, the cross-agent skill root, Devin's skill root, Grok's skill root, GitHub Copilot CLI's skill root, or both Claude/Agents roots. Values: `claude-code`, `agents`, `devin`, `grok`, `copilot-cli`, `both`. Defaults to `claude-code`. |
+| `--agent <agent>` | Install into Claude Code's skill root, the cross-agent skill root, Devin's skill root, Grok's skill root, GitHub Copilot CLI's skill root, Google Antigravity's skill roots, or both Claude/Agents roots. Values: `claude-code`, `agents`, `devin`, `grok`, `copilot-cli`, `antigravity` (aliases `antigravity-cli`, `agy`), `both`. Defaults to `claude-code`. |
| `--target-dir <dir>` | Write managed skill directories below an explicit root; `--scope` and `--agent` are ignored. |
| `--print` | Print target paths and `SKILL.md` contents without writing files. A global Grok plan also prints `$GROK_HOME/rules/ai-memory-handoff.md`. |
| `--force` | Replace unmanaged same-name skills (and, for global Grok, an unmanaged first-turn rule); without it, user-authored same-name files are preserved. |
Default skill target roots:
-| Scope | `--agent claude-code` | `--agent agents` | `--agent devin` | `--agent grok` | `--agent copilot-cli` |
-|---|---|---|---|---|---|
-| `project` | `.claude/skills` | `.agents/skills` | `.devin/skills` | `.grok/skills` | `.github/skills` |
-| `global` | `~/.claude/skills` | `~/.agents/skills` | Windows: `%APPDATA%\devin\skills`; non-Windows: `~/.devin/skills` | `$GROK_HOME/skills` (default `~/.grok/skills`), plus the first-turn rule `$GROK_HOME/rules/ai-memory-handoff.md` | `$COPILOT_HOME/skills` (default `~/.copilot/skills`) |
+| Scope | `--agent claude-code` | `--agent agents` | `--agent devin` | `--agent grok` | `--agent copilot-cli` | `--agent antigravity` |
+|---|---|---|---|---|---|---|
+| `project` | `.claude/skills` | `.agents/skills` | `.devin/skills` | `.grok/skills` | `.github/skills` | `.agents/skills` |
+| `global` | `~/.claude/skills` | `~/.agents/skills` | Windows: `%APPDATA%\devin\skills`; non-Windows: `~/.devin/skills` | `$GROK_HOME/skills` (default `~/.grok/skills`), plus the first-turn rule `$GROK_HOME/rules/ai-memory-handoff.md` | `$COPILOT_HOME/skills` (default `~/.copilot/skills`) | both `~/.gemini/config/skills` (Antigravity App and IDE) and `~/.gemini/antigravity-cli/skills` (Antigravity CLI) |
Each managed skill is written as `<root>/<skill-name>/SKILL.md`.
diff --git a/docs/support-matrix.md b/docs/support-matrix.md
index 080ce732..909e8d20 100644
--- a/docs/support-matrix.md
+++ b/docs/support-matrix.md
@@ -32,7 +32,7 @@
| Claude Desktop (Chat) | MCP-only | Uses `mcp-remote`; the ordinary Chat surface does not run lifecycle hooks. macOS, Windows, and Linux (Anthropic's Debian/Ubuntu beta, `~/.config/Claude/claude_desktop_config.json`). Cowork capture is not claimed; see the explicit boundary in [`mcp-install.md`](mcp-install.md#claude-desktop). |
| Claude Desktop (Code tab) | Supported | Local Code-tab sessions run Claude Code with the user's `~/.claude/settings.json`, so the Claude Code hooks capture them as `claude-code`; a session without a project folder lands in its own scratch-directory project. |
| OpenClaw | Supported | MCP config + native plugin lifecycle hooks; generated plugin enforces capture exclusions. |
-| Antigravity CLI | Supported | MCP config (`serverUrl`) + lifecycle hooks (`agy` alias). Only `PreInvocation` with `invocationNum = 0` on the first turn of a conversation maps to SessionStart (the counter restarts every turn, so later turns and later model calls cannot consume a next-session handoff). No automatic true session-end hook, so run `ai-memory finalize-session --agent antigravity-cli` after the final turn when you need a summary, handoff, and opt-in SessionEnd consolidation; an interactive session launched with `ai-memory run antigravity` is finalized automatically when it exits if the run can tie the session to itself (see [`docs/managed-workstreams.md`](managed-workstreams.md)). `ai-memory run antigravity` (aliases `antigravity-cli`, `agy`) adds managed workstream resume via `--conversation`; its conversation store is not decoded, so the ledger takes user prompts from `agy`'s `history.jsonl` (only this conversation's lines typed in this checkout) and assistant and tool steps from hook capture. Tool outputs (`run_command`, `view_file`, `list_dir`, etc.) are resolved directly from `.system_generated/steps/<stepIdx>/output.txt` during `post-tool-use` while mutation tools preserve code from arguments (#966). |
+| Antigravity CLI | Supported | MCP config (`serverUrl`) + lifecycle hooks (`agy` alias). Only `PreInvocation` with `invocationNum = 0` on the first turn of a conversation maps to SessionStart (the counter restarts every turn, so later turns and later model calls cannot consume a next-session handoff). No automatic true session-end hook, so run `ai-memory finalize-session --agent antigravity-cli` after the final turn when you need a summary, handoff, and opt-in SessionEnd consolidation; an interactive session launched with `ai-memory run antigravity` is finalized automatically when it exits if the run can tie the session to itself (see [`docs/managed-workstreams.md`](managed-workstreams.md)). `ai-memory run antigravity` (aliases `antigravity-cli`, `agy`) adds managed workstream resume via `--conversation`; its conversation store is not decoded, so the ledger takes user prompts from `agy`'s `history.jsonl` (only this conversation's lines typed in this checkout) and assistant and tool steps from hook capture. Tool outputs (`run_command`, `view_file`, `list_dir`, etc.) are resolved directly from `.system_generated/steps/<stepIdx>/output.txt` during `post-tool-use` while mutation tools preserve code from arguments (#966). Skills: Antigravity reads workspace skills from `.agents/skills` and global skills from `~/.gemini/config/skills` (App and IDE) and `~/.gemini/antigravity-cli/skills` (CLI), not from `~/.agents/skills` ([Antigravity docs](https://antigravity.google/docs/skills/)); `install-skills --scope global --agent antigravity` and `setup` write the managed skills into both global roots, and `uninstall --only skills` sweeps them. |
| Grok Build CLI | Supported | MCP config (`install-mcp --client grok` → `$GROK_HOME/config.toml`, default `~/.grok/config.toml`) + lifecycle hooks (`install-hooks --agent grok` → `$GROK_HOME/hooks/ai-memory.json`, default `~/.grok/hooks/ai-memory.json`, Grok-specific hook bundle). Capture works. `SessionStart` and `UserPromptSubmit` do not accept the handoff (Grok discards that stdout). `install-hooks --agent grok --apply` and `install-skills --scope global --agent grok` also write `$GROK_HOME/rules/ai-memory-handoff.md` so the first turn calls `memory_handoff_list` through `use_tool` with the qualified catalog key `ai-memory__memory_handoff_list` (Grok reaches MCP tools only through that meta-tool) ahead of any file read, correcting `workspace`/`project` from `./.ai-memory.toml` only when that list is empty or a scope error; the first `PostToolUse` then prints `hookSpecificOutput.additionalContext` with the pending handoff and an opted-in `[briefing]`. If that rule is absent and no tool runs, recover via MCP `memory_handoff_list` then `memory_handoff_accept` with that `handoff_id`. `ai-memory run grok` adds managed workstream resume with the context packet delivered natively through `--rules`. Skills root: `.grok/skills` / `$GROK_HOME/skills` (default `~/.grok/skills`). A prompt starting with `reload context` receives a compaction recap on the next `PostToolUse` `additionalContext`, not with the prompt (see [`usage.md`](usage.md#reload-context-after-a-compaction)). |
| Swival CLI | MCP-only | `install-mcp --client swival --apply` merges a native HTTP entry into the project-root `.swival/mcp.json`, preserving sibling servers. Lifecycle and managed-workstream support are not claimed because Swival's callback contract does not expose a stable session identifier. |
| Zero | Supported | `install-mcp --client zero` (native HTTP + bearer in `~/.config/zero/config.json` when the token is passed explicitly; a token-file install gets a stdio `ai-memory mcp-bridge --no-session-id` entry instead) + lifecycle hooks via `install-hooks --agent zero --apply` (exec-form native commands in `~/.config/zero/hooks.json`, JSON payload on stdin, no shell). Capture works incl. specialist (subagent) events; no handoff injection — Zero discards `sessionStart` stdout, so recover handoffs via MCP `memory_handoff_list` then `memory_handoff_accept` with that `handoff_id`. Zero runs hooks in its sandbox, which by default denies network (loopback too) and writes outside the workspace, so events stay in the hook spool: allow `sandbox.network` and add the ai-memory data dir to `sandbox.additionalWriteRoots` in the global `~/.config/zero/config.json` (network allow covers every Zero shell command; `sessionEnd` then delivers in-process within a fixed 10-second budget, since the sandbox kills detached drainers), or run `ai-memory hook-drain` from a normal shell (see [`mcp-install.md`](mcp-install.md#zero-gitlawbzero)). |
diff --git a/docs/usage.md b/docs/usage.md
index 34b168ff..fb60971b 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -470,6 +470,7 @@ ai-memory install-skills --scope global --agent devin
ai-memory install-skills --scope global --agent grok
ai-memory install-skills --scope global --agent copilot-cli
ai-memory install-skills --scope global --agent hermes
+ai-memory install-skills --scope global --agent antigravity
ai-memory install-skills --agent both --print
ai-memory install-skills --target-dir .custom/skills --force
```
@@ -484,7 +485,10 @@ handoff rule `$GROK_HOME/rules/ai-memory-handoff.md` (default
`--target-dir` do not. For GitHub Copilot CLI, project-local skills go under the
repository's `.github/skills` and global under `$COPILOT_HOME/skills` (default
`~/.copilot/skills`); Copilot CLI already loads `AGENTS.md`, so it shares the
-`AGENTS.md` instruction target.
+`AGENTS.md` instruction target. Google Antigravity reads workspace skills from
+`.agents/skills` and has two global roots, `~/.gemini/config/skills` for the
+App and IDE and `~/.gemini/antigravity-cli/skills` for the CLI; a global
+`--agent antigravity` install writes both, and `uninstall` sweeps both.
Project-local skill roots are `.claude/skills` for Claude-compatible installs,
`.agents/skills` for cross-client installs, `.devin/skills` for Devin, and