InitDebuggee
Start a new debuggee in x64dbg/x32dbg by detecting architecture, launching the matching debugger, verifying bridge state, and opening the executable with retries.
Instructions
Preferred first call when the target executable path is known.
Reliably start a new debuggee with retries and state verification. This tool detects the target architecture, resolves X64DBG_ROOT, starts the matching x32dbg/x64dbg instance, waits for its authenticated bridge, and opens the target. Do not preflight BridgeHello, probe port 8888, or search debugger installation paths manually before calling InitDebuggee.
Args: exe_path: Absolute path to the executable. timeout_ms: Maximum total time to spend retrying. retries: Maximum number of init attempts. stop_first: When true, stop the current debug session before init. use_scyllahide: off (default), auto (same as off), or force (explicit injection). scyllahide_profile: Optional explicit ScyllaHide profile override. arguments: Argument vector excluding argv[0]. Mutually exclusive with command_line. command_line: Explicit Windows command-line tail. working_directory: Current directory for the new process. environment: Per-launch environment overrides. The current bridge reports this unsupported and the call fails explicitly instead of ignoring it. inherit_environment: Whether the target should inherit the debugger environment. stdin: Typed stdin object (inherit/null/file/bytes/pipe). stdout: Typed stdout object (inherit/null/file/pipe). stderr: Typed stderr object (inherit/null/file/pipe). All streams must be explicit together, or all omitted for console inheritance. child_policy: none, attach-first, attach-all, or break-on-create. capture_limit_bytes: Bounded pipe retention/queue capacity in bytes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stdin | No | ||
| stderr | No | ||
| stdout | No | ||
| retries | No | ||
| exe_path | Yes | ||
| arguments | No | ||
| stop_first | No | ||
| timeout_ms | No | ||
| environment | No | ||
| child_policy | No | none | |
| command_line | No | ||
| use_scyllahide | No | off | |
| working_directory | No | ||
| scyllahide_profile | No | ||
| capture_limit_bytes | No | ||
| inherit_environment | No |