[meghna810]

What

Applies the three optional notes @jrusso1020 left on #5442 to the CLI reference (docs/packages/cli.mdx). #5442 auto-merged before I got to them.

Why

Each note corrects something the page states:

1. open: the desktop hand-off is macOS-only for now (HANDOFF_READY = process.platform === "darwin" in packages/cli/src/utils/desktopApp.ts), so on Windows and Linux open always exits 1 with the download link. The page didn't say so.
2. timeline apply --plan: in text mode it prints only a count (planned 1 file, a2Commands.ts); the result and diff come with --json. The flag table said every --plan prints the result and the diff, which is true of the single verbs only.
3. history undo --who: it undoes what is still in effect from that name's last turn, and refuses (rather than falling back to an older turn) when nothing from that turn is still in effect (turnTargets in history.ts). The table said "that name's newest turn still in effect", which reads like the fallback.

Related work

Follow-up to #5442 (review comments) · Refs #5386

How

Three wording changes in docs/packages/cli.mdx: one sentence after the open --json paragraph, and one cell each in the timeline flag table and the history command table. No other files.

Test plan

• Checked each statement against current main and ran them with the CLI built from main on a fresh hyperframes init project:
  • timeline apply plan.json --plan prints planned 1 file; --plan --json returns before, after and diff, and nothing is written.
  • history undo --who claude with no entries from that name refuses with claude has no entry still in effect.
  • open --json without the app installed exits 1 with reason: "not-installed" and the downloadUrl (macOS). The Windows/Linux behaviour is from the HANDOFF_READY check; I don't have those machines to run it on.
• node scripts/check-docs-cli-commands.mjs, bun run check:docs-snippet-motion and check:studio-copy-dashes pass.
• npx mint broken-links --check-redirects passes (in docs/, Node 22). mint validate hung locally at "validating build…" without reporting an error, so I'm relying on the docs workflow for it.
• Documentation updated

🤖 Generated with Claude Code

[mintlify]

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 6bd3854.

Approve preview

[jrusso1020]

Checked all three wording changes against main, and each one matches the code:

1. open: HANDOFF_READY = process.platform === "darwin" (packages/cli/src/utils/desktopApp.ts:29) is the default ready for both hand-off paths, so off macOS it always falls through to the exit-1 download link.
2. timeline apply --plan: the text-mode summary is just planned N file(s) (a2Commands.ts:264). The result and diff come with --json.
3. history undo --who: turnTargets (history.ts:247-262) takes the last turn's entries that are still in effect and throws "…last turn has no change still in effect; undo an older entry by its id" rather than falling back. The new "(its newest entry if it never used begin)" matches the doc comment at :244-245.

Docs-only, one file, no other changes. LGTM.

— Rames