#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
import { existsSync, mkdirSync } from "node:fs";
import { homedir } from "node:os";
import { join } from "node:path";
import * as p from "@clack/prompts";
import { createJsonMcpAdapter } from "./json-mcp-adapter.js";
import type { ConnectOptions, ConnectResult } from "./types.js";
import {
buildMergedAntigravityHooks,
containsSpaces,
type AntigravityHookManifest,
} from "./antigravity-hooks.js";
import { findPluginRoot } from "./codex-hooks.js";
import {
backupFile,
logBackup,
logInstalled,
readJsonSafe,
writeJsonAtomic,
} from "./util.js";
// Current Antigravity surfaces share ~/.gemini/config customizations.
// Detection keys off the CLI's own state directory, not Gemini CLI's home.
// Sources: antigravity.google/docs/hooks, antigravity.google/docs/cli/using
const GEMINI_DIR = join(homedir(), ".gemini");
const ANTIGRAVITY_CLI_DIR = join(GEMINI_DIR, "antigravity-cli");
const CUSTOMIZATION_DIR = join(GEMINI_DIR, "config");
const ANTIGRAVITY_CLI_HOOKS = join(CUSTOMIZATION_DIR, "hooks.json");
export const adapter = createJsonMcpAdapter({
name: "antigravity-cli",
displayName: "Antigravity CLI (agy)",
detectDir: ANTIGRAVITY_CLI_DIR,
configPath: join(CUSTOMIZATION_DIR, "mcp_config.json"),
// agy does not expand shell-style ${NAME:-default} values. Inherit the
// runtime environment so custom endpoints and credentials survive.
extraEntryFields: { env: {} },
docs: "https://github.com/rohitg00/agentmemory#other-agents",
protocolNote:
"→ Using MCP via ~/.gemini/config/mcp_config.json, shared with current Antigravity IDE versions. The `/mcp` slash command inside agy lists configured servers. Pass --with-hooks to also install the native ~/.gemini/config/hooks.json auto-capture hooks.",
installHooks: installAntigravityCliHooks,
});
/**
* Merge the bundled `plugin/hooks/hooks.antigravity.json` into
* `~/.gemini/config/hooks.json`, replacing only the bundle agentmemory owns.
*/
export function installAntigravityCliHooks(opts: ConnectOptions): ConnectResult {
let pluginRoot: string;
try {
pluginRoot = findPluginRoot();
} catch (err) {
return {
kind: "skipped",
reason: err instanceof Error ? err.message : String(err),
};
}
// agy honours no quoting, so a space in the path yields hooks that load
// but never run. Refuse rather than install something that can only fail.
if (containsSpaces(pluginRoot)) {
return {
kind: "skipped",
reason: `Antigravity CLI cannot run hook commands whose path contains spaces, and agentmemory is installed at ${pluginRoot}. Reinstall it under a space-free path to use --with-hooks; MCP works either way.`,
};
}
const existing = readJsonSafe<AntigravityHookManifest>(ANTIGRAVITY_CLI_HOOKS);
const merged = buildMergedAntigravityHooks(existing, pluginRoot);
if (opts.dryRun) {
p.log.info(
`[dry-run] Would ${existing ? "merge" : "create"} ${ANTIGRAVITY_CLI_HOOKS} with ${Object.keys(merged).length} hook bundle(s)`,
);
return { kind: "installed", mutatedPath: ANTIGRAVITY_CLI_HOOKS };
}
let backupPath: string | undefined;
if (existsSync(ANTIGRAVITY_CLI_HOOKS)) {
backupPath = backupFile(ANTIGRAVITY_CLI_HOOKS, "antigravity-cli-hooks", "json");
logBackup(backupPath);
} else {
mkdirSync(CUSTOMIZATION_DIR, { recursive: true });
}
writeJsonAtomic(ANTIGRAVITY_CLI_HOOKS, merged);
logInstalled("Antigravity CLI hooks", ANTIGRAVITY_CLI_HOOKS);
p.log.info(
"User-scope hooks reference absolute paths under the bundled plugin/ dir. Re-run `agentmemory connect antigravity-cli --with-hooks` after upgrading agentmemory to refresh them.",
);
return {
kind: "installed",
mutatedPath: ANTIGRAVITY_CLI_HOOKS,
...(backupPath !== undefined && { backupPath }),
};
}