Expose firebase init aitools command (#8949)

* fix(init): update Claude AIToolModule for latest Claude Code compatibility

Updates MCP server configuration to use .mcp.json instead of deprecated .claude/settings.local.json.
Updates to use CLAUDE.md instead of deprecated CLAUDE.local.md.
Fixes compatibility with Claude Code 1.0.69+.

* feat(init): expose aitools command

Adds firebase init:aitools to available commands.
Fixes formatting in FIREBASE.md prompt file.

* fix(init): register aitools in command choices

Adds aitools to init command choices array so it's recognized as valid feature.
Marked as hidden to keep it from public menu while in development.

* Update src/init/features/aitools/claude.ts

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* style

* add changelog.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Joe Hanley <[email protected]>

Author: 3 people

CHANGELOG.md

@@ -1,4 +1,6 @@
+- Fixed issue where `__name__` fields with DESCENDING order were incorrectly filtered from index listings, causing duplicate index issues (#7629) and deployment conflicts (#8859). The fix now preserves `__name__` fields with explicit DESCENDING order while filtering out implicit ASCENDING `__name__` fields.
 - Fixed an issue where `firebase init dataconnect` didn't enable the Data Connect API by default (#8927).
+- Add firebase init aitools to help developers set up Firebase AI tools in their projects (#8949).
 - Updated the Firebase Data Connect local toolkit to v2.11.0, which includes the following changes (#8948):
   - [Fixed] Kotlin code generation with enums
   - [Fixed] Deploying schemas with enums would report false breaking changes

prompts/FIREBASE.md

@@ -32,8 +32,7 @@ firebase deploy --except functions
 
 firebase use staging
 firebase use production
-
-````
+```
 </example>
 
 ## Local Development

src/commands/init.ts

@@ -116,6 +116,13 @@ if (isEnabled("apptesting")) {
   });
 }
 
+choices.push({
+  value: "aitools",
+  name: "AI Tools: Configure AI coding assistants to work with your Firebase project",
+  checked: false,
+  hidden: true,
+});
+
 const featureNames = choices.map((choice) => choice.value);
 
 const HELP = `Interactively configure the current directory as a Firebase project or initialize new features in an already configured Firebase project directory.

src/init/features/aitools/claude.ts

@@ -2,8 +2,8 @@ import { Config } from "../../../config";
 import { AIToolModule, AIToolConfigResult } from "./types";
 import { updateFirebaseSection } from "./promptUpdater";
 
-const CLAUDE_SETTINGS_PATH = ".claude/settings.local.json";
-const CLAUDE_PROMPT_PATH = "CLAUDE.local.md";
+const MCP_CONFIG_PATH = ".mcp.json";
+const CLAUDE_PROMPT_PATH = "CLAUDE.md";
 
 export const claude: AIToolModule = {
   name: "claude",
@@ -12,8 +12,8 @@ export const claude: AIToolModule = {
   /**
    * Configures Claude Code with Firebase context.
    *
-   * - .claude/settings.local.json: Merges with existing config (preserves user settings)
-   * - CLAUDE.local.md: Updates Firebase section only (preserves user content)
+   * - .mcp.json: Merges with existing MCP server config (preserves user settings)
+   * - CLAUDE.md: Updates Firebase section only (preserves user content)
    */
   async configure(
     config: Config,
@@ -22,11 +22,11 @@ export const claude: AIToolModule = {
   ): Promise<AIToolConfigResult> {
     const files: AIToolConfigResult["files"] = [];
 
-    // Handle MCP configuration - merge with existing if present
-    let existingConfig: any = {};
-    let settingsUpdated = false;
+    // Handle MCP configuration in .mcp.json - merge with existing if present
+    let existingConfig: { mcpServers?: Record<string, { command: string; args: string[] }> } = {};
+    let mcpUpdated = false;
     try {
-      const existingContent = config.readProjectFile(CLAUDE_SETTINGS_PATH);
+      const existingContent = config.readProjectFile(MCP_CONFIG_PATH);
       if (existingContent) {
         existingConfig = JSON.parse(existingContent);
       }
@@ -43,11 +43,11 @@ export const claude: AIToolModule = {
         command: "npx",
         args: ["-y", "firebase-tools", "experimental:mcp", "--dir", projectPath],
       };
-      config.writeProjectFile(CLAUDE_SETTINGS_PATH, JSON.stringify(existingConfig, null, 2));
-      settingsUpdated = true;
+      config.writeProjectFile(MCP_CONFIG_PATH, JSON.stringify(existingConfig, null, 2));
+      mcpUpdated = true;
     }
 
-    files.push({ path: CLAUDE_SETTINGS_PATH, updated: settingsUpdated });
+    files.push({ path: MCP_CONFIG_PATH, updated: mcpUpdated });
 
     const { updated } = await updateFirebaseSection(config, CLAUDE_PROMPT_PATH, enabledFeatures, {
       interactive: true,

src/init/features/index.ts

@@ -36,3 +36,4 @@ export {
   RequiredInfo as ApptestingInfo,
   actuate as apptestingAcutate,
 } from "./apptesting";
+export { doSetup as aitools } from "./aitools";

src/init/index.ts

@@ -87,6 +87,7 @@ const featuresList: Feature[] = [
     askQuestions: features.apptestingAskQuestions,
     actuate: features.apptestingAcutate,
   },
+  { name: "aitools", displayName: "AI Tools", doSetup: features.aitools },
 ];
 
 const featureMap = new Map(featuresList.map((feature) => [feature.name, feature]));