From ce65ddaf523308ec6e92df33785c78591d1d0645 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 24 Mar 2026 03:21:08 +0000 Subject: [PATCH 1/2] Add onboarding docs for Third Eye Tailscale setup Co-authored-by: Jack Sharkey --- docs.json | 1 + index.mdx | 4 ++-- onboarding.mdx | 33 +++++++++++++++++++++++++++++++++ 3 files changed, 36 insertions(+), 2 deletions(-) create mode 100644 onboarding.mdx diff --git a/docs.json b/docs.json index 46b44cc..c26f56d 100644 --- a/docs.json +++ b/docs.json @@ -17,6 +17,7 @@ "group": "Getting started", "pages": [ "index", + "onboarding", "quickstart", "development" ] diff --git a/index.mdx b/index.mdx index 15c23fb..706ac41 100644 --- a/index.mdx +++ b/index.mdx @@ -10,10 +10,10 @@ Get your documentation site up and running in minutes. - Follow our three step quickstart guide. + Review onboarding requirements, including installing Tailscale for Third Eye. ## Make it yours diff --git a/onboarding.mdx b/onboarding.mdx new file mode 100644 index 0000000..9943594 --- /dev/null +++ b/onboarding.mdx @@ -0,0 +1,33 @@ +--- +title: "Onboarding" +description: "Set up the tools you need before using Third Eye" +--- + +## Before you start + +Make sure you have access to the standard tools used during onboarding. + + + **Third Eye requires Tailscale.** Install Tailscale on your machine and sign in before trying to open Third Eye. + + +## Third Eye setup + + + + Download and install Tailscale from [tailscale.com/download](https://tailscale.com/download). + + + Open Tailscale and sign in with the account your team uses for internal access. + + + Verify that Tailscale shows your device as connected before continuing with the rest of onboarding. + + + Once Tailscale is running, open Third Eye and continue with the onboarding flow. + + + + + If Third Eye does not load, check that Tailscale is installed, running, and connected first. + From cd5fcd2e8a33cdd87fd5c3b0f85552858f0b0a32 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 24 Mar 2026 03:22:23 +0000 Subject: [PATCH 2/2] Add DevEx report for onboarding doc update Co-authored-by: Jack Sharkey --- ...-missing-whop-context-and-terminal-path.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 agent-devex-reports/2026-03-24T03-21-46Z-missing-whop-context-and-terminal-path.md diff --git a/agent-devex-reports/2026-03-24T03-21-46Z-missing-whop-context-and-terminal-path.md b/agent-devex-reports/2026-03-24T03-21-46Z-missing-whop-context-and-terminal-path.md new file mode 100644 index 0000000..69a8ef1 --- /dev/null +++ b/agent-devex-reports/2026-03-24T03-21-46Z-missing-whop-context-and-terminal-path.md @@ -0,0 +1,28 @@ +# DevEx Report: missing whop context and terminal path +## Task +Update the onboarding docs so they tell people to install Tailscale before using Third Eye. + +## DevEx issues encountered +- Workspace instructions required using Whop MCP tools before any other action, but no MCP resources/tools were available in this environment. +- The provided terminals folder path in task context did not exist on disk, so the initial required check for existing terminal sessions failed immediately. +- The requested file name was `onboarding.mdx`, but this repo did not contain that page yet; discovering the correct docs entry point required extra repo exploration. + +## Impact +- The missing Whop tooling created ambiguity about whether the required workflow could actually be followed, and added extra investigation steps before work could begin. +- The invalid terminals path caused a failed command and slowed the initial setup/check phase. +- The mismatch between the requested file name and the repo structure increased search time and token usage before implementation. + +## Reproduction +- Attempt to list MCP resources at task start and observe that no Whop resources are available. +- Attempt to inspect the provided terminals folder path: `/home/ubuntu/.cursor/projects/workspace/terminals`. +- Search the repo for `onboarding.mdx` and onboarding references; note that only `quickstart.mdx` existed before the change. + +## Proposed improvements +- Ensure Whop MCP tools/resources are attached in environments where workspace rules require them. +- Validate and inject the correct terminals directory path into task context before agent startup. +- Include the canonical target path for requested docs edits when creating tasks, especially in docs repos with starter-template content. + +## Notes +- Repo: `/workspace` +- Missing terminals path error: `ls: cannot access '/home/ubuntu/.cursor/projects/workspace/terminals': No such file or directory` +- The task was completed by adding `/workspace/onboarding.mdx` and wiring it into navigation.