Placeholders
Placeholder Namespaces
The three namespaces are fully isolated:
${byk_dir} / ${file_dir} / ${deps_dir} and any $var-declared variables are substituted with literals by byk before placeholder resolution. They are not part of the argument namespaces above — they consume no argument positions and accept no input values. ${args} / ${N} / ${...args} are still handled by the argument layer. See Variables.
Placeholder Reference
Consumption Rules
{xxx}/{{xxx}}consumexxxand the value directly following it (2 positions in total){xxx?}/{xxx?render1}/{xxx?render1:render2}consume onlyxxxitself (1 position)${N}consumes position N- A placeholder that appears multiple times is consumed only once; its value is reused
- The remainder for
${...args}= all raw arguments − already-consumed positions, joined in original order
Missing Values / No Placeholders
When an alias contains no placeholders, all raw arguments are appended automatically — equivalent to an implicit ${args} at the end. Bare {} in commands like find (e.g. find . -exec ... {} +) stays compatible: it is never parsed or substituted.
When a placeholder finds no corresponding value, it silently disappears — no error is raised. Errors caused by missing arguments are handled at runtime by the underlying command.
Argument Fidelity
The command is ultimately interpreted by sh -c, so every argument is single-quoted when it is spliced in — the quotes hold the boundary instead of letting the shell re-split it:
Only plain values (letters, digits and - _ . / : = @ + ,) go in bare, so the hint line still reads cp src dst; you see quotes only when they are needed: cp 'my file.json' dst.
*, ~ and $VAR were already handled by your own shell before byk saw them — the * in byk probe *.json has been expanded to a file list by then. Passing them through literally is fidelity, not loss.
The cmd side uses double quotes. The one known gap is %VAR%: cmd expands environment variables even inside quotes, and there is no reliable escape at the command line (%% only works inside batch files).