ClaudeCodeMod

All shelves / Mods / Workflow

zcode-executor

By KyoMio

zcode-executor is a Claude Code workflow mod by KyoMio.

For zcode-executor, which hands Claude's tasks to the local ZCode agent, draws a live pane of this project's ZCode sessions and the requests waiting on you.

Draws

Install

The marketplace name is zcode-executor.

In your shell
claude plugin marketplace add kyomio/zcode-executor
claude plugin install zcode-executor@zcode-executor --scope user
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.5.3
License
Apache-2.0
Repo stars
5
Last change
2026-10-15

What it can reach

  • Draws in the session
  • Reaches the network or an outside service
  • Sees tool calls
  • Calls another program on this machine

Needs macOS or Linux, Node 22 or newer, and the ZCode desktop app 3.12.2 or newer, installed and logged in. Windows is not supported yet. It needs a Claude Code version with function-hook mods, which the README calls early access. ZCode is the local GLM coding app at https://zcode.z.ai. /zcode opens a live pane of this project's sessions. The pane also opens when Claude sends a task. It shows requests waiting on you, with the full command and the reason, questions, and runners that died. A running turn shows the latest message, the tool and its arguments, recently finished tools, and the queue position for an off-peak send. Sessions that ended in the last 10 minutes show the outcome and their last message, and older ones take one line. A message longer than two lines is folded, and a press reads the rest. The status line sums up running turns and pending requests. A toast pops on a pending request, a finished turn, or a dead runner. The pane is read-only, and a pending request still goes through Claude. It reads zcode-executor watch, which the README calls read-only and long-running, with no quota, and it shows only sessions of the repository this Claude session is in. If the pane says node cannot be found, set nodePath in the plugin settings. Nothing costs tokens except send and the review calls. A send or a review uses the login stored in the ZCode app, an account Coding Plan or an API key in the app config. An off-peak send runs on the Coding Plan's free capacity, and the server decides when it starts. Optional Jev pre-screening stays off until a key is set, and that key is sent only as Jev authorization to TypeSafe at https://typesafe.ai/. The author measured this project's build as 35 task files, 4 executor sessions, 957M prompt tokens and 2.39M output tokens on the executor side. The reviewers can allow or ask, and the README says they never deny on your behalf.

The plugin is the repository. The marketplace name is zcode-executor. The live pane is why this page files it under workflow. cli-dispatch hands a task to DeepSeek, Gemini, Codex, OpenCode, or Copilot, and draws this session's workers above the prompt. keel-progress draws each live keel run above the prompt and in a side pane, read from keel status and the run's activity file. This one hands a task file to the ZCode agent in its own worktree, and the pane shows its sessions and the requests waiting on you. In the source, the pane's labels are Chinese. The pane starts the plugin's own watch command on this machine, and that watch sends nothing out. A task goes to a GLM session in its own worktree through the ZCode app on this machine. The model call uses the login that app stores. Optional Jev is the extra send, and only after the key is set. The pane does not answer a pending request. The same live view also ships in the DSH sidebar, as a separate install.

Demo

The Watch pane section of the zcode-executor README: /zcode opens a live pane of this project's ZCode sessions, with Needs you, Running, and Finished, and the status line and toasts.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/zcode
  • tool.callAround a tool call, where it can hold oneBash
  • ui.renderDraws into the sessionPane

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /zcode打开 zcode 任务观察面板(实时刷新本项目的会话进展)

Files

The author's README and source, 6 files. They load when you open them.

Facts

Author
KyoMio
Category
Workflow
Marketplace
zcode-executor
Repo
KyoMio/zcode-executor
Version
0.5.3
License
Apache-2.0
Repo stars
5
Last change
2026-10-15
Language
JavaScript
Files
253

Other mods in Workflow

arbeitslistenikisgeDraws a to-do field beside the chat, queues tasks while Claude works, and starts the next one, with Claude's plan above it.workfacescodge-24Draws the agent's notes in a panel and hands that file back verbatim after every compaction, auto or manual.brewmod-reminderskochetkov-maKeeps reminders as Markdown files that fire on time, draws a band of the fired ones in a later session, and has Claude run one when you pick it.navigatorqf-studioHolds a commandDraws a /nav pane of context, cost, reads, and the next task step as a button, and a phase band above the prompt, and guards fan-out reads.aftermidudevQueues prompts with /after while Claude works, draws the queue above the prompt, and sends the next one as your message when the turn ends.narratormidudevSpeaks a one or two sentence recap after each turn, in your language, with your system's best free voice, switched from the footer or /narrator.cc10xromiluz13For cc10x, which writes every workflow to disk, draws the phase, running agent, and next step above the prompt, and a pane of the whole step chain.engineerswingermanHolds a commandFor DAE, a spec- and test-driven methodology kit, draws a pipeline band and a /dae pane, and denies unconfirmed pushes and a frontier model on a loop.jevmem-paneAvinash-jetwaniFor jevmem, memory saved to JEVMEM.md, draws a side pane of what it recalled for your prompt, its guard's last call, and what it saved.vbwswt-labsHolds a commandFor VBW, which proves every requirement with a check, draws a Mission Control pane and a Comms strip, and denies risky commands during a run.project-sentinelArjun0014Holds a commandDraws a status bar above the prompt for long runs, with milestones, context, cache, and the 5-hour window, a Control Room panel, and asks before risky calls.cortexesXBlueSkyFor Cortexes, a vault of your recorded sessions, draws its session-start menu as a band above the prompt, and offers a hand-off once the context is 70% full.
All 396 in Workflow