CLI Reference
Complete command reference for rte CLI.
Global Options
| Flag | Description |
|---|
-V, --version | Output version number |
-d, --debug | Enable debug mode with stack traces |
-h, --help | Display help |
rte dev
Run a React file through the engine with debug panel.
rte dev <file> [options]
Arguments
file — Path to React component file (required)
Options
| Option | Description |
|---|
-p, --port <port> | API server port (default: 3000) |
-s, --save-session | Save session to .rte/sessions/ |
rte dev examples/counter.tsx
rte dev src/App.tsx --port 8080 --save-session
rte replay
Replay a recorded session with frame stepping.
rte replay <sessionFile> [options]
Options
| Option | Description |
|---|
-i, --interactive | Interactive mode with keyboard controls |
rte diff
Compare two session files and find divergence.
rte diff <sessionA> <sessionB> [options]
Options
| Option | Description |
|---|
-v, --visual | Show visual side-by-side comparison |
-j, --json | Output structured debug summary as JSON |
-s, --summary-only | Print only explanation (no raw diff) |
rte verify
Verify current app state against snapshot (CI mode).
rte verify <snapshot.json> [options]
Options
| Option | Description |
|---|
-g, --generate | Generate and compare hash |
-e, --entry <file> | Entry file to run |
rte benchmark
Run performance benchmark.
rte benchmark [options]
Options
| Option | Description |
|---|
-s, --scenario <name> | Scenario: small, medium, large, stress, stress-large-tree (default: small) |
Error Format
❌ Error: <message>
[suggestion]
| Error | Fix |
|---|
| Missing required argument | Provide required argument |
| Session file not found | Check file path is correct |
| Invalid session file | Ensure valid JSON |
| Unknown option | Use correct flags |
Exit Codes
0 — Success1 — User error (invalid input, missing files)