[codex] Document Codex cua-driver onboarding

[f-trycua]

Summary

• update Codex MCP setup docs to use cua-driver mcp-config --client codex
• mention that Codex needs a fresh session after MCP registration
• document the optional Codex skill-pack directory fallback
• point macOS permission verification at cua-driver permissions status

Why

These notes cover friction hit during a real first-run setup: PATH-sensitive MCP registration, session reload expectations, and the missing ~/.agents/skills directory for the optional skill pack.

Validation

• reviewed docs diff for secrets and local machine details
• pnpm exec prettier --check docs/content/docs/how-to-guides/driver/connect-your-agent.mdx docs/content/docs/tutorials/drive-your-first-app.mdx
• docs-only change; no runtime tests run

Summary by CodeRabbit

• Documentation
  • Updated the agent connection guides with the latest macOS permission check command.
  • Improved Codex setup steps to generate the correct registration command automatically, including support for an installed binary path.
  • Added clearer guidance for restarting Codex after registration so new tools appear.
  • Expanded setup instructions to verify the Cua Driver skill and handle missing Codex skill directories.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 5, 2026 4:27pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 6c6598d7-b653-4b48-a4d0-dda09f643b59

📥 Commits

Reviewing files that changed from the base of the PR and between 73fe822 and 98acf8c.

📒 Files selected for processing (2)

• docs/content/docs/how-to-guides/driver/connect-your-agent.mdx
• docs/content/docs/tutorials/drive-your-first-app.mdx

---

📝 Walkthrough

Walkthrough

This PR updates two documentation files. It changes the macOS permissions verification command, replaces the hardcoded Codex MCP registration command with a generated command using an absolute binary path, and adds Codex restart and Cua Driver skills installation steps.

Changes

Cua Driver documentation updates

Layer / File(s)	Summary
Permissions command update docs/content/docs/how-to-guides/driver/connect-your-agent.mdx	Changes macOS permissions verification command from cua-driver call check_permissions to cua-driver permissions status.
Codex MCP registration flow docs/content/docs/how-to-guides/driver/connect-your-agent.mdx, docs/content/docs/tutorials/drive-your-first-app.mdx	Replaces hardcoded Codex registration command with a generated flow via cua-driver mcp-config --client codex, using an absolute installed binary path in both docs.
Codex post-setup and skills installation docs/content/docs/how-to-guides/driver/connect-your-agent.mdx	Adds restart/fresh-session instructions and new steps to install/verify Cua Driver skills, with a fallback to create the skills directory if missing.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• trycua/cua#1681: Both PRs update MCP client registration docs to use cua-driver mcp-config --client <client> and copy the printed registration command.
• trycua/cua#2089: Both PRs update the same macOS documentation to verify permissions via cua-driver permissions status instead of cua-driver call check_permissions.
• trycua/cua#1766: Both PRs steer macOS documentation toward the cua-driver permissions status workflow for permission verification.

Poem

A rabbit hops through docs with glee,
New commands set our permissions free,
Codex restarts, skills install with care,
Absolute paths now everywhere,
Hop, hop, hooray for docs done right! 🐇📖

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/codex-cua-driver-onboarding-docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.