Metadata-Version: 2.4
Name: xyberos-cli
Version: 0.1.0
Summary: Xyberos plugin developer CLI — scaffold, validate, and repair plugins (wizard + generator + validator).
Author: Xyberos Contributors
License: Apache-2.0
Keywords: xyberos,ai,plugin,cli,scaffold,generator
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: xyberos>=1.0
Requires-Dist: xyberos-plugin-sdk>=0.1
Requires-Dist: xyberos-plugin-validator>=0.1
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"

# xyberos-cli

The Xyberos plugin developer command line — makes plugin contribution
one-command (see [`plugin-contribution.md`](https://github.com/xyberos/xyberos/blob/main/docs/plugin-contribution.md)).

## Install

```bash
pip install xyberos-cli
```

## Commands

```bash
# Scaffold a new plugin (interactive wizard)
xyberos plugin create

# Scaffold non-interactively
xyberos plugin create --name github --type tool --description "GitHub API integration" \
    --integrate-with "GitHub REST API" --auth token --non-interactive

# Validate a plugin package (static + live-kernel subprocess check)
xyberos plugin validate .

# Auto-repair missing contract stubs
xyberos plugin repair . --check
xyberos plugin repair .

# Repair-then-validate
xyberos plugin validate . --fix
```

## What it generates

`xyberos plugin create` scaffolds: `pyproject.toml` (with the
`xyberos.plugins` entry point), `README.md`, the plugin package
(`__init__`, `config`, `service`, `plugin`), `tests/test_plugin.py`, and
`examples/example.py`. The `service` class is derived from the chosen
contract by introspection, so the skeleton always matches the current
contracts (the "one rule").
