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.mdindex 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-16diff --git a/crates/ai-memory-cli/src/cli.rs b/crates/ai-memory-cli/src/cli.rsindex 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.rsindex 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.rsindex 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::Agentsdiff --git a/crates/ai-memory-cli/src/commands/uninstall.rs b/crates/ai-memory-cli/src/commands/uninstall.rsindex 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.rsindex 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.rsindex 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.mdindex 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 agentsai-memory install-skills --scope global --agent devinai-memory install-skills --scope global --agent grokai-memory install-skills --scope global --agent copilot-cli+ai-memory install-skills --scope global --agent antigravityai-memory install-skills --agent both --printai-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.mdindex 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.mdindex 34b168ff..fb60971b 100644--- a/docs/usage.md+++ b/docs/usage.md@@ -470,6 +470,7 @@ ai-memory install-skills --scope global --agent devinai-memory install-skills --scope global --agent grokai-memory install-skills --scope global --agent copilot-cliai-memory install-skills --scope global --agent hermes+ai-memory install-skills --scope global --agent antigravityai-memory install-skills --agent both --printai-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 therepository'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