- Home
- Skills
- Agents & Orchestration
- ZCode Executor
Works with the AI Agents you already use
ZCode Executor
Free install-and-dispatch skill for open-source zcode-executor: write a task file, run implementation in a git worktree, verify with git diff and tests.
Free
ZCode Executor
Example session with this skill installed
Dispatch this: implement tasks/T-101.md with zcode-executor in an isolated git worktree, then show me the git diff and test results before I accept it.
- Read your context and instructions
- Compiled the zcode executor
Summary
Dispatched T-101 to a local zcode-executor session in an isolated git worktree and verified the result with git diff and tests.
| Step | Command | Result |
|---|---|---|
| Doctor | zcode-executor doctor | CLI present, ZCode desktop logged in |
| Worktree | git worktree add ~/.zcode-executor/worktrees/repo -b task/T-101 | Isolated branch created |
| Session | zcode-executor new --cwd <worktree> --title T-101 --tier fast --json | Local id x_… |
| Send | zcode-executor send <id> "Run tasks/T-101.md" --task <abs path> | Returned immediately |
| Verify | git diff --cached and the task's test command | Diff matches the task; tests passed |
zcode-executor send x_abc "Run tasks/T-101.md" --task "$WT/tasks/T-101.md"
git -C "$WT" add -A && git -C "$WT" diff --cached --stat
Next steps
- Pass: commit in the worktree and merge into the main repo.
- Fail: reset staged files, write tasks/T-101-fix.md, and send to the same session.
- Need orchestration templates or multi-session review loops: use zcode-executor-pro on Agensi. The engine stays free at https://github.com/KyoMio/zcode-executor
Connects securely to your tools. The creator never sees your data.
About this skill
Free install-and-dispatch skill for open-source zcode-executor: write a task file, run implementation in a git worktree, verify with git diff and tests. Works with any host coding agent. Links to GitHub/npm; upsells Pro for orchestration templates.
Coding Plan: A ZCode Coding Plan gives about 150% equivalent quota (roughly 0.67× consumption, per official docs). Calling the executor through this skill gets that same Coding Plan benefit.
Open source: zcode-executor on GitHub · npm package zcode-executor (Apache-2.0). Skill id: zcode-executor.
You are the planning hub. The local executor implements. Write a task file, dispatch into an isolated git worktree, and accept only with git diff and tests — never by trusting the executor's self-report.
Install
Works with any host agent that can run shell commands (Claude Code, Cursor, Codex, and similar).
npm install -g zcode-executor
zcode-executor doctor
Or without a global install: npx zcode-executor doctor.
Requirements: macOS or Linux; Node ≥ 22; ZCode desktop app ≥ 3.12.2, installed and logged in. Windows is not supported yet.
One task, end to end
- Write a task file from the upstream template (
templates/task.md). Acceptance criteria must be machine-checkable. One independently verifiable change per task file. - Create an isolated git worktree (one per repo; branch per task).
- Register a local session:
zcode-executor new --cwd <worktree> --title T-xxx --tier fast --json. - Send the task (the message is only a doorbell; the task file is the contract):
zcode-executor send <id> "Run tasks/T-xxx.md" --task <absolute-path>. - Verify with
git diffand tests before accepting. On failure, revise and send to the same session.
Iron rules
- Always
sendwith--task. Editing the file later does not change authorization until you send again. - Accept with
git diffand tests, not the executor's narrative. - Never put credentials in the task file.
Pro
This free skill covers the open-source install-and-dispatch workflow only. For multi-session orchestration, ready task templates, and updates when the executor or agent ecosystem changes, see zcode-executor-pro on Agensi. The core engine stays free and open on GitHub.
Requires macOS or Linux and Node 22+. Does not support Windows. The ZCode desktop app (v3.12.2+) must be installed and active.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
2 uses
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 1 month ago
- Free with an Agensi account
Requires
Permissions
Runs zcode-executor and git in a local worktree. Reads and writes the task file and the repo files that task lists. Do not put credentials in the task file.