The best way to control Claude Code, Codex and more from any computer or phone

main
ts 84 lines 3.11 KB
Raw
1 import { tokenizeCliArgs } from "@t3tools/shared/cliArgs";
2
3 const T3CODE_CODEX_LAUNCH_ARGS_ENV = "T3CODE_CODEX_LAUNCH_ARGS";
4
5 export const resolveCodexLaunchArgs = (
6 launchArgs?: string,
7 environment: NodeJS.ProcessEnv = process.env,
8 ) => {
9 const override = environment[T3CODE_CODEX_LAUNCH_ARGS_ENV];
10 return override?.trim() ? override : launchArgs?.trim() || "";
11 };
12
13 const codexLaunchArgv = (launchArgs?: string): ReadonlyArray<string> => tokenizeCliArgs(launchArgs);
14
15 // T3 unsubscribes only when it unloads a thread; Codex's own unload delay would stack on that.
16 export const codexAppServerArgs = (launchArgs?: string) => [
17 "app-server",
18 "-c",
19 "thread_unload_delay_secs=0",
20 ...codexLaunchArgv(launchArgs),
21 ];
22
23 interface LaunchArgFilter {
24 readonly switches: ReadonlySet<string>;
25 readonly valueFlags: ReadonlySet<string>;
26 readonly inlinePrefixes: ReadonlyArray<string>;
27 }
28
29 const SHARED_VALUE_FLAGS = ["--config", "-c", "--enable", "--disable"];
30 const SHARED_INLINE_PREFIXES = ["--config=", "-c=", "--enable=", "--disable="];
31
32 const MCP_LIST_FILTER: LaunchArgFilter = {
33 switches: new Set(),
34 valueFlags: new Set([...SHARED_VALUE_FLAGS, "--profile", "-p"]),
35 inlinePrefixes: [...SHARED_INLINE_PREFIXES, "--profile=", "-p="],
36 };
37
38 const EXEC_FILTER: LaunchArgFilter = {
39 switches: new Set(["--strict-config", "--oss"]),
40 valueFlags: new Set([...SHARED_VALUE_FLAGS, "--local-provider", "--profile", "-p"]),
41 inlinePrefixes: [...SHARED_INLINE_PREFIXES, "--local-provider=", "--profile=", "-p="],
42 };
43
44 const filterLaunchArgs = (launchArgs: string | undefined, allowed: LaunchArgFilter) => {
45 const args = codexLaunchArgv(launchArgs);
46 const kept: Array<string> = [];
47
48 for (let index = 0; index < args.length; index++) {
49 const rawArg = args[index];
50 if (rawArg === undefined) continue;
51 const arg = rawArg.replace(/^(-[cp])(?=[^=])/u, "$1=");
52
53 if (allowed.switches.has(arg)) {
54 kept.push(arg);
55 } else if (allowed.valueFlags.has(arg)) {
56 const value = args[index + 1];
57 if (value !== undefined && !value.startsWith("-")) {
58 kept.push(arg, value);
59 index++;
60 }
61 } else if (allowed.inlinePrefixes.some((prefix) => arg.startsWith(prefix))) {
62 kept.push(arg);
63 }
64 }
65
66 return kept;
67 };
68
69 const MCP_LIST_DISABLED_FEATURES = new Set(["apps", "connectors", "plugins"]);
70 const EXEC_DISABLED_FEATURES = new Set([...MCP_LIST_DISABLED_FEATURES, "hooks", "codex_hooks"]);
71
72 // Codex can apply explicit --enable flags after trailing -c overrides.
73 const omitFeatureEnables = (args: ReadonlyArray<string>, features: ReadonlySet<string>) =>
74 args.filter((arg, index) => {
75 if (arg.startsWith("--enable=")) return !features.has(arg.slice("--enable=".length));
76 if (arg === "--enable") return !features.has(args[index + 1] ?? "");
77 return !(args[index - 1] === "--enable" && features.has(arg));
78 });
79
80 export const codexExecLaunchArgs = (launchArgs?: string) =>
81 omitFeatureEnables(filterLaunchArgs(launchArgs, EXEC_FILTER), EXEC_DISABLED_FEATURES);
82
83 export const codexMcpListLaunchArgs = (launchArgs?: string) =>
84 omitFeatureEnables(filterLaunchArgs(launchArgs, MCP_LIST_FILTER), MCP_LIST_DISABLED_FEATURES);