---
id: TASK-7
title: Run simulation by executing zephyr binary with args
status: Done
assignee: []
created_date: '2026-02-03 16:23'
updated_date: '2026-02-03 16:32'
labels: []
dependencies: []
references:
  - lua/zync/api/manager.lua
  - spec/api_spec/manager_spec.lua
  - README.md
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Rework `zync run` to execute the built Zephyr simulator binary directly (e.g., `zephyr.exe` located under the build dir's `zephyr/` folder for the selected image/profile) and pass any additional args. If the binary cannot be found, fall back to `ninja run` without passing additional args. Preserve existing sysbuild image selection behavior and ensure other phases are unaffected.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 All subtasks (TASK-7.1, TASK-7.2, TASK-7.3) are completed.
<!-- AC:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Subtasks complete: TASK-7.1 updated Manager.run binary execution and fallback; TASK-7.2 added tests (manager_spec pass); TASK-7.3 updated README docs.
<!-- SECTION:NOTES:END -->
