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.

By 2 min read
Z.ai Publishes ZCode as a Coding Workspace for Desktop, Web and Terminal
Z.ai Publishes ZCode as a Coding Workspace for Desktop, Web and Terminal

Listen to this story

The audio brief

About 1:34
0:001:34
Read transcript
Z.ai has published ZCode, an open-source coding workspace that puts a desktop app, a browser interface, and a terminal agent around the same underlying project. The important detail is that these are different entry points into one stack, not three separate products. The repository includes the Electron desktop application, the web client, backend services, shared interface components, and the Agent command-line interface and runtime. The desktop version is built for macOS, Windows, and Linux, with both x64 and arm64 support. It can also use a separate local data directory, so development data does not have to mix with an existing setup. For developers who do not want the Electron shell, ZCode offers terminal and browser modes. Running the `zcode` command with no arguments opens the terminal interface. Add `--web`, and it starts a local browser workspace instead. Other arguments continue through to the Agent CLI, so the same distribution can support different working styles. There is a practical constraint: this is not a zero-setup browser service. The command-line distribution still requires Node.js. Web mode listens on the local loopback address by default, and if it is exposed beyond the local machine, ZCode generates an access token by default. Remote work is documented through SSH and Windows Subsystem for Linux, with locally prepared resources transferred using SFTP. The key thing to watch is how much flexibility this shared stack delivers once runtime setup and remote-project handling enter the workflow.

Story brief

3 key points

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

  1. 01

    The repository includes the Electron desktop app, web client, backend, shared UI, CLI, and agent runtime.

  2. 02

    Desktop builds support macOS, Windows, and Linux across x64 and arm64 architectures.

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

  1. github.comGitHub - zai-org/ZCode: Z.ai's coding agent harness. Powerful, intelligent, extensible.

Loading discussion...

YOUR READING SPACE

Notifications

Z.ai Publishes ZCode as a Coding Workspace for Desktop, Web and Terminal | Superpower Daily