From e892298b0e8758bccb7fc288e5d22d0a2d5c6e3e Mon Sep 17 00:00:00 2001 From: abrichr Date: Wed, 26 Aug 2026 18:14:28 -0400 Subject: [PATCH] Lead first-workflow onboarding with Desktop --- cypress/e2e/public-surface-coherence.cy.js | 8 +- pages/start.js | 267 +++++++++++---------- public/llms-full.txt | 29 ++- public/llms.txt | 4 +- tests/publicTruth.test.js | 17 ++ 5 files changed, 183 insertions(+), 142 deletions(-) diff --git a/cypress/e2e/public-surface-coherence.cy.js b/cypress/e2e/public-surface-coherence.cy.js index 4e74011d..815d0a3c 100644 --- a/cypress/e2e/public-surface-coherence.cy.js +++ b/cypress/e2e/public-surface-coherence.cy.js @@ -1,15 +1,21 @@ describe('public surface coherence', () => { - it('offers CLI and Desktop as equal local entry paths before Cloud', () => { + it('recommends Desktop first and preserves the CLI developer path', () => { cy.visit('/start') cy.get('[role="list"][aria-label="Local ways to run OpenAdapt"]') .find('[role="listitem"]') .should('have.length', 2) + .first() + .should('have.attr', 'data-testid', 'desktop-first-workflow') cy.get('[data-testid="local-desktop-download"]').should( 'have.attr', 'href', '/download#desktop-builds' ) + cy.get('[data-testid="cli-installation-check"]') + .should('be.visible') + .find('button[aria-label="Copy openadapt quickstart"]') + .should('be.visible') cy.get('[data-testid="local-cli-walkthrough"]').should( 'have.attr', 'href', diff --git a/pages/start.js b/pages/start.js index 0fbbd5b0..c047a4a7 100644 --- a/pages/start.js +++ b/pages/start.js @@ -48,19 +48,19 @@ export default function StartPage() { return (
- Run OpenAdapt Locally for Free | OpenAdapt + Record Your First Workflow | OpenAdapt @@ -69,13 +69,13 @@ export default function StartPage() {

Free local start · MIT licensed

- Start locally with Desktop or the CLI. + Record your first workflow in OpenAdapt Desktop.

- Both paths use the same local compiler and governed - runtime. Choose the visual Desktop cockpit or the - scriptable command line. Neither requires a Cloud account - or model API. + Desktop gives you a visual path from permissions to a + supervised run. The CLI provides the same local compiler + and governed runtime for developers and CI. You don't + need a Cloud account or model API for either.

-

Command line

-

- OpenAdapt CLI -

-

- Run the complete local tutorial, inspect every - artifact, and script the same lifecycle in a - terminal or CI environment. -

- -
-

1 · Install

- -
-
-

2 · Run the whole loop

- -
-
-

3 · Inspect the report

-

- Confirm the VERIFIED outcome and - review the retained actions and effect - evidence. The report also includes the - privacy-safe receipt. -

-
-

- Requires Python 3.10–3.12. The base install - includes the browser support for this tutorial. - Its first web action downloads matching Chromium - once. Native, RDP, and Citrix runs do not use - Chromium. -

- -
- -
-

Native app

+

Recommended first workflow

OpenAdapt Desktop

- Record, compile, inspect, qualify, run, and review - evidence from the visual cockpit. It packages the - same governed workflow engine behind a native app. + Start with one small read-only task in a real app. + Use test data if the app provides it. Desktop keeps + the recording, compiled workflow, run status, and + evidence in one place.

  1. - 1 · Choose your installer + 1 · Grant local permissions + +
    + Allow the screen capture and input access that + Desktop needs for the app you choose. +
    2. +
  2. + + 2 · Choose a read-only task + +
    + Pick one repeatable task that does not change + application or external state. +
    3. +
  3. + + 3 · Record the demonstration
    - Available for Windows, macOS, and Linux. + Perform the task once while Desktop records + the actions and target evidence.
  4. - 2 · Follow first-run setup + 4 · Review the compiled workflow
    - Grant the local permissions needed to capture - your demonstration. + Check the steps, inputs, targets, risks, and + expected result before any replay.
  5. - 3 · Run the visual workflow + 5 · Run it under supervision
    - Review the compiled graph, policy, result, and - retained evidence in one place. + Watch the first replay and inspect its result + and retained evidence. +
    6. +
  6. + + 6 · Qualify unattended use + +
    + A state-changing, unknown, consequential, or + irreversible action must pass qualification + before its first actuation.
@@ -205,12 +171,74 @@ export default function StartPage() {

- Desktop opens without a browser download. - Chromium is added only if you choose a browser - workflow; native, RDP, and Citrix work stays on - its own substrate path. + Desktop is available for Windows, macOS, and + Linux. A browser workflow downloads matching + Chromium once. Native, RDP, and Citrix workflows + use their own substrate paths.

+ +
+

Developer and CI path

+

+ OpenAdapt CLI +

+

+ Use the command line for a repeatable installation + check, exact artifact inspection, or automation in + a terminal and CI environment. +

+
+

1 · Install

+ +
+
+

+ 2 · Check the installation +

+ +
+
+

3 · Inspect the report

+

+ Confirm the VERIFIED outcome and + review the retained actions, result evidence, + and privacy-safe receipt. +

+
+

+ The quickstart runs a successful synthetic task. + It checks the installation before you record real + work. It requires Python 3.10–3.12, and the first + browser action downloads matching Chromium once. +

+ +