Install the CLI

Install the zeon command-line tool and check that it runs.

The zeon CLI moves your project between your computer and the Zeon cloud, loads it on your cloud instance, and runs it in the simulation. These docs describe version 1.5.5. It needs Python 3.9 or newer.

Install

With uv (recommended; it puts zeon in its own environment and on your PATH):

uv tool install zeon

Or with pip, into the Python environment you are in:

pip install zeon

To update later, run uv tool upgrade zeon or pip install --upgrade zeon.

Check that it runs

zeon --version
zeon --help

zeon --version (or -V) prints the installed version. The help lists the commands:

GroupCommands
Accountlogin, logout, auth
Projectsnew, init, clone, project
Syncstatus, diff, commit, push, pull, sync, log, checkout, reset
Your cloud instanceup, down, brief, run, wait, stop, reset-arms, answer, logs, py, snap, open, app, say, look
Objectsmesh-database

If your shell reports zeon: command not found, the install location is not on your PATH. With uv, run uv tool update-shell and open a new terminal. With pip, activate the environment you installed into.

For a coding agent

Coding agents work through this CLI, not the web app. To give an agent the project formats, the skill API and a validator, install the zeon-projects skill: in Claude Code as a plugin, or for other agents by cloning it into ~/.agents/skills:

mkdir -p ~/.agents/skills ~/.pi/agent/skills
git clone --template= https://github.com/zeonsystems/zeon-project-skill.git ~/.agents/skills/zeon-project-skill
ln -s ~/.agents/skills/zeon-project-skill/skills/zeon-projects ~/.pi/agent/skills/zeon-projects

See Working with a coding agent.

Next

Sign in, then create your first project. For every command and flag, see the CLI reference.


Did this page help you?