setup

Usage

Claude: /rn-dev-agent:setup
Codex:  $rn-dev-agent:setup

Host-specific instructions

Both hosts diagnose first, then preview every proposed project change and ask for confirmation.

• Claude manages the rn-dev-agent block in CLAUDE.md.
• Codex manages a start/end-sentinel-bounded block in AGENTS.md; it never creates, edits, or symlinks Claude instruction files.

Codex passive diagnosis uses the package-local health program and performs no plugin/config/project/process/device/Observe mutation. Recovery commands are recommendations. Optional app attachment/verification happens only after the passive phase.

Project wiring

Step	Behavior
Worktree actions	Keep .rn-agent/ real and local; preview and request consent before inheriting only .rn-agent/actions or installing repository-local post-checkout integration
Instructions	Create/append/refresh only the host’s managed block; preserve all user content outside it
Navigation	Prefer fiber discovery; preview minimal dev-bridge registration only on a proven miss
Zustand	Preview one registerStores bridge call when stores exist and are not already exposed
Scaffold	Add .rn-agent safely; never overwrite user files, write through a root symlink, or replace the supported actions link
TypeScript	Preview missing dev-bridge/global include entries
Active verification	Optionally call cdp_status after setup; unavailable Metro/device is deferred, not a diagnosis mutation

SessionStart only reports missing or unsafe inheritance. Doctor inspects the same state read-only; setup owns every link, legacy migration, and hook change.

Re-running setup is idempotent. Malformed/duplicate instruction sentinels fail closed rather than risking user content.

See also

• doctor — strictly read-only recovery diagnosis
• Getting Started
• Actions