Skip to content

docs: add missing command reference entries#201

Merged
thymikee merged 2 commits intomainfrom
codex/docs-missing-commands-fix
Mar 10, 2026
Merged

docs: add missing command reference entries#201
thymikee merged 2 commits intomainfrom
codex/docs-missing-commands-fix

Conversation

@thymikee
Copy link
Contributor

Summary

Expand the commands reference page to explicitly document missing CLI entries, including wait/alert, assertions, tracing, runtime hints, device discovery, and session inspection.
Fix the assertions section to use selector-only is examples and explicitly note that snapshot refs are not supported.
Touched files: 1 (website/docs/docs/commands.md). Scope stayed within docs only.

Validation

Docs-only change; tests not run.

@thymikee thymikee force-pushed the codex/docs-missing-commands-fix branch from 99f74a6 to 283a0fa Compare March 10, 2026 11:38
@github-actions
Copy link

github-actions bot commented Mar 10, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://callstackincubator.github.io/agent-device/pr-preview/pr-201/

Built to branch gh-pages at 2026-03-10 11:58 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@chatgpt-codex-connector
Copy link

💡 Codex Review

- `wait <selector> [timeoutMs]` and `wait @ref [timeoutMs]` poll until the target appears or the timeout expires.

P2 Badge Document wait @ref snapshot prerequisite and lookup semantics

The new docs say wait @ref [timeoutMs] polls until that target appears, but the implementation first requires an existing session snapshot (Ref wait requires an existing snapshot in session.) and then resolves the ref to a label/text before polling text matches, not the original node identity (src/daemon/handlers/snapshot.ts around lines 260-317). This wording can cause users to run wait @ref without a prior snapshot or to assume identity-based waiting, leading to confusing failures or false-positive waits when labels are duplicated.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@thymikee thymikee merged commit f23df4d into main Mar 10, 2026
7 checks passed
@thymikee thymikee deleted the codex/docs-missing-commands-fix branch March 10, 2026 11: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