Metadata-Version: 2.4
Name: plgt
Version: 0.1.0b14
Summary: Poliglot developer CLI
Author: Poliglot Inc.
License-Expression: Apache-2.0
Project-URL: Documentation, https://poliglot.io/docs/cli
Project-URL: Homepage, https://poliglot.io
Project-URL: Repository, https://github.com/poliglot-io/plgt-cli
Project-URL: Issues, https://github.com/poliglot-io/plgt-cli/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: appdirs>=1.4.4
Requires-Dist: click>=8.1.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: oauthlib>=3.2.2
Requires-Dist: owlrl>=7.1.3
Requires-Dist: pynacl>=1.5.0
Requires-Dist: pygls>=2.0.0
Requires-Dist: pyshacl>=0.30.1
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rdflib>=7.1.1
Requires-Dist: ruamel.yaml>=0.18.0
Requires-Dist: requests>=2.32.3
Requires-Dist: semver>=3.0.0
Requires-Dist: rich>=13.9.4
Requires-Dist: sseclient-py>=1.8.0
Requires-Dist: typer>=0.15.1
Requires-Dist: validators>=0.34.0
Dynamic: license-file

# plgt

The authoring CLI for [Poliglot](https://poliglot.io), a semantic operating system that turns the things you do and the way you work into an executable program.

A *matrix* is a composable specification of your operating model — its capabilities, policies, and rules. `plgt` is the toolchain for authoring matrices: scaffolding a workspace, declaring matrix sources in Turtle, installing matrix packages from the public registry, validating them locally, and shipping them to a Poliglot workspace.

Status: **alpha**. Poliglot is in private beta; the CLI is stable enough to use day-to-day, but commands may evolve before 1.0.

## Installation

```bash
pip install plgt
```

Requires Python 3.12.x. [`uv`](https://docs.astral.sh/uv/) is the recommended install path:

```bash
uv tool install plgt
```

## Quickstart

```bash
plgt --help                       # list every command
plgt auth login                   # authenticate against a workspace
plgt init my-matrix && cd my-matrix
plgt validate                     # run the validation pipeline
plgt build                        # produce the package tarball
plgt install --workspace dev      # ship it to a workspace
```

Each command has its own page in the [CLI reference](https://poliglot.io/docs/cli), auto-generated from this repo's source on every release.

## Documentation

- [CLI reference](https://poliglot.io/docs/cli) — every command's flags, defaults, and help text, auto-generated from this repo.
- [Full Poliglot docs](https://poliglot.io/docs)

## Contributing

Local setup, test commands, and the PR workflow live in [CONTRIBUTING.md](CONTRIBUTING.md). All contributors must sign the [Poliglot Contributor License Agreement](https://poliglot.io/cla) before their first PR is merged.

Bugs and feature requests: GitHub Issues. Security issues: [private security advisories](https://github.com/poliglot-io/plgt-cli/security/advisories/new) (see [SECURITY.md](SECURITY.md)).

## License

[Apache License 2.0](LICENSE) · © Poliglot Inc.
