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.
claude plugin marketplace add kyomio/zcode-executor claude plugin install zcode-executor@zcode-executor --scope user
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

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/zcodetool.callAround a tool call, where it can hold oneBashui.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
- Version
- 0.5.3
- License
- Apache-2.0
- Repo stars
- 5
- Last change
- 2026-10-15
- Language
- JavaScript
- Files
- 253