Z.ai Publishes ZCode as a Coding Workspace for Desktop, Web and Terminal
The repository packages several ways to run an agent around one shared stack, but the browser and terminal routes still require local runtime setup.
Listen to this story
The audio brief
Story brief
3 key pointsZ.ai’s open-source ZCode repository packages a coding agent into one stack that can be used through a desktop app, local browser workspace, or terminal UI. The desktop build targets macOS, Windows, and Linux on x64 and arm64, while terminal and web modes avoid Electron. The same `zcode` command launches terminal mode or, with `--web`, a loopback web server; broader network access triggers a default token. Node.js...
- 01
The repository includes the Electron desktop app, web client, backend, shared UI, CLI, and agent runtime.
- 02
Desktop builds support macOS, Windows, and Linux across x64 and arm64 architectures.
- 03
`zcode --web` starts the browser interface; running `zcode` without arguments opens the terminal UI.
Z.ai has published ZCode, a coding workspace that puts a desktop application, browser interface and terminal agent around the same underlying project. The release gives developers several ways to work with the agent without presenting those surfaces as separate products.
One stack, three entry points
The repository contains the Electron desktop app, web client, backend services, shared user-interface components, and the Agent command-line interface and runtime. That design puts the visible apps and the software that runs the agent in one codebase.
The desktop route is aimed at a packaged application experience. ZCode documents builds for macOS, Windows and Linux, with x64 and arm64 options. Its desktop development settings also allow a separate local data directory, useful when developers do not want test data mixed with an existing setup.
A terminal command can become a local web workspace
The packaged zcode command defaults to a terminal UI. The --web option starts a browser interface, while other arguments are handled by the existing Agent CLI. This lets a developer choose a terminal-first or browser-first workflow from the same distribution rather than installing Electron for either one.
- No arguments open the terminal UI.
- The --web flag starts the browser interface.
- Other arguments pass through to the Agent CLI.
Web mode listens on the local loopback address by default. Developers can set a non-local host for wider access; in that case, ZCode generates an access token by default. The documented web service also supports an authentication-token setting for its direct HTTP entry point.
The lighter interface is not a zero-setup route
The command-line distribution requires Node.js at runtime. Its build process brings together the CLI, terminal UI, backend and web components, and its generated installation script can install the zcode command locally. Developers can also unpack a release package and run it for local testing.
ZCode also documents remote project workflows through SSH and Windows Subsystem for Linux. In the documented development arrangement, resources prepared locally are uploaded to the remote project through SFTP. The choice among ZCode’s interfaces therefore changes the work surface, not the need to consider local runtime and remote-project handling.
Sources
- github.comGitHub - zai-org/ZCode: Z.ai's coding agent harness. Powerful, intelligent, extensible.
Reader comments
Newest comments first. Replies stay oldest first.