zeon project

zeon project is for managing the cloud-side properties of your projects: name, description, archival state. For creating one, use zeon new project. For working inside a project, use the working-tree commands.

Four subcommands:

Subcommand	What it does
`zeon project list`	List your projects
`zeon project rename`	Rename a project
`zeon project archive`	Soft-archive a project
`zeon project show`	Show one project's details

`zeon project list`

zeon project list                # active projects only
zeon project list --archived     # include archived
zeon project list --json         # machine-readable

Prints a table of your projects:

name              project_id    description                          updated
my-project        ab12cd34…     Lab plate prep                       2026-05-24 10:14
another-thing     ef56ab78…     Centrifuge experiments               2026-05-21 16:33

With --json, you get a list of project objects suitable for piping into jq or another tool.

`zeon project rename <id_or_name> <new_name>`

zeon project rename my-project lab-plate-prep
zeon project rename ab12cd34 lab-plate-prep

Renames a project. You can identify it either by its current name or its project id. The new name is a display name: 1 to 128 characters, with no character-set restriction.

Renaming a project does not rename the local working tree directory. That's whatever you cloned into. To match, mv the directory yourself.

`zeon project archive <id_or_name>`

zeon project archive my-project

Soft-archives the project. The project doesn't show up in zeon project list by default, but the data is preserved, and you can see it with zeon project list --archived and clone from it.

Archive is reversible but only via the web UI today; from the CLI, archive is one-way.

📘
Archive ≠ delete. Nothing is hard-deleted. Your commits, files, and history are still in cloud storage; the project is only hidden from the active list.

`zeon project show <id_or_name>`

zeon project show my-project
zeon project show my-project --json

Prints the project's metadata:

project_id:   ab12cd34…
name:         my-project
description:  Lab plate prep
created_at:   2026-05-10 09:00
updated_at:   2026-05-24 10:14
archived:     no

With --json, you get the raw record.

When to use these vs the IDE

The IDE's project-list page (at https://ide.zeonsystems.app) gives you the same operations with a UI:

List → the home page itself.
Create → New project button.
Archive → hover a card, click the trash icon.
Rename → not yet wired in the IDE; use the CLI.

The CLI is the more complete surface today, and the only place you can script project management.

Where to go next

zeon new

Creating a project (or any item inside one).

zeon working-tree commands

Clone, commit, push, pull.