Skip to content

docs: use the canonical launcher quickstart - #28

Merged
abrichr merged 2 commits into
mainfrom
codex/canonical-quickstart-docs
Aug 18, 2026
Merged

docs: use the canonical launcher quickstart#28
abrichr merged 2 commits into
mainfrom
codex/canonical-quickstart-docs

Conversation

@abrichr

@abrichr abrichr commented Aug 18, 2026

Copy link
Copy Markdown
Member

Summary

  • replace the hand-driven openadapt-flow demo-record setup with openadapt quickstart
  • install the launcher browser extra explicitly
  • point the Agent bridge and skill emitter at the tutorial bundle that the launcher creates
  • keep the retained quickstart bundle read-only after its synthetic application and runtime-only verifier stop
  • keep --allow-run on the qualified, deployment-configured path

Why

The prior example bypassed the canonical launcher and omitted the browser dependency. The first draft then exposed --allow-run for the retained quickstart bundle. That bundle is plaintext, and the quickstart process does not export its temporary MockMed server, verifier, or run authorization. It is valid for Agent discovery and skill emission, but it is not a second runnable tutorial.

Impact

A new user now follows the verified local first-run path and can inspect the resulting bundle through the Agent bridge without receiving a run tool that cannot execute that tutorial contract. A qualified deployment configuration remains the documented path that enables governed execution and attended actions.

Checks

  • PYTHONPATH="$PWD/src:$PWD" uv run --locked --extra dev pytest -q — 97 passed
  • ruff check src tests scripts
  • wheel and source archive build
  • release archive and distribution checks for both built files
  • git diff --check

@abrichr
abrichr marked this pull request as ready for review August 18, 2026 17:59
@abrichr
abrichr merged commit 3805d8e into main Aug 18, 2026
7 checks passed
@abrichr
abrichr deleted the codex/canonical-quickstart-docs branch August 18, 2026 17:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant