skill by
@amelnagdyDelegate a coding task to the Qoder CLI (`qodercli`) as a background implementer, then review its diff and land it yourself. Use this whenever the user asks to have Qoder implement, fix, refactor, or run a queue of coding tasks while the orchestrator remains the reviewer. DO NOT USE for tasks small enough to do inline, or when the user wants code written directly without delegation.
Permissions
Files
Delegate a coding task to the Qoder CLI (`qodercli`) as a background implementer, then review its diff and land it yourself. Use this whenever the user asks to have Qoder implement, fix, refactor, or run a queue of coding tasks while the orchestrator remains the reviewer. DO NOT USE for tasks small enough to do inline, or when the user wants code written directly without delegation.
You are the orchestrator. Delegate one bounded coding task to a separate - Qoder CLI - then review what it produced and land it yourself. You write the brief and own the judgment; Qoder edits the working tree in its session; you verify and commit.
Install
It’s free, and every skill you add syncs into every AI tool on your computer, instantly.
Version history
The loop needs only shell and file access, so any comparable orchestrator can drive it.
qodercli is not installed or authenticated.command -v qodercli
qodercli --version
qodercli --list-models
If the binary is missing, install it from Qoder's
official Quick Start. Authenticate with qodercli login,
or set QODER_PERSONAL_ACCESS_TOKEN for automation. A successful --list-models confirms the current
account can return its live model catalog.
Qoder's available models can change. If the human requests a model, use its exact current value from
qodercli --list-models; never invent or pin a catalog entry. Otherwise omit --model and let Qoder
use its current default.
--context-window <n> is optional. Pass a positive integer only when the human requests a size or the
task needs an explicit budget. Qoder applies it only to supported models; surface an unsupported
model/size error instead of silently choosing another value.
Run these five steps per task. Steps 1, 4, and 5 require judgment; 2 and 3 are mechanical.
Qoder sees the brief plus what it can inspect in the workspace, not this chat. Include the goal, current state, what to change, what to leave untouched, the project's actual gates, and a closing report contract. Tell Qoder not to commit. Keep one task per brief. See references/writing-the-brief.md.
Use the bundled relay. It wraps Qoder's non-interactive stream-json mode and writes result.json.
<skill-dir> is the installed folder containing this SKILL.md.
node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a live model: add --model "<value from qodercli --list-models>"
# request a supported context window: add --context-window 32768
# resume the latest session: add --resume-last # delta brief only
# resume a specific session: add --resume <id> # delta brief only
# see every option: node .../relay.mjs --help
Implementation runs default to Qoder's auto permission mode. The relay never bypasses permissions
unless the caller explicitly requests it, and it never commits. See
references/dispatch-and-poll.md.
The relay blocks until Qoder exits. Run it with the orchestrator's background-command facility, or
background it in the shell and wait for result.json. Completion means the process exited and the
file contains a status; do not trust a progress display.
A pre-run usage error exits 2 and writes no result. Missing qodercli exits 127 and writes
status: "qoder_unavailable" with installation guidance.
Native Windows relay launch is not yet verified; do not claim it until a native Windows smoke passes.
Treat Qoder's final message and gate outcomes as claims:
touchedFiles.--add-dir workspaces separately; their changes are not in the primary tree report.See references/review-and-land.md.
The implementer edits; the orchestrator commits. Commit only after the gates pass and the diff
holds. If rework is needed, send a delta brief with --resume-last or --resume <id>, then review
again.
Qoder print mode cannot show approval prompts. The relay defaults to auto, which makes
non-interactive allow/deny decisions. default can deny actions that would require a prompt;
accept_edits permits workspace edits but may deny shell actions; dont_ask fails closed; plan
maps to default plus Qoder's Plan work state; and bypass_permissions is for explicitly trusted
runs only.
Qoder falls back to default when a non-default mode is requested outside a trusted directory. Check
actualPermissionMode in result.json; no requested mode replaces diff review.
Delegation is something the human opts into. Once they ask for it, landing verified, gate-passing work is the contract. Two limits remain: surface, do not absorb (report Qoder's design decisions and non-blocking deviations) and stop for scope changes (ask before expanding beyond the brief). See references/review-and-land.md.
In these kits
More from @amelnagdy
Works with
Claude, Codex, Cursor & more