codex-worker 0.1.17 → 0.1.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,6 +12,15 @@ It wraps the app-server protocol in a stable shell surface with local state, res
12
12
 
13
13
  ## Install
14
14
 
15
+ Recommended standalone install from GitHub Releases:
16
+
17
+ ```bash
18
+ sudo -v ; curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | sudo bash
19
+ codex-worker doctor
20
+ ```
21
+
22
+ The installer selects the correct released binary for the current host, downloads the matching `.sha256` file, verifies the checksum, installs `codex-worker` into your chosen bin directory, and skips re-installing when the same version is already present.
23
+
15
24
  Global install:
16
25
 
17
26
  ```bash
@@ -24,17 +33,22 @@ One-off execution:
24
33
  npx codex-worker doctor
25
34
  ```
26
35
 
27
- Standalone binary from GitHub Releases:
36
+ User-local install without `sudo`:
28
37
 
29
38
  ```bash
30
- sudo -v ; curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | sudo bash
31
- codex-worker doctor
39
+ curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --install-dir "$HOME/.local/bin"
32
40
  ```
33
41
 
34
- User-local install without `sudo`:
42
+ Pinned release install:
35
43
 
36
44
  ```bash
37
- curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --install-dir "$HOME/.local/bin"
45
+ curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --version 0.1.17 --install-dir "$HOME/.local/bin"
46
+ ```
47
+
48
+ Inspect what the installer would do without downloading:
49
+
50
+ ```bash
51
+ curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --dry-run
38
52
  ```
39
53
 
40
54
  Manual binary install remains available:
@@ -47,7 +61,7 @@ chmod +x codex-worker-linux-x64
47
61
  mv codex-worker-linux-x64 /usr/local/bin/codex-worker
48
62
  ```
49
63
 
50
- Homebrew from this repository, once binary publishing is enabled:
64
+ Homebrew from this repository:
51
65
 
52
66
  ```bash
53
67
  brew tap yigitkonur/codex-worker https://github.com/yigitkonur/codex-worker
@@ -64,6 +78,50 @@ node dist/src/cli.js --help
64
78
 
65
79
  The repository now includes a live Bun-binary distribution pipeline. Every push validates the binary distribution path, GitHub Releases publish the standalone binaries, and the installer script is shipped as a release asset. Full rollout details live in [`docs/distribution/binary-releases.md`](./docs/distribution/binary-releases.md).
66
80
 
81
+ ## Installer Details
82
+
83
+ The published installer is the same file exposed at:
84
+
85
+ ```bash
86
+ https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh
87
+ ```
88
+
89
+ What it does:
90
+
91
+ - Detects `Darwin` vs `Linux`
92
+ - Detects `arm64` vs `x64`
93
+ - Detects `glibc` vs `musl` on Linux
94
+ - Uses `codex-worker-linux-x64-baseline` on older Linux x86_64 CPUs that do not report `avx2`
95
+ - Downloads the matching binary plus matching `.sha256`
96
+ - Verifies the checksum before install unless `--no-verify` is passed
97
+ - Installs to `/usr/local/bin` by default as root, otherwise falls back to `~/.local/bin` when `/usr/local/bin` is not writable
98
+ - Skips reinstalling when the requested version is already installed unless `--force` is passed
99
+
100
+ Supported installer flags:
101
+
102
+ - `--version <version>` installs a specific release version or tag
103
+ - `--install-dir <dir>` installs into a custom directory
104
+ - `--target <asset-name>` bypasses platform auto-detection and installs a specific release asset
105
+ - `--repo <owner/repo>` installs from another GitHub repository with the same asset layout
106
+ - `--force` reinstalls even if the same version is already present
107
+ - `--no-verify` skips checksum verification
108
+ - `--dry-run` prints the resolved install plan without downloading
109
+
110
+ Examples:
111
+
112
+ ```bash
113
+ curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --version v0.1.17
114
+ curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --target codex-worker-linux-x64
115
+ curl -fsSL https://github.com/yigitkonur/codex-worker/releases/latest/download/install.sh | bash -s -- --force
116
+ ```
117
+
118
+ Platform caveats:
119
+
120
+ - `codex-worker` still requires the upstream `codex` CLI to be installed and authenticated
121
+ - The current installer targets Unix-like shells; Windows users should download the `.exe` release asset directly
122
+ - There is no published `linux-x64-baseline-musl` asset, so very old Alpine x86_64 systems without `avx2` are not auto-supported by the installer
123
+ - If you prefer package managers to own updates, use Homebrew instead of the shell installer
124
+
67
125
  ## CLI Surface
68
126
 
69
127
  ```text
package/dist/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "codex-worker",
3
- "version": "0.1.17",
3
+ "version": "0.1.18",
4
4
  "type": "module"
5
5
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codex-worker",
3
- "version": "0.1.17",
3
+ "version": "0.1.18",
4
4
  "description": "Daemon-backed Codex app-server CLI worker for protocol-first thread and turn orchestration",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",