forked from openai/codex
-
Notifications
You must be signed in to change notification settings - Fork 0
[Flow] Document first‑run onboarding and trust flow — TUI #42
Copy link
Copy link
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationflowUser flow and navigationUser flow and navigationusabilityUser experience and ergonomicsUser experience and ergonomics
Description
Summary
New users experience a trust/onboarding sequence (approvals/sandbox, workspace trust). Provide a step‑by‑step doc with screenshots and expected states to reduce confusion and support troubleshooting.
Current vs Expected
- Current: Onboarding code exists (tui/src/onboarding/*) and some behaviors are noted in docs, but no end‑to‑end walkthrough.
- Expected: A concise “First Run” guide with visuals showing prompts, options, and where settings surface in UI.
Proposed Changes
- Add a “First Run” doc under docs/ with screenshots of each step.
- Clarify where sandbox/approval policies are displayed (History panel summary) and how to change them.
- Link from Getting Started and README.
Acceptance Criteria
- New doc with at least: trust directory step, approvals/sandbox presets picker, status indicators.
- README and docs/getting-started.md link added.
- Troubleshooting section for common blockers (permissions, terminal quirks).
References
- codex-rs/tui/src/onboarding/*, codex-rs/tui/src/history_cell.rs
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationflowUser flow and navigationUser flow and navigationusabilityUser experience and ergonomicsUser experience and ergonomics