From 63a4b8ca6e8a3c305d7e24843bc825d27cd1fe31 Mon Sep 17 00:00:00 2001 From: Experimenting With Computers <1908752+makefunstuff@users.noreply.github.com> Date: Tue, 22 Sep 2026 13:44:07 +0300 Subject: [PATCH 1/4] docs(install): git tag primary until crates.io smoke PASSes --- README.md | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index e9a2413..722424a 100644 --- a/README.md +++ b/README.md @@ -29,15 +29,25 @@ context, `--each`, schema through `jq`, failure with reason and `exit 1`. ## Install -**Install line 1:** package `clank-cli-app` → binaries `clank` and `clank-jev` -(package ≠ binary). The crates.io crate named `clank` is unrelated — never -`cargo install clank`. Six direct dependencies, and nothing system-provided -beyond a C compiler (`ring`, for TLS; no OpenSSL to find). +**Install line 1 (until crates.io smoke PASSes):** git tag — do not lead with +`cargo install clank-cli-app` while the crate may 404. ```sh -cargo install clank-cli-app --locked # -> ~/.cargo/bin/clank and clank-jev +cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 +# -> ~/.cargo/bin/clank and clank-jev +``` + +After crates.io has `clank-cli-app` (manual Actions dispatch `publish_crates_io`, +not auto on tag): + +```sh +cargo install clank-cli-app --locked # package ≠ binary; runs as clank / clank-jev ``` +Never `cargo install clank` — that crates.io name is an unrelated project. Six +direct dependencies, and nothing system-provided beyond a C compiler (`ring`, +for TLS; no OpenSSL to find). + Prebuilt archives are attached to each [release](https://github.com/makefunstuff/clank/releases) — linux x86_64, macOS arm64 and macOS x86_64 — each holding both binaries, this README, the LICENSE, @@ -49,13 +59,6 @@ sha256sum -c clank-*.tar.gz.sha256 # macOS: shasum -a 256 -c tar xzf clank-*.tar.gz ``` -Until the first crates.io publish (manual Actions dispatch with -`publish_crates_io` — not auto on tag), or as a pinable fallback: - -```sh -cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 -``` - `--locked` holds the dependency graph to the committed `Cargo.lock`; `--tag` / `--rev ` pins clank itself. That directory is on `PATH` if you have installed anything with cargo before. From a checkout instead — `src/` is 2.8k From 8586d411dedb6ee35aa5c3ed278e597794a13b83 Mon Sep 17 00:00:00 2001 From: Experimenting With Computers <1908752+makefunstuff@users.noreply.github.com> Date: Tue, 22 Sep 2026 13:44:09 +0300 Subject: [PATCH 2/4] docs(cheatsheet): git tag install primary until crates.io live --- CHEATSHEET.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/CHEATSHEET.md b/CHEATSHEET.md index 5939161..490859a 100644 --- a/CHEATSHEET.md +++ b/CHEATSHEET.md @@ -18,8 +18,9 @@ on a laptop-only built-in default — point at your OpenAI-compatible server. ## Install ```sh -cargo install clank-cli-app --locked # package name; runs as clank / clank-jev -# fallback: cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 +# primary until crates.io smoke PASSes: +cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 +# after publish: cargo install clank-cli-app --locked # package ≠ binary → clank / clank-jev ``` Never `cargo install clank` (unrelated crates.io crate). From ff56fb6ced82fbf198e3d54a1a008a5199604420 Mon Sep 17 00:00:00 2001 From: Experimenting With Computers <1908752+makefunstuff@users.noreply.github.com> Date: Tue, 22 Sep 2026 14:20:21 +0300 Subject: [PATCH 3/4] docs(install): crates.io clank-cli-app primary after smoke PASS --- README.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 722424a..986a7c7 100644 --- a/README.md +++ b/README.md @@ -29,24 +29,22 @@ context, `--each`, schema through `jq`, failure with reason and `exit 1`. ## Install -**Install line 1 (until crates.io smoke PASSes):** git tag — do not lead with -`cargo install clank-cli-app` while the crate may 404. +**Install line 1:** package `clank-cli-app` → binaries `clank` and `clank-jev` +(package ≠ binary). Never `cargo install clank` — that crates.io name is an +unrelated project. ```sh -cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 -# -> ~/.cargo/bin/clank and clank-jev +cargo install clank-cli-app --locked # -> ~/.cargo/bin/clank and clank-jev ``` -After crates.io has `clank-cli-app` (manual Actions dispatch `publish_crates_io`, -not auto on tag): +Git fallback (pin a tag): ```sh -cargo install clank-cli-app --locked # package ≠ binary; runs as clank / clank-jev +cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 ``` -Never `cargo install clank` — that crates.io name is an unrelated project. Six -direct dependencies, and nothing system-provided beyond a C compiler (`ring`, -for TLS; no OpenSSL to find). +Six direct dependencies, and nothing system-provided beyond a C compiler +(`ring`, for TLS; no OpenSSL to find). Prebuilt archives are attached to each [release](https://github.com/makefunstuff/clank/releases) — linux x86_64, macOS From 2b3dc69208e7e35b864adb0dab7f600744b778c3 Mon Sep 17 00:00:00 2001 From: Experimenting With Computers <1908752+makefunstuff@users.noreply.github.com> Date: Tue, 22 Sep 2026 14:20:22 +0300 Subject: [PATCH 4/4] docs(cheatsheet): crates.io primary; git tag fallback --- CHEATSHEET.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/CHEATSHEET.md b/CHEATSHEET.md index 490859a..ed5dde6 100644 --- a/CHEATSHEET.md +++ b/CHEATSHEET.md @@ -18,9 +18,8 @@ on a laptop-only built-in default — point at your OpenAI-compatible server. ## Install ```sh -# primary until crates.io smoke PASSes: -cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 -# after publish: cargo install clank-cli-app --locked # package ≠ binary → clank / clank-jev +cargo install clank-cli-app --locked # package ≠ binary → clank / clank-jev +# fallback: cargo install --locked --git https://github.com/makefunstuff/clank --tag v0.1.0 ``` Never `cargo install clank` (unrelated crates.io crate).