ZCode: a monorepo wearing desktop, web, and terminal hats
Z.ai built a single TypeScript stack that delivers an AI coding agent through an Electron app, a browser UI, or a terminal TUI.

What it does ZCode is an AI programming workbench that packages a coding agent into three interfaces: an Electron desktop app, a browser UI, and a terminal TUI. The repository contains the entire stack—client, backend server, shared React components, and CLI runtime—meant to be built and run as a single TypeScript monorepo. It is designed to support remote development over SSH or WSL by staging local build artifacts rather than relying on external CDN resources.
The interesting bit
The CLI can present either a TUI or a local HTTP server, both backed by the same agent runtime, which means the desktop shell is optional. The project enforces a strict Node.js version lock via mise.toml and stages local build artifacts in a mock CDN for remote development, keeping the whole loop off the public internet.
Key highlights
- Full-stack monorepo covering Electron desktop, web client, HTTP/WebSocket backend, and CLI/TUI agent.
- The
zcodeCLI serves both terminal and web interfaces from the same runtime. - Remote workspace support via SSH/WSL using locally staged mock-cdn assets.
- Shared UI layer built with React and Zustand, plus a custom RPC framework and provider abstraction.
- Desktop and CLI distributions are built and packaged from the same source tree.
Caveats
- The README is overwhelmingly focused on build scripts and packaging; it is unclear from the sources what specific agent capabilities or LLM providers are supported out of the box.
- Users migrating from the older “Lite” version must manually switch to new build commands and installation scripts, as the new setup will not migrate existing session data.
Verdict Worth a look if you want to self-host a multi-interface AI coding agent and don’t mind reading build scripts to figure out the feature set. Everyone else should probably wait for clearer documentation.
Frequently asked
- What is zai-org/ZCode?
- Z.ai built a single TypeScript stack that delivers an AI coding agent through an Electron app, a browser UI, or a terminal TUI.
- Is ZCode open source?
- Yes — zai-org/ZCode is open source, released under the Apache-2.0 license.
- What language is ZCode written in?
- zai-org/ZCode is primarily written in TypeScript.
- How popular is ZCode?
- zai-org/ZCode has 1.1k stars on GitHub.
- Where can I find ZCode?
- zai-org/ZCode is on GitHub at https://github.com/zai-org/ZCode.