docs: tighten setup prompt + measure the copy button

Prompt (marketing + docs): note that MCP clients load servers at startup, so the user likely needs to restart their client or open a new chat before Executor tools appear, and recommend Executor Cloud as the fastest path. Marketing: complete the scaffolded PostHog wiring (gated on PUBLIC_POSTHOG_KEY, first-party proxied, autocapture and pageviews off) and capture a marketing_setup_prompt_copied event when the prompt is copied.

Rhys Sullivan committed 4 months ago

Commit 164792d1 parent 9ddf1ff3 files · +43 −6Browse files

Unified · Split

3 files

apps/docs/index.mdx +3 −3
apps/marketing/src/layouts/Layout.astro +26 −0
apps/marketing/src/pages/index.astro +14 −3

apps/docs/index.mdx+3−3

@@ -28,7 +28,7 @@ Help me set up Executor and get my first connection working. · 27 unmodified lines
28		28
29	Executor is an open source integration layer for AI agents: one place to configure every integration (MCP servers, OpenAPI specs, GraphQL APIs) and connect to them over MCP.	29	Executor is an open source integration layer for AI agents: one place to configure every integration (MCP servers, OpenAPI specs, GraphQL APIs) and connect to them over MCP.
30		30
31	Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. All forms expose the same functionality, just packaged differently:	31	Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. If I just want the fastest path, suggest Executor Cloud (free tier, nothing to install). All forms expose the same functionality, just packaged differently:
32		32
33	Local (everything stays on my machine):	33	Local (everything stays on my machine):
34	- Desktop app: a native app for Mac, Windows, and Linux. Best for a regular desktop environment.	34	- Desktop app: a native app for Mac, Windows, and Linux. Best for a regular desktop environment.
@@ -50,8 +50,8 @@ Terms you'll come across: · 15 unmodified lines
50		50
51	Once you know which form I want:	51	Once you know which form I want:
52	1. Walk me through installing it.	52	1. Walk me through installing it.
53	2. Connect Executor to you over MCP.	53	2. Connect Executor to you over MCP. Most MCP clients only load servers at startup, so after adding it I may need to restart the client or open a new chat before the Executor tools appear. Tell me if that's needed and wait for me to do it before continuing.
54	3. Help me add my first integration and get one tool working end to end.	54	3. Once the tools are available, help me add my first integration and get one tool working end to end.
55		55
56	Docs: https://executor.sh/docs	56	Docs: https://executor.sh/docs
57	Source (and the place to start if something breaks): https://github.com/RhysSullivan/executor	57	Source (and the place to start if something breaks): https://github.com/RhysSullivan/executor

apps/marketing/src/layouts/Layout.astro+26−0

@@ -45,5 +45,31 @@ const canonical = new URL(Astro.url.pathname, Astro.site ?? Astro.url).toString( · 44 unmodified lines
45	</head>	45	</head>
46	<body class="antialiased">	46	<body class="antialiased">
47	<slot />	47	<slot />
		48	<script>
		49	// Gated PostHog init. Runs only when PUBLIC_POSTHOG_KEY is set in the
		50	// deploy env, so it's a no-op in dev / unconfigured builds (and the SDK
		51	// isn't even shipped, thanks to the dynamic import). Events are proxied
		52	// first-party through src/middleware.ts to survive adblockers.
		53	// autocapture and pageviews are off on purpose: we only send the explicit
		54	// events the page fires (e.g. the "Set up with your agent" copy). Flip
		55	// capture_pageview on if you want a denominator for conversion.
		56	const phKey = import.meta.env.PUBLIC_POSTHOG_KEY;
		57	if (phKey) {
		58	const phPath = (import.meta.env.PUBLIC_ANALYTICS_PATH ?? "a").replace(
		59	/^\/+\|\/+$/g,
		60	"",
		61	);
		62	void import("posthog-js").then(({ default: posthog }) => {
		63	posthog.init(phKey, {
		64	api_host: `${window.location.origin}/api/${phPath}`,
		65	ui_host: import.meta.env.PUBLIC_POSTHOG_HOST ?? "https://us.posthog.com",
		66	autocapture: false,
		67	capture_pageview: false,
		68	persistence: "localStorage",
		69	});
		70	Object.assign(window, { posthog });
		71	});
		72	}
		73	</script>
48	</body>	74	</body>
49	</html>	75	</html>

apps/marketing/src/pages/index.astro+14−3

 Executor is an open source integration layer for AI agents: one place to configure every integration (MCP servers, OpenAPI specs, GraphQL APIs) and connect to them over MCP.
-Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. All forms expose the same functionality, just packaged differently:
+Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. If I just want the fastest path, suggest Executor Cloud (free tier, nothing to install). All forms expose the same functionality, just packaged differently:
 Local (everything stays on my machine):
 - Desktop app: a native app for Mac, Windows, and Linux. Best for a regular desktop environment.
 Once you know which form I want:
 1. Walk me through installing it.
-2. Connect Executor to you over MCP.
+2. Connect Executor to you over MCP. Most MCP clients only load servers at startup, so after adding it I may need to restart the client or open a new chat before the Executor tools appear. Tell me if that's needed and wait for me to do it before continuing.
-3. Help me add my first integration and get one tool working end to end.
+3. Once the tools are available, help me add my first integration and get one tool working end to end.
 Docs: https://executor.sh/docs
 Source (and the place to start if something breaks): https://github.com/RhysSullivan/executor`;
                 type="button"
                 class="btn-secondary copy-btn"
                 data-copy={setupPrompt}
+                data-event="marketing_setup_prompt_copied"
               >
                 Set up with your agent
                 <span class="copy-icons" aria-hidden="true">
         try {
           await navigator.clipboard.writeText(text);
           btn.dataset.copied = "true";
+          const event = btn.dataset.event;
+          if (event) {
+            (
+              window as unknown as {
+                posthog?: {
+                  capture: (e: string, p?: Record<string, unknown>) => void;
+                };
+              }
+            ).posthog?.capture(event, { surface: "marketing_hero" });
+          }
         } catch {
           btn.dataset.copied = "false";
         }