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 zeonOr with pip, into the Python environment you are in:
pip install zeonTo update later, run uv tool upgrade zeon or pip install --upgrade zeon.
Check that it runs
zeon --version
zeon --helpzeon --version (or -V) prints the installed version. The help lists the commands:
| Group | Commands |
|---|---|
| Account | login, logout, auth |
| Projects | new, init, clone, project |
| Sync | status, diff, commit, push, pull, sync, log, checkout, reset |
| Your cloud instance | up, down, brief, run, wait, stop, reset-arms, answer, logs, py, snap, open, app, say, look |
| Objects | mesh-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-projectsSee Working with a coding agent.
Next
Sign in, then create your first project. For every command and flag, see the CLI reference.
Updated about 19 hours ago