@cori-do/cli 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Cori 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,41 @@
-# Temporary Holding Version
+# @cori-do/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.
+The `cori` command line: create, check, run and deploy Cori apps from a terminal, a coding agent or CI. It is a prebuilt
+binary for macOS and Linux (arm64 and x64): no Rust toolchain needed.
+
+```bash
+npm install -g @cori-do/cli      # or: pnpm add -g @cori-do/cli, bun add -g @cori-do/cli
+cori login https://<your Cori server>
+cori init my-app
+```
+
+Without installing it (a sandbox, CI): `npx @cori-do/cli <command>`. In Claude Cowork's sandbox, npm is reachable by
+default; the Cori server must be too (Organization settings › Capabilities › Code execution › Additional allowed domains).
+
+## What it installs
+
+Two packages: this one, a small launcher (`bin/cori.js`), and the binary for your platform, `@cori-do/cli-<os>-<cpu>`
+(`darwin-arm64`, `darwin-x64`, `linux-arm64`, `linux-x64`), which npm picks among this package's optional dependencies
+by its `os` and `cpu`. Nothing comes from anywhere but npm and no install script runs, so it installs where scripts are
+off (`--ignore-scripts`, pnpm, bun) and wherever npm is allowed through.
+
+- The Linux binaries are static (musl): any distribution, Alpine included.
+- Windows: install it in WSL.
+- Installed with `--omit=optional` (or `--no-optional`), the binary is missing, and the launcher says so.
+- `CORI_CLI_BINARY` runs another binary instead (one you built: `cargo install --path crates/cori-cli`).
+
+## Versions
+
+A Cori server names the oldest command line it serves. An older one prints a warning with the upgrade command, and
+`cori doctor` shows both versions.
+
+## Licence
+
+MIT. The binary includes open source software, listed with its licences in THIRD-PARTY-NOTICES.md.
+
+## Releasing
+
+A tag `v<version>` (the workspace's version in Cargo.toml, which this package.json repeats) runs the `release-cli`
+workflow: the four binaries, the packages (`pack.mjs`, with `scripts/cli-notices.sh`), then the platforms' packages
+published, and this one last. Started by hand, the workflow is a dry run. `test.sh` checks the packages as npm, pnpm and
+bun install them.