@plenary/cli 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick DeLoughry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @plenary/cli
+
+The `plenary` command: a client for the Plenary API from a shell, a script,
+or CI. Sync model and form YAML with an instance, manage entries and media,
+and call any endpoint.
+
+```sh
+npm install --save-dev @plenary/cli
+npx plenary init                     # writes plenary.json (no secrets)
+export PLENARY_API_KEY=pln_prv_…
+npx plenary status
+```
+
+```sh
+plenary metadata pull                # instance → models/ and forms/
+plenary metadata diff                # what push would change
+plenary metadata push                # apply (never deletes)
+
+plenary entries list post --where status=published --limit 20
+plenary entries create post --data '{"title":"Hello"}' --slug hello --publish
+plenary entries export post > posts.ndjson
+
+plenary media upload hero.jpg
+plenary forms entries export contact > contact.ndjson
+plenary api GET models
+```
+
+Configuration comes from flags, `PLENARY_*` variables, a `.env`, then
+`plenary.json`. The credential is an API key; what the CLI may do is that
+key's grants. `--json` on any command prints the API's JSON; exit 1 is an
+API error, 2 a usage error.
+
+Full reference: `docs/CLI.md` in the Plenary repository.