Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    ZCode Executor

    1

    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

    2 usesSecurity scanned
    ZCode Executor

    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.

    StepCommandResult
    Doctorzcode-executor doctorCLI present, ZCode desktop logged in
    Worktreegit worktree add ~/.zcode-executor/worktrees/repo -b task/T-101Isolated branch created
    Sessionzcode-executor new --cwd <worktree> --title T-101 --tier fast --jsonLocal id x_…
    Sendzcode-executor send <id> "Run tasks/T-101.md" --task <abs path>Returned immediately
    Verifygit diff --cached and the task's test commandDiff 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

    1. Write a task file from the upstream template (templates/task.md). Acceptance criteria must be machine-checkable. One independently verifiable change per task file.
    2. Create an isolated git worktree (one per repo; branch per task).
    3. Register a local session: zcode-executor new --cwd <worktree> --title T-xxx --tier fast --json.
    4. 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>.
    5. Verify with git diff and tests before accepting. On failure, revise and send to the same session.

    Iron rules

    • Always send with --task. Editing the file later does not change authorization until you send again.
    • Accept with git diff and 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    zcode-executor
    Node.js
    Git
    ZCode desktop app

    Permissions

    Terminal / Shell
    Write Files
    Read Files

    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.

    Listed1 month ago

    What's inside

    Frequently Asked Questions

    This skill prevents 'hallucinated success' by offloading tasks to isolated git worktrees where changes must pass machine-verifiable criteria, such as git diffs and test suites, before being accepted.

    The skill requires Node.js 22 or higher, a macOS or Linux environment, and the ZCode desktop application for orchestration. Windows is not supported at this time.

    Yes, the skill is designed for a hub-and-spoke model where you can dispatch mechanical tasks to faster, cheaper tiers while maintaining a stronger model for high-level planning.

    You receive the core orchestration logic for managing isolated worktrees, the contract-based dispatching system, and pre-configured session management tools for your ZCode environment.

    Isolation is handled via dedicated git worktrees, ensuring that implementation tasks are sandboxed from your main development branch until they pass all automated verification checks.

    New in Agents & Orchestration