zeon project, init and clone

List, show, rename and archive cloud projects; link a local folder; clone a project.

PID_OR_NAME is a project id or a project name.

zeon project list

zeon project list [--archived] [--json]

Your projects: project_id, name, updated_at, archived. --archived includes archived projects.

zeon project show

zeon project show PID_OR_NAME [--json]

A project's project_id, name, description, created_at, updated_at and archived.

zeon project rename

zeon project rename PID_OR_NAME NEW_NAME

Prints renamed <old> → <new>. Names are unique per account.

zeon project archive

zeon project archive PID_OR_NAME

Archives the project. Its history is kept; it no longer appears in zeon project list without --archived.

zeon init

zeon init [-m MESSAGE] [--agent-guide | --no-agent-guide]

Links the current folder to a new cloud project and pushes its files. The cloud project is named by "name" in the folder's project.json; the folder name plays no part. The folder must have project.json, skills/, workflows/ and worlds/.

It refuses, and creates nothing, when:

  • the folder already has .zeon/ (it is already linked: use zeon push);
  • there is no project.json, it cannot be read, or it has no "name". The message says how to add one, for example {"name": "my-project"};
  • a project with that name exists in your account, archived ones included. Change "name" in project.json, or rename the existing project with zeon project rename.

The first commit's message defaults to Import existing project. Writes AGENTS.md and CLAUDE.md when absent.

initialized my-project (<project id>)
  pushed 42 file(s) → <sha>

zeon clone

zeon clone PROJECT [TARGET_DIR] [--agent-guide | --no-agent-guide]

See Working-tree commands.


Did this page help you?