{"record":{"id":"094a005af93b8c52","repo":"slopus/happy","slug":"the-gemini-backend-is-deprecated-and-may-be-remo","errorCode":null,"errorMessage":"⚠ The gemini backend is deprecated and may be removed in a future release. Use `happy agy` (Antigravity CLI) instead.","messagePattern":"⚠ The gemini backend is deprecated and may be removed in a future release\\. Use `happy agy` \\(Antigravity CLI\\) instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/happy-cli/src/index.ts","lineNumber":335,"sourceCode":"    // Handle \"happy gemini project\" (no subcommand) - show help\n    if (geminiSubcommand === 'project' && !args[2]) {\n      console.log('Usage: happy gemini project <command>');\n      console.log('');\n      console.log('Commands:');\n      console.log('  set <project-id>   Set Google Cloud Project ID');\n      console.log('  get                Show current Google Cloud Project ID');\n      console.log('');\n      console.log('Google Workspace accounts require a Google Cloud Project.');\n      console.log('If you see \"Authentication required\" error, set your project ID.');\n      console.log('');\n      console.log('Guide: https://goo.gle/gemini-cli-auth-docs#workspace-gca');\n      process.exit(0);\n    }\n    \n    // Handle gemini command (ACP-based agent)\n    try {\n      // The standalone gemini CLI is EOL; agy (Antigravity CLI) is its successor.\n      console.warn(chalk.yellow('⚠ The gemini backend is deprecated and may be removed in a future release. Use `happy agy` (Antigravity CLI) instead.'));\n\n      const { runGemini } = await import('@/gemini/runGemini');\n\n      // Parse startedBy argument\n      let startedBy: 'daemon' | 'terminal' | undefined = undefined;\n      for (let i = 1; i < args.length; i++) {\n        if (args[i] === '--started-by') {\n          startedBy = args[++i] as 'daemon' | 'terminal';\n        }\n      }\n      \n      const {\n        credentials\n      } = await authAndSetupMachineIfNeeded();\n      await ensureDaemonRunning()\n\n      await runGemini({credentials, startedBy});\n    } catch (error) {","sourceCodeStart":317,"sourceCodeEnd":353,"githubUrl":"https://github.com/slopus/happy/blob/b824cd0a4681d41af631a8e422a813873e4455b0/packages/happy-cli/src/index.ts#L317-L353","documentation":"The `happy gemini` command prints a deprecation notice before dispatching to runGemini. The standalone Gemini CLI is EOL and Google's Antigravity CLI (agy) is its successor; this backend may be removed in a future happy release.","triggerScenarios":"Invoking `happy gemini ...` (the ACP-based gemini agent path in index.ts) in any form.","commonSituations":"Scripts, aliases, or muscle memory still calling `happy gemini` after upgrading happy; docs/tutorials referencing the old command.","solutions":["Switch to `happy agy` (Antigravity CLI) for the supported backend.","Update scripts/aliases from `happy gemini` to `happy agy`.","Install/authenticate the Antigravity CLI if not yet set up (see `happy agy --help` / happy connect for the new backend).","Plan for removal: pin the current happy version if you must keep gemini temporarily."],"exampleFix":"// before\nhappy gemini \"fix the bug\"\n// after\nhappy agy \"fix the bug\"","handlingStrategy":"fallback","validationCode":"// grep scripts/aliases for the deprecated command before upgrading\ngrep -rn \"happy gemini\" scripts/ .bashrc .zshrc 2>/dev/null","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Replace `happy gemini` with `happy agy` in scripts and shell aliases now.","Read happy release notes for deprecation/removal timelines.","Pin the happy version in CI if you rely on legacy backends.","Wrap legacy commands in an alias that maps to the new one."],"tags":["deprecation","gemini","cli","migration"],"backgroundTag":"deprecated-command","analyzedSha":"b824cd0a4681d41af631a8e422a813873e4455b0","analyzedAt":"2026-08-31T23:12:36.205Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T05:18:18.240Z"}