Metadata-Version: 2.4
Name: zeon
Version: 1.4.2rc1
Summary: Command-line interface for the Zeon platform.
Author-email: Zeon Team <team@zeonsystems.app>
License-Expression: MIT
Project-URL: Homepage, https://zeonsystems.app
Project-URL: Documentation, https://zeonsystems.app/docs/cli
Project-URL: Repository, https://github.com/ZeonSystems/everything-prototype-containers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13
Requires-Dist: tomli>=2.0; python_version < "3.11"
Requires-Dist: python-dotenv>=1.0
Requires-Dist: zeon-project-scaffold>=0.3.1rc1
Dynamic: license-file

# Zeon CLI

The command-line interface for the Zeon platform.

## Installation

```bash
pip install zeon
```

## Features

- **Auth**: Cognito hosted-UI + PKCE browser login.
- **Sync**: Git-style content-addressable synchronization (blob, tree, commit).
- **Projects**: Scaffolding and management.
- **Mesh Database**: Interact with the mesh network.

## Quick Start

```bash
zeon auth login
zeon project list
```

## Driving the cloud sim (coding agents)

```bash
zeon login
zeon push                       # send this folder's commits to the cloud project
zeon up                         # load it (and its world) on your instance; prints the viewer link
zeon brief                      # project, world, skills, workflows, recent runs
zeon py 'print(sim.world)'      # run code in your instance's REPL (sim only, logged)
zeon run pick_plate -i slot=5   # a sim run; --detach, then zeon wait / zeon logs -f
zeon snap out.png               # a picture of the sim viewer (zeon open prints its link)
zeon down                       # release your instance when done
```

Every verb takes `--json`; exit codes: 0 ok, 1 failed, 2 usage, 3 auth / not entitled,
4 refused by the REPL guard, 5 timeout, 6 instance unavailable. `zeon clone` / `zeon init`
write `AGENTS.md` and `CLAUDE.md` (the coding-agent guide) when the project has none.

For more details, see the [documentation](https://zeonsystems.app/docs/cli).
