feat(shared): add fx by Vercel as a built-in terminal agent (#6768)

* feat(shared): add fx by Vercel as a built-in terminal agent

Adds Vercel's fx to BUILTIN_TERMINAL_AGENTS, with light/dark preset icons, README row, docs bullet, and marketing demo entry. Prompt launches run fx ask --auto and continue the saved session via fx resume last; resume is fx resume <id>. Verified end-to-end against an installed fx 0.0.5.

Claude-Session: https://claude.ai/code/session_01DuAhw6Ao5Cru3acdkrzx9f

* feat(desktop): expose fx in the icon picker, settings search, and preset docs

Claude-Session: https://claude.ai/code/session_01DuAhw6Ao5Cru3acdkrzx9f

Author: Kitenite

README.md

@@ -193,6 +193,7 @@ Superset works with any CLI-based coding agent, including:
 | <picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/codex-white.svg" /><img height="16" align="top" alt="OpenAI Codex CLI" src="packages/ui/src/assets/icons/preset-icons/codex.svg" /></picture> &nbsp;[OpenAI Codex CLI](https://github.com/openai/codex) | Fully supported |
 | <img height="16" align="top" alt="Cursor Agent" src="packages/ui/src/assets/icons/preset-icons/cursor.svg" /> &nbsp;[Cursor Agent](https://docs.cursor.com/agent) | Fully supported |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/droid-white.svg" /><img height="16" align="top" alt="Droid" src="packages/ui/src/assets/icons/preset-icons/droid.svg" /></picture> &nbsp;[Droid](https://www.factory.ai/) | Fully supported |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/fx-white.svg" /><img height="16" align="top" alt="fx" src="packages/ui/src/assets/icons/preset-icons/fx.svg" /></picture> &nbsp;[fx](https://fx.sh/) | Fully supported |
 | <img height="16" align="top" alt="Gemini CLI" src="packages/ui/src/assets/icons/preset-icons/gemini.svg" /> &nbsp;[Gemini CLI](https://github.com/google-gemini/gemini-cli) | Fully supported |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/copilot-white.svg" /><img height="16" align="top" alt="GitHub Copilot" src="packages/ui/src/assets/icons/preset-icons/copilot.svg" /></picture> &nbsp;[GitHub Copilot](https://github.com/features/copilot) | Fully supported |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/grok-white.svg" /><img height="16" align="top" alt="Grok" src="packages/ui/src/assets/icons/preset-icons/grok.svg" /></picture> &nbsp;[Grok](https://x.ai/) | Fully supported |

apps/desktop/src/renderer/routes/_authenticated/settings/agents/components/V2AgentsSettings/components/AgentIconPicker/agent-icon-options.ts

@@ -22,6 +22,7 @@ export const AGENT_ICON_OPTIONS: readonly AgentIconOption[] = [
 	{ id: "vibe", label: "Mistral Vibe" },
 	{ id: "kimi", label: "Kimi Code" },
 	{ id: "grok", label: "Grok" },
+	{ id: "fx", label: "fx" },
 	{ id: "agy", label: "Antigravity" },
 	{ id: "kiro", label: "Kiro" },
 ];

apps/desktop/src/renderer/routes/_authenticated/settings/utils/settings-search/settings-search.ts

@@ -867,6 +867,8 @@ export const SETTINGS_ITEMS: SettingsItem[] = [
 			"moonshot",
 			"grok",
 			"xai",
+			"fx",
+			"vercel",
 			"antigravity",
 			"agy",
 			"google",
@@ -933,6 +935,8 @@ export const SETTINGS_ITEMS: SettingsItem[] = [
 			"moonshot",
 			"grok",
 			"xai",
+			"fx",
+			"vercel",
 			"antigravity",
 			"agy",
 			"google",

apps/docs/content/docs/agent-integration.mdx

@@ -25,6 +25,7 @@ Run AI coding agents in isolated workspaces. Each agent works independently with
 - **Cursor Agent** - Cursor AI agent
 - **Droid** - Factory's autonomous coding agent
 - **Polygraph** - Meta-harness with cross-repo visibility and persistent memory
+- **fx** - Vercel's terminal coding agent
 - **Antigravity** - Google's Antigravity CLI (`agy`)
 - **Kiro** - AWS's spec-driven CLI coding agent
 

apps/docs/content/docs/terminal-presets.mdx

@@ -55,6 +55,7 @@ Pre-configured presets for popular AI agents. Defaults mirror the bundled Supers
 - **vibe** - `vibe --trust --auto-approve` (Mistral's coding agent; trust grants access to `AGENTS.md` and `.agents/skills/`)
 - **kimi** - `kimi` (Kimi Code CLI; prompt launches run with `kimi -p` and resume in the interactive TUI)
 - **grok** - `grok --always-approve` (xAI's Grok Build CLI; prompts seed the interactive session directly)
+- **fx** - `fx` (Vercel's coding agent; prompt launches run `fx ask --auto` and resume the session in the TUI)
 - **agy** - `agy --mode accept-edits` (Google's Antigravity CLI; prompt launches seed the interactive session with `-i`)
 - **kiro** - `kiro-cli chat --trust-all-tools` (AWS's Kiro CLI; prompts seed the interactive session directly)
 

apps/marketing/public/app-icons/fx.svg

@@ -15,6 +15,7 @@ const AGENTS = [
 	{ name: "Mistral Vibe", icon: "/app-icons/vibe.svg", size: 18 },
 	{ name: "Kimi Code", icon: "/app-icons/kimi.svg", size: 18 },
 	{ name: "Grok CLI", icon: "/app-icons/grok.svg", size: 18 },
+	{ name: "fx", icon: "/app-icons/fx.svg", size: 18 },
 	{ name: "Antigravity", icon: "/app-icons/agy.svg", size: 18 },
 	{ name: "Kiro", icon: "/app-icons/kiro.svg", size: 18 },
 ];

apps/marketing/src/app/components/FeaturesSection/components/UniversalCompatibilityDemo/UniversalCompatibilityDemo.tsx

@@ -153,6 +153,34 @@ describe("agy agent registration", () => {
 	});
 });
 
+describe("fx agent registration", () => {
+	it("is a registered terminal agent with the right label", () => {
+		expect(AGENT_TYPES).toContain("fx");
+		expect(AGENT_LABELS.fx).toBe("fx");
+	});
+
+	it("runs prompt launches through fx ask and resumes them interactively", () => {
+		const command = buildAgentPromptCommand({
+			prompt: "hello",
+			randomId: "fx-1234",
+			agent: "fx",
+		});
+
+		expect(command).toStartWith(
+			"fx ask --auto \"$(cat <<'SUPERSET_PROMPT_fx1234'",
+		);
+		expect(command).toEndWith('\n)" ; fx resume last');
+	});
+
+	it("derives host preset prompt and resume args from the base command", () => {
+		const preset = getPresetById("fx");
+		expect(preset?.command).toBe("fx");
+		expect(preset?.args).toEqual([]);
+		expect(preset?.promptArgs).toEqual(["ask", "--auto"]);
+		expect(preset?.resumeArgs).toEqual(["resume"]);
+	});
+});
+
 describe("grok agent registration", () => {
 	it("is a registered terminal agent with the right label", () => {
 		expect(AGENT_TYPES).toContain("grok");

packages/shared/src/agent-command.test.ts

@@ -220,6 +220,17 @@ export const BUILTIN_TERMINAL_AGENTS = [
 		resumeCommand: "agy --mode accept-edits --conversation",
 		nonInteractiveCommand: "agy -p",
 	}),
+	createBuiltinTerminalAgent({
+		id: "fx",
+		label: "fx",
+		description:
+			"Vercel's coding agent for reading, editing, and running code from the terminal.",
+		command: "fx",
+		promptCommand: "fx ask --auto",
+		promptCommandSuffix: "; fx resume last",
+		resumeCommand: "fx resume",
+		nonInteractiveCommand: "fx ask --auto",
+	}),
 ] as const;
 
 export type BuiltinTerminalAgentType =