@aefree/pi-unity 0.9.2 → 0.9.3

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project follows semantic versioning for public package releases.
 
+## [0.9.3] - 2026-08-10
+
+### Added
+
+- Added an optional `automated` parameter to `unity_open_editor`, forwarding Unity Editor's `-automated` flag through both Unity CLI and direct Editor launch paths.
+
 ## [0.9.2] - 2026-08-08
 
 ### Changed

package/README.md

@@ -43,7 +43,7 @@ A timeout is uncertain: work may still be running. The tools do not silently can
 
 ### Editor and batchmode
 
-- `unity_open_editor` — open the Unity Editor GUI.
+- `unity_open_editor` — open the Unity Editor GUI. Pass `automated: true` to add the Unity Editor `-automated` flag; this is distinct from the Unity CLI's own `--non-interactive` option.
 - `unity_launch_batchmode` — run a bounded batchmode command through Unity CLI or the direct Editor executable.
 - `unity_run_test_batch` — run one isolated or report-producing Unity Test Framework platform with generated XML and log paths.
 - `unity_inspect_artifacts` — summarize existing Unity Test Framework XML and Unity logs without launching Unity.

package/index.ts

@@ -103,6 +103,7 @@ type UnityLauncherPreference = "auto" | "unity-cli" | "editor-executable";
 const OPEN_EDITOR_PARAMS = Type.Object({
   path: Type.Optional(Type.String({ description: "Unity project path, workspace copy root, or folder containing project copies." })),
   unityEditorPath: Type.Optional(Type.String({ description: "Optional explicit Unity executable path override." })),
+  automated: Type.Optional(Type.Boolean({ default: false, description: "Pass Unity Editor's -automated flag when opening the project. Defaults to false." })),
   launcher: LAUNCHER_SCHEMA,
 });
 
@@ -1578,7 +1579,7 @@ export default function freeUnityPi(pi: ExtensionAPI) {
   pi.registerTool({
     name: "unity_open_editor",
     label: "Unity Open Editor",
-    description: "Open the Unity Editor GUI for a Unity project copy.",
+    description: "Open the Unity Editor GUI for a Unity project copy, optionally passing Unity Editor's -automated flag.",
     promptSnippet: "Open the Unity Editor GUI for a resolved Unity project when the user explicitly asks for the editor to open.",
     promptGuidelines: [
       "Use this tool only when the user explicitly wants the Unity Editor GUI opened.",
@@ -1605,11 +1606,12 @@ export default function freeUnityPi(pi: ExtensionAPI) {
         launch = launchUnityCliOpenDetached(candidate.projectRoot, {
           editorVersion: candidate.unityVersion,
           editorPath: params.unityEditorPath,
+          automated: params.automated,
         });
       } else {
         await assertUnityProjectNotBusy(candidate.projectRoot);
         editorPath = await resolveUnityEditorPath(candidate.unityVersion, { overridePath: params.unityEditorPath });
-        launch = launchUnityEditorDetached(editorPath, candidate.projectRoot);
+        launch = launchUnityEditorDetached(editorPath, candidate.projectRoot, { automated: params.automated });
       }
       const text = buildEditorLaunchSummary(ctx.cwd, candidate, editorPath, discoveryWarning, launcher);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aefree/pi-unity",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "type": "module",
   "exports": {
     ".": "./index.ts"

package/src/unity-cli.ts

@@ -18,6 +18,8 @@ export type UnityCliLaunchOptions = {
   timeoutSeconds?: number;
   cliCommand?: string;
   useGraphics?: boolean;
+  /** Forward Unity Editor's -automated flag through `unity open --args`. */
+  automated?: boolean;
 };
 
 export type UnityCliPipelineInstance = {
@@ -80,6 +82,7 @@ function appendUnityCliEditorOptions(args: string[], options: UnityCliLaunchOpti
 export function createUnityCliOpenCommand(projectRoot: string, options: UnityCliLaunchOptions = {}): UnityCliCommand {
   const args = [...unityCliBaseArgs(), "open", projectRoot];
   appendUnityCliEditorOptions(args, options);
+  if (options.automated) args.push("--args", "-automated");
   return {
     command: resolveUnityCliCommand(options),
     args,

package/src/unity-core.ts

@@ -64,8 +64,13 @@ export function buildUnityEditorCandidates(
   ];
 }
 
-export function buildUnityOpenEditorArgs(projectRoot: string): string[] {
-  return ["-projectPath", projectRoot];
+export type UnityOpenEditorArgsOptions = {
+  /** Pass Unity Editor's -automated flag. */
+  automated?: boolean;
+};
+
+export function buildUnityOpenEditorArgs(projectRoot: string, options: UnityOpenEditorArgsOptions = {}): string[] {
+  return ["-projectPath", projectRoot, ...(options.automated ? ["-automated"] : [])];
 }
 
 export type UnityBatchmodeArgsOptions = {

package/src/unity-launch.ts

@@ -7,6 +7,7 @@ import {
   buildUnityOpenEditorArgs,
   normalizeUnityEditorOverride,
   type SupportedPlatform,
+  type UnityOpenEditorArgsOptions,
 } from "./unity-core";
 import { createUnityCliOpenCommand, type UnityCliLaunchOptions } from "./unity-cli";
 
@@ -47,8 +48,12 @@ export async function resolveUnityEditorPath(
   );
 }
 
-export function launchUnityEditorDetached(editorPath: string, projectRoot: string): { pid: number | undefined; args: string[]; command: string } {
-  const args = buildUnityOpenEditorArgs(projectRoot);
+export function launchUnityEditorDetached(
+  editorPath: string,
+  projectRoot: string,
+  options: UnityOpenEditorArgsOptions = {},
+): { pid: number | undefined; args: string[]; command: string } {
+  const args = buildUnityOpenEditorArgs(projectRoot, options);
   const child = spawn(editorPath, args, {
     detached: true,
     stdio: "ignore",