@mistweaverco/kulala-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025+ mistweaverco
+
+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,152 @@
+<div align="center">
+
+![kulala-cli Logo][logo]
+
+# kulala-cli
+
+[![npm][badge-npm]][link-npm]
+[![latest release][badge-github]][link-github]
+[![Discord][badge-discord]][discord]
+
+[Install](#install) •
+[Usage](#usage)
+
+<p></p>
+
+A fully-featured 🤏 HTTP/GraphQL/gRPC/Websocket-client 🐼
+interface 🖥️ for your command-line ❤️,
+that supports the Jetbrains .http spec (with full scripting support).
+
+<p></p>
+
+</div>
+
+## Install
+
+You can install kulala-cli globally using `npm`, `bun`, `yarn` or `pnpm`:
+
+```sh
+npm install -g @mistweaverco/kulala-cli
+bun add -g @mistweaverco/kulala-cli
+yarn global add @mistweaverco/kulala-cli
+pnpm add -g @mistweaverco/kulala-cli
+```
+
+You can also run it directly without installation using
+
+`npx`, `bunx`, `yarn dlx` or `pnpx`:
+
+```sh
+npx @mistweaverco/kulala-cli run --report file.http
+bunx @mistweaverco/kulala-cli run --report file.http
+yarn dlx @mistweaverco/kulala-cli run --report file.http
+pnpx @mistweaverco/kulala-cli run --report file.http
+```
+
+On install, kulala-cli downloads a matching
+[kulala-core](https://github.com/mistweaverco/kulala-core)
+binary automatically.
+
+If install scripts are disabled
+(for example `npm install --ignore-scripts`),
+the binary is downloaded on first use instead.
+
+To use your own kulala-core binary, set `KULALA_CORE_PATH`:
+
+```sh
+export KULALA_CORE_PATH=/path/to/kulala-core
+```
+
+### Usage
+
+Run a `.http` file and print human-readable output:
+
+```sh
+kulala run file.http
+```
+
+Run a `.http` file and print the raw kulala-core JSON output:
+
+```sh
+kulala run --json file.http
+```
+
+Run a `.http` file and print a report:
+
+```sh
+kulala run --report file.http
+```
+
+Run all files in a directory and print a report:
+
+```sh
+kulala run --report ./requests
+```
+
+Run all files in a directory (in random order) and print a report:
+
+```sh
+kulala run --report --shuffle ./requests
+```
+
+Only print output when a request fails:
+
+```sh
+kulala run --quiet ./requests
+```
+
+Select an environment for variable resolution:
+
+```sh
+kulala run --report --env=production file.http
+```
+
+Run a single request by block name (`###` name):
+
+```sh
+kulala run file.http --name MyRequest
+```
+
+Run the request at a cursor location (1-based line and column, same as kulala.nvim):
+
+```sh
+kulala run file.http --line 17
+kulala run file.http --line 19 --column 1
+```
+
+When using `--name`, `--line`,
+or `--column`, `<path>` must be a single `.http` or
+`.rest` file.
+
+### Exit behaviour
+
+kulala-cli exits with code `1` when any request fails. Execution stops after the
+first failing request within a file, and remaining files in a directory are not run.
+
+Success is determined by kulala-core's `success` flag, so operators such as
+`// @kulala-expect-status-code` are respected (for example, an expected `404` is
+treated as a pass).
+
+### Development
+
+```sh
+pnpm install
+pnpm run build
+pnpm run lint
+node dist/cli.cjs --help
+```
+
+To use a locally built kulala-core binary during development:
+
+```sh
+export KULALA_CORE_PATH=/path/to/kulala-core/dist/kulala-core
+node dist/cli.cjs run file.http
+```
+
+[logo]: https://raw.githubusercontent.com/mistweaverco/kulala-cli/main/assets/logo.svg
+[discord]: https://mistweaverco.com/discord
+[badge-discord]: https://mistweaverco.com/assets/badges/discord.svg
+[badge-github]: https://img.shields.io/github/v/release/mistweaverco/kulala-cli?style=for-the-badge
+[link-github]: https://github.com/mistweaverco/kulala-cli/releases/latest
+[badge-npm]: https://img.shields.io/npm/v/@mistweaverco/kulala-cli?style=for-the-badge
+[link-npm]: https://www.npmjs.com/package/@mistweaverco/kulala-cli