---
id: TASK-6
title: Support CLI additional args (`--`) for build phases
status: Done
assignee: []
created_date: '2026-02-03 14:29'
updated_date: '2026-02-03 16:13'
labels: []
dependencies: []
references:
  - lua/zync/api.lua
  - lua/zync/api/manager.lua
  - lua/zync/api/commands
  - spec
  - README.md
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Allow passing extra, unnamed CLI args via `--` (stored in `Api.args['']`) and concatenate them with configured args for the active phase. Order must be: global zconf args, profile zconf args, then CLI `--` args. Apply to conf/build/flash/run commands without changing behavior when none are provided.
<!-- SECTION:DESCRIPTION:END -->

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

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Subtasks complete: TASK-6.1 wired CLI `--` args into phase arg resolution; TASK-6.2 added tests (busted pass); TASK-6.3 updated README docs/examples.
<!-- SECTION:NOTES:END -->
