From 1dfd6dd6328670028878cf3a0010d71a643e678d Mon Sep 17 00:00:00 2001 From: abrichr Date: Wed, 26 Aug 2026 11:38:59 -0400 Subject: [PATCH] feat: promote the verified local quickstart --- components/InstallSection.js | 91 ++++++++++------------------ components/InstallSection.module.css | 5 +- components/MastHead.js | 4 ++ pages/download.js | 2 +- pages/start.js | 16 ++++- public/llms-full.txt | 6 +- public/llms.txt | 4 +- 7 files changed, 59 insertions(+), 69 deletions(-) diff --git a/components/InstallSection.js b/components/InstallSection.js index d4569484..e3155dd1 100644 --- a/components/InstallSection.js +++ b/components/InstallSection.js @@ -40,16 +40,13 @@ export default function InstallSection() { >
-

Install the OpenAdapt workflow CLI

+

Install OpenAdapt

- One command installs the OpenAdapt launcher and governed - workflow compiler. The same CLI records, compiles, and replays - across browser, Windows, macOS, Linux, RDP, and Citrix under one - governed loop; browser runs in production today, and the desktop - and remote surfaces run through customer-controlled - qualification. No account or hosted service is required. + One command installs the launcher, compiler, governed runtime, + and browser driver used by the local tutorial. No account, API + key, or hosted service is required.

@@ -93,71 +90,47 @@ export default function InstallSection() { {/* Quick Start: the full loop */}

- The end-to-end workflow loop + Get a verified result, then test the safety gate

- Try the whole loop right now against the bundled demo app, - which runs in the browser: record, compile, inspect, certify, - replay, and induce known test drift. No account or cloud - service. Once it is installed, your workflow data stays on - your machine. The base install includes browser support. On - first web use,{' '} - demo-record or{' '} - replay downloads a bundled Chromium (~150 MB) - once, so that step takes a few minutes, and on Linux you may - need playwright install-deps first. + The bundled tutorial records, compiles, certifies, and runs + a synthetic task. A separate read-only API verifies the + saved result before OpenAdapt reports VERIFIED. + The first browser action downloads matching Chromium once.

- pip install openadapt - Install OpenAdapt -
-
- openadapt flow demo-record --out rec - Record yourself doing the task -
-
- - openadapt flow compile rec --out bundle --name - my-task - - Turn the recording into a workflow -
-
- openadapt flow lint bundle - Inspect identity, assertion, and risk coverage gaps + openadapt quickstart + + Complete the local lifecycle and write the bundle, + report, and privacy-safe receipt. +
-
+
- openadapt flow certify bundle --policy clinical-write + openadapt quickstart --break-it --out + openadapt-quickstart-broken - The clinical gate refuses this demo bundle and - exits non-zero — on purpose. Safeguards refuse - instead of guessing. Re-run with{' '} - --policy permissive to see a clean - pass. + Make the demo screen claim success without saving. + The independent verifier detects the mismatch and + returns HALTED.
-
- openadapt flow replay bundle - Replay it locally, with zero AI calls -
-
- openadapt flow replay bundle --drift theme - Exercise deterministic re-resolution on bundled test drift -
-
- pip uninstall openadapt - Remove the launcher when you are finished -

- Every replay writes a step-by-step run report: what ran, - what it saw, what re-resolved, and what halted. - Compiler/runtime source and measured limits are in{' '} + Healthy tutorial runs make zero model or Cloud calls. The + report shows what ran, what OpenAdapt verified, and why it + halted. Record your own workflow in the{' '} + + five-minute walkthrough + + . Compiler source and measured limits are in{' '} pip install openadapt + + + openadapt quickstart + 

-                    pip install openadapt
+                    {`pip install openadapt\nopenadapt quickstart`}
diff --git a/pages/start.js b/pages/start.js index 97b18355..31cc5385 100644 --- a/pages/start.js +++ b/pages/start.js @@ -7,6 +7,8 @@ import { EVENTS, track } from 'utils/analytics' const INSTALL = 'python -m pip install --upgrade openadapt' const QUICKSTART = 'openadapt quickstart' +const BREAK_IT = + 'openadapt quickstart --break-it --out openadapt-quickstart-broken' function Command({ command, event }) { const [copyState, setCopyState] = useState('idle') @@ -111,11 +113,23 @@ export default function StartPage() { event={EVENTS.LOCAL_QUICKSTART_RUN_COPIED} />
+
+

+ 3 · Watch it catch a false success +

+ +

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 it. + once. The fault test makes the screen claim + success without saving. The independent verifier + detects the mismatch and returns HALTED. Native, + RDP, and Citrix runs do not use Chromium.