What do you want to do?
4 use cases
-
Run a browser coding workspace on a local project
Start the web client and backend against one project folder and open it in a browser.
- ZCode
- Software and DevOps
- Intermediate
View prompt
In the zai-org/ZCode repo, run `pnpm bootstrap`, then `ZCODE_SERVER_WORKSPACE=<project-path> pnpm dev:web`. Report the web dev server URL and confirm that the backend at http://localhost:3030 responds.
-
Run the terminal agent from source on a project
Build and launch the Agent CLI and TUI directly from the apps/zcode-cli source.
- ZCode
- Software and DevOps
- Intermediate
View prompt
In the zai-org/ZCode repo, run `pnpm bootstrap` and then `pnpm --filter @zcode/cli dev --help`. Report the available options and state whether the help text lists a non-interactive mode.
-
Package the zcode command and test it locally
Build the release bundle, unpack it to a debug folder and start Web mode from it.
- ZCode
- Software and DevOps
- Advanced
View prompt
In the zai-org/ZCode repo, run `pnpm build:zcode --base-url <download-root-url>`, extract the tarball listed in dist/zcode/latest.json into dist/zcode/debug, and start it with --web on port 3030. Report the URL and confirm that http://127.0.0.1:3030 returns a page.
-
Build a UI plugin from the Excalidraw example
Follow the UI Plugin guide to start a plugin from the Excalidraw canvas example.
- ZCode
- Software and DevOps
- Advanced
View prompt
In the zai-org/ZCode repo, read UI_PLUGIN.md and build a plugin named <plugin-name> following the Excalidraw example. Report the files created and confirm that the plugin page loads at http://localhost:5173 under `pnpm dev:web`.
How to use ZCode
- Check you have what it needs: Git; Node.js 24.14.0 and pnpm 10.33.2, as pinned in mise.toml; Clone of the zai-org/ZCode repository.
- Open zai-org/ZCode on GitHub and read the README and license.
- Install Git, Node.js 24.14.0 and pnpm 10.33.2 as listed in mise.toml.
- Clone the repository and run
pnpm bootstrapfrom the repository root. - Run
ZCODE_SERVER_WORKSPACE=/path/to/project pnpm dev:webon macOS or Linux. - Open
http://localhost:5173in a browser.
These steps come from our top use case, Run a browser coding workspace on a local project, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers who want to run, package or extend the ZCode coding agent from source, in a browser or in the terminal.
- Why it is hot
- LanguageTypeScript
- Sourcegithub.com/zai-org/ZCode · Back to Hot repos
Requirements
- Git
- Node.js 24.14.0 and pnpm 10.33.2, as pinned in mise.toml
- Clone of the zai-org/ZCode repository
- A local project folder to point the agent at
Maintain ZCode? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/zai-org-zcode/?ref=badge)
Questions about ZCode
What is ZCode?
ZCode is Z.ai's AI coding workbench, offering a desktop app, a browser interface and a terminal agent, all built from one TypeScript monorepo. It is an open-source project on GitHub: https://github.com/zai-org/ZCode.
Who is ZCode for?
Developers who want to run, package or extend the ZCode coding agent from source, in a browser or in the terminal.
What can I do with ZCode?
4 use cases so far, for example: Run a browser coding workspace on a local project; Run the terminal agent from source on a project; Package the zcode command and test it locally. Each has steps and a copy-paste agent prompt.
What do I need to run ZCode?
Git; Node.js 24.14.0 and pnpm 10.33.2, as pinned in mise.toml; Clone of the zai-org/ZCode repository; A local project folder to point the agent at.
What are alternatives to ZCode?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is ZCode safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.