feat: added ability to supply appleId + password. Added completions

Author: kevinwang5658

completions-cron/src/__generated__/completions-index.ts

@@ -5,12 +5,14 @@ description: Reference page for the xcodes resource
 
 The xcodes resource installs the [xcodes CLI](https://github.com/XcodesOrg/xcodes) tool and manages multiple Xcode versions on macOS. xcodes is the recommended way for iOS/macOS teams to ensure all developers are running the same Xcode version.
 
-Installing Xcode versions requires an Apple Developer account. xcodes will prompt for Apple ID credentials interactively on first use and caches them in the macOS Keychain. For non-interactive environments, set `XCODES_USERNAME` and `XCODES_PASSWORD` environment variables before applying.
+Installing Xcode versions requires an Apple Developer account. xcodes will prompt for Apple ID credentials interactively on first use and caches them in the macOS Keychain. For non-interactive environments, supply `appleId` and `appSpecificPassword` directly in the resource config.
 
 ## Parameters
 
 - **xcodeVersions**: *(string[])* List of Xcode versions to install (e.g. `["15.4", "14.3.1"]`). Version strings match what `xcodes list` shows — stable versions use a dotted number (`15.4`), beta/RC versions include the label (`15 Beta 3`).
 - **selected**: *(string)* The active Xcode version to use, equivalent to running `xcodes select`. Must be one of the installed `xcodeVersions`.
+- **appleId**: *(string, optional)* Apple ID email used to authenticate with Apple's servers when downloading Xcode. If omitted, xcodes will prompt interactively.
+- **appleIdPassword**: *(string, optional)* Apple ID password. Required alongside `appleId` for non-interactive installs.
 
 ## Example usage
 
@@ -42,11 +44,19 @@ Multiple versions side by side:
 
 xcodes requires Apple ID credentials to download Xcode from Apple's servers. On first install Codify will prompt for your credentials interactively (including two-factor authentication). The credentials are stored in the macOS Keychain for future use.
 
-For CI or fully non-interactive environments, export the following environment variables before running Codify:
+For CI or fully non-interactive environments, add `appleId` and `appSpecificPassword` to the resource config:
 
-```bash
-export XCODES_USERNAME="your@apple.id"
-export XCODES_PASSWORD="your-app-specific-password"
+```json title="codify.jsonc"
+[
+  {
+    "type": "xcodes",
+    "xcodeVersions": ["15.4"],
+    "selected": "15.4",
+    "appleId": "your@apple.id",
+    "appleIdPassword": "<Replace me here!>",
+    "os": ["macOS"]
+  }
+]
 ```
 
-Use an [app-specific password](https://appleid.apple.com/account/manage) rather than your main Apple ID password when running non-interactively.
+Note that 2FA will still trigger interactively even with credentials set — xcodes does not support fully headless 2FA bypass.

docs/resources/(resources)/xcodes.mdx

@@ -1,6 +1,6 @@
 {
   "name": "default",
-  "version": "1.13.0",
+  "version": "1.14.0-beta.4",
   "description": "Default plugin for Codify - provides 50+ declarative resources for managing development tools and system configuration across macOS and Linux",
   "main": "dist/index.js",
   "scripts": {

package.json

@@ -0,0 +1,23 @@
+const XCODE_RELEASES_URL = 'https://xcodereleases.com/data.json';
+
+interface XcodeRelease {
+  version: {
+    number: string;
+    release: { release?: boolean; beta?: number; rc?: number; dp?: number };
+  };
+}
+
+function toXcodesVersionString(release: XcodeRelease): string {
+  const { number, release: rel } = release.version;
+  if (rel.release) return number;
+  if (rel.beta != null) return `${number} Beta ${rel.beta}`;
+  if (rel.rc != null) return `${number} RC ${rel.rc}`;
+  if (rel.dp != null) return `${number} DP ${rel.dp}`;
+  return number;
+}
+
+export default async function loadXcodeVersions(): Promise<string[]> {
+  const response = await fetch(XCODE_RELEASES_URL);
+  const releases = await response.json() as XcodeRelease[];
+  return releases.map(toXcodesVersionString);
+}

src/resources/xcodes/completions/xcodes.xcodeVersions.ts

@@ -1,4 +1,4 @@
-import { ArrayStatefulParameter, getPty } from '@codifycli/plugin-core';
+import { ArrayStatefulParameter, Plan, getPty } from '@codifycli/plugin-core';
 
 import { XcodesConfig } from './xcodes-resource.js';
 
@@ -9,9 +9,19 @@ export class XcodeVersionsParameter extends ArrayStatefulParameter<XcodesConfig,
     return parseInstalledVersions(data);
   }
 
-  override async addItem(version: string): Promise<void> {
+  override async addItem(version: string, plan: Plan<XcodesConfig>): Promise<void> {
     const $ = getPty();
-    await $.spawn(`xcodes install "${version}"`, { interactive: true, stdin: true });
+    const { appleId, appleIdPassword } = plan.desiredConfig ?? {};
+
+    const env: Record<string, string> = {};
+    if (appleId) env['XCODES_USERNAME'] = appleId;
+    if (appleIdPassword) env['XCODES_PASSWORD'] = appleIdPassword;
+
+    await $.spawn(`xcodes install "${version}"`, {
+      interactive: true,
+      stdin: true,
+      ...(Object.keys(env).length > 0 ? { env } : {}),
+    });
   }
 
   override async removeItem(version: string): Promise<void> {

src/resources/xcodes/xcode-versions-parameter.ts

@@ -17,11 +17,7 @@ const schema = z
   .object({
     xcodeVersions: z
       .array(z.string())
-      .describe(
-        'List of Xcode versions to install via xcodes (e.g. ["15.2", "14.3.1"]). ' +
-        'Installing Xcode requires Apple ID credentials — xcodes will prompt interactively or use ' +
-        'the XCODES_USERNAME and XCODES_PASSWORD environment variables for non-interactive installs.'
-      )
+      .describe('List of Xcode versions to install via xcodes (e.g. ["15.2", "14.3.1"]).')
       .optional(),
     selected: z
       .string()
@@ -30,6 +26,19 @@ const schema = z
         'Must be one of the installed xcodeVersions. Equivalent to running xcodes select.'
       )
       .optional(),
+    appleId: z
+      .string()
+      .optional()
+      .describe(
+        'Apple ID email used to authenticate with Apple servers when downloading Xcode. ' +
+        'If omitted, xcodes will prompt interactively on first install.'
+      ),
+    appleIdPassword: z
+      .string()
+      .optional()
+      .describe(
+        'Apple ID password. Required alongside appleId for non-interactive installs.'
+      ),
   })
   .describe('xcodes resource — install and manage multiple Xcode versions via the xcodes CLI');
 
@@ -75,6 +84,8 @@ export class XcodesResource extends Resource<XcodesConfig> {
       parameterSettings: {
         xcodeVersions: { type: 'stateful', definition: new XcodeVersionsParameter(), order: 1 },
         selected: { type: 'stateful', definition: new XcodesSelectedParameter(), order: 2 },
+        appleId: { type: 'string', setting: true },
+        appleIdPassword: { type: 'string', setting: true },
       },
     };
   }