@livewebdata-com/cli 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Teneo Labs Inc.
+
+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

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# Live Web Data CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+How fresh is the web your AI reads? Live data, explained plainly.
+
+`livewebdata` fetches live web pages as clean Markdown, text or HTML, straight from your terminal or your agent's shell.
+It is the command line client for the [Live Web Data API](https://livewebdata.com) by Live Web Data.
+
+## Quick start
+
+```bash
+npx @livewebdata-com/cli login                                   # paste your API key (not echoed)
+npx @livewebdata-com/cli fetch https://example.com -o text       # the page as Markdown
+```
+
+Get a key at [livewebdata.com](https://livewebdata.com). Node.js 18 or later.
+
+## Install
+
+```bash
+npm install -g @livewebdata-com/cli
+livewebdata --help
+```
+
+## Use
+
+```bash
+livewebdata fetch https://example.com/a https://example.com/b      # up to 10 URLs; JSON with results[] and statuses[]
+livewebdata fetch https://example.com -o text                      # just the content (Markdown, else text, else HTML)
+livewebdata fetch https://example.com -o html --html               # the page HTML
+livewebdata fetch https://example.com --country-code de --render   # from Germany, rendered in a real browser
+livewebdata fetch --data @request.json                             # the whole request body from a file (- for stdin)
+livewebdata account                                                # plan, credits and rate limit
+livewebdata fetch --help                                           # every option, with the API's own descriptions
+```
+
+A fetch that is still running after about 100 seconds is collected automatically with the same
+`Idempotency-Key`, so it is charged once.
+
+## The commands follow the live API
+
+`livewebdata` builds its commands and options from the API's OpenAPI document at
+[https://livewebdata.com/openapi.json](https://livewebdata.com/openapi.json), cached for an hour. When the API gains a field or an endpoint, the
+option or command is there on your next run, without updating the CLI. Offline, it uses the last cached
+copy, then the copy bundled with the installed version (`livewebdata spec` shows which one; `--offline` skips the
+download). A daily job here publishes a new version whenever the API spec changed.
+
+## Configuration
+
+| Setting | Option | Environment | Default |
+|---|---|---|---|
+| API key | `--api-key` | `LIVE_WEB_DATA_API_KEY` | the key saved by `livewebdata login` (`~/.config/livewebdata/config.json`, mode 0600) |
+| API base URL | `--base-url` | `LIVE_WEB_DATA_API_BASE_URL` | `https://livewebdata.com/api` |
+| API spec URL | `--spec-url` | `LIVE_WEB_DATA_SPEC_URL` | `https://livewebdata.com/openapi.json` |
+| Output | `-o json\|text\|<field>` | | `json` |
+| Update notice | | `LIVEWEBDATA_NO_UPDATE_NOTIFIER=1` turns it off | once a day, terminals only |
+
+Requests and your key only ever go to the base URL, never to a server named in the spec.
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | OK |
+| 1 | The API answered with an error (JSON on stderr, with its `requestId`), every URL failed with `-o text`, or the fetch was still running at `--max-wait` |
+| 2 | Usage: unknown command or option, a value the API does not accept |
+| 3 | Network: no answer. The error carries the `Idempotency-Key` to collect the result without a new charge |
+
+## Links
+
+- [livewebdata.com](https://livewebdata.com)
+- [Docs](https://livewebdata.com/docs)
+- [API spec](https://livewebdata.com/openapi.json)
+
+## License
+
+MIT, © Teneo Labs Inc.

package/bin/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+// @ts-check
+import { main } from "../src/main.js";
+
+main(process.argv.slice(2), { env: process.env, stdin: process.stdin, stdout: process.stdout, stderr: process.stderr }).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (e) => {
+    process.stderr.write(`${e?.stack ?? e}\n`);
+    process.exitCode = 1;
+  },
+);

package/brand.json

@@ -0,0 +1,14 @@
+{
+  "name": "Live Web Data",
+  "tagline": "How fresh is the web your AI reads? Live data, explained plainly.",
+  "domain": "livewebdata.com",
+  "bin": "livewebdata",
+  "npm": "@livewebdata-com/cli",
+  "org": "livewebdata-com",
+  "repo": "cli",
+  "siteUrl": "https://livewebdata.com",
+  "docsUrl": "https://livewebdata.com/docs",
+  "apiName": "Live Web Data API",
+  "apiBaseUrl": "https://livewebdata.com/api",
+  "specUrl": "https://livewebdata.com/openapi.json"
+}