@jiawei666/codesk 0.2.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+Copyright 2025 OpenAI
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/NOTICE

@@ -0,0 +1,6 @@
+OpenAI Codex
+Copyright 2025 OpenAI
+
+This project includes code derived from [Ratatui](https://github.com/ratatui/ratatui), licensed under the MIT license.
+Copyright (c) 2016-2022 Florian Dehau
+Copyright (c) 2023-2025 The Ratatui Developers

package/README.md

@@ -0,0 +1,245 @@
+# CODESK
+
+CODESK 是一个用 Rust + Ratatui 编写的终端工作台，用来在一个终端窗口里组织本机的 Codex 会话、查看工作区文件和浏览 Git 变更。
+
+它不是 `codex-rs` 的编译版本，也不把 Codex 的代码嵌入自身。CODESK 运行时调用本机已经安装的 `codex` CLI：中间栏通过 PTY 承载 Codex 原生界面，左右两栏负责会话、项目和文件工作区。
+
+## 当前界面
+
+```text
+┌─ PROJECTS / SESSIONS ─┬─ CODEX ─────────────────────────┬─ FILES / CHANGES ─┐
+│ 项目和会话             │ Codex 原生 PTY                  │ 文件树、预览、diff  │
+│ AGENT STATUS           │                                  │ 编辑器              │
+└────────────────────────┴──────────────────────────────────┴────────────────────┘
+```
+
+- 左栏：按工作目录分组的 Codex 会话列表，以及 App Server 状态和额度信息。
+- 中间栏：Codex 的原生终端界面，包括输入、审批、命令输出和会话历史。
+- 右栏：当前项目的文件导航、Git changes、文件预览、彩色 diff 和受限编辑器。
+- 底部：当前工作目录、Git 分支和当前焦点面板的快捷键提示。
+
+面板外框始终存在；焦点面板只会切换标题和边框的高亮色。鼠标可以用于终端或文件区域的选择、滚动和点击，但不会因为鼠标移动而自动改变键盘焦点。键盘焦点由 `Tab`、`Shift-Tab`、`Ctrl-Tab`、`F7` 和 `F8` 控制。
+
+## 已实现功能
+
+### Codex PTY
+
+- 启动 `codex --no-alt-screen -C <工作目录>`，恢复会话时额外传入 `--session <SESSION_ID>`。
+- 保留 Codex 原生键盘、颜色、鼠标协议、审批交互和终端布局。
+- 每个打开的会话拥有自己的 PTY 和虚拟终端 scrollback，最多保留 10,000 行历史。
+- 新建会话首次打开时显示 CODESK 启动画面；恢复已有会话时直接进入 Codex 内容。
+- CODESK 退出时只停止自己创建的 Codex PTY，不主动停止共享的 Codex App Server。
+
+### 项目与会话
+
+- 通过 `codex app-server proxy` 读取本机 App Server 的会话列表。
+- 如果 App Server 尚未运行，会尝试执行 `codex app-server daemon start` 后重试。
+- 会话按工作目录分组，项目按路径排序；同一项目下的会话按 `updatedAt` 从新到旧排列。
+- 项目可折叠。项目收起后，仍会在项目行旁显示最新子会话状态。
+- 状态只有三种有意义的显示：运行中的动态 spinner、完成后的 `✓` 和错误的 `×`；这两种终态标记都会保留约 3 秒后自动隐藏，无法识别的状态不额外占用状态位。
+- 左栏初次加载、刷新和删除会话都有明确的进行中反馈；`Delete` 异步删除当前选中的会话。
+- `Ctrl-N` 打开新会话目录对话框，默认填入左栏指针所在项目或会话的工作目录；支持路径编辑和 `Tab` 补全。
+- 左栏当前选中行有底色；当焦点离开左栏时，蓝色指针会回到当前活动会话，不会产生第二条指针。
+
+App Server 会话列表默认每 5 秒刷新一次，单次最多读取 100 个未归档会话。`AGENT STATUS` 显示连接状态、5 小时额度和周额度；如果 App Server 没有返回某项数据，就显示动态加载或 `--`，不会伪造百分比。
+
+### 文件、Git changes 与预览
+
+- 右栏从当前工作目录开始导航，不关闭文件树即可在旁边打开文件预览或 diff。
+- `g` 在完整文件树和 Git changes 之间切换；文件名旁显示 Git 状态标记。
+- `d` 查看当前文件的 `git diff HEAD`；未跟踪文件会生成对应的新文件 diff。
+- diff 对新增行、删除行和 hunk 标记使用不同的背景色和前景色。
+- 普通文本预览使用 `two-face` 提供的 `syntect` 语法定义和 Catppuccin Mocha 主题，按文件后缀及常见无后缀文件名识别多种语言；无法识别时安全退回纯文本。
+- 目录导航和代码/ diff 阅读区各自维护独立选区。当前焦点面板按 `Ctrl-C` 只复制自己的选区，不会把两个面板拼接或互相覆盖。
+- 右栏打开预览后，文件树保持可见；`Esc` 先关闭编辑器或预览，再次按下才关闭右栏。
+- `Ctrl-F` 在右栏打开搜索面板，默认搜索文件名和路径；结果按目录树展示。
+- 搜索面板支持文件搜索和全局代码搜索。代码结果按目录、文件和匹配行分组，打开结果后会定位到目标行并高亮匹配内容。
+- 搜索通过后台 `ripgrep` 任务执行，输入变化会取消旧任务，结果会流式显示且最多保留 500 条，不阻塞中间 PTY。
+
+### 受限编辑器
+
+- 在普通文件预览中按 `e` 进入编辑；diff 视图不能直接编辑。
+- 支持插入、删除、方向移动、分页、行号、保存和从磁盘重新加载。
+- `Ctrl-S` 保存，`Ctrl-Shift-R` 放弃本地修改并从磁盘重载。
+- 文件必须位于当前工作区内，禁止编辑符号链接、二进制文件和超过 256 KiB 的文件。
+- 保存前会检查磁盘快照；文件被其他进程修改后，CODESK 会拒绝覆盖并要求先重载。
+
+## 运行要求
+
+- Rust 工具链，能够编译 Rust 2024 edition。
+- 本机可以执行 `codex --version`；如果 `codex` 不在 `PATH`，使用 `--codex-path` 指定路径。
+- 当前工作目录最好是 Git 仓库；Git 用于分支、文件状态和 diff，缺少 Git 时这些信息会退化为空状态。
+- 全局代码搜索依赖 `rg`（ripgrep）在 `PATH` 中可执行；缺少时右栏会显示搜索启动错误。
+- 系统需要能够提供终端剪贴板能力；终端选择和文件选择复制都使用系统剪贴板。
+
+## 本地运行
+
+在仓库根目录执行：
+
+```bash
+cargo run --
+```
+
+常用启动参数：
+
+```bash
+# 指定工作目录
+cargo run -- --cwd /path/to/project
+
+# 指定 Codex 可执行文件
+cargo run -- --codex-path /path/to/codex
+
+# 启动并恢复已有会话
+cargo run -- --cwd /path/to/project --session SESSION_ID
+
+# 查看参数说明
+cargo run -- --help
+```
+
+编译 release 二进制：
+
+```bash
+cargo build --release
+./target/release/codesk --cwd /path/to/project
+```
+
+命令行参数只有以下三项：
+
+| 参数 | 说明 | 默认值 |
+| --- | --- | --- |
+| `--codex-path PATH` | Codex CLI 的可执行文件路径 | `codex` |
+| `--cwd DIR` | 初始工作目录 | 当前目录 |
+| `--session SESSION_ID` | 要恢复的 Codex 会话 ID | 新建会话 |
+
+## 快捷键
+
+### 全局与面板焦点
+
+| 快捷键 | 作用 |
+| --- | --- |
+| `Tab` | 顺时针切换已打开的面板；中间栏正在输入 `/...` 命令时交给 Codex 补全 |
+| `Shift-Tab` | 反向切换面板；中间栏正在输入 `/...` 命令时交给 Codex |
+| `Ctrl-Tab` / `Ctrl-Shift-Tab` | 强制切换面板，即使中间栏正在输入 slash command |
+| `F7` | 显示/隐藏左侧项目和会话栏 |
+| `F8` | 显示/隐藏右侧文件栏 |
+| `Ctrl-F` | 打开右侧搜索面板，默认进入文件搜索 |
+| `Ctrl-←` / `Ctrl-→` | 在文件搜索和代码搜索之间切换 |
+| `Esc` | 左栏焦点返回中间栏；右栏按层关闭编辑器、预览和右栏 |
+| `Ctrl-Q` | 打开退出确认；`Enter`/`y` 确认，`Esc`/`n` 取消 |
+| `Ctrl-N` | 打开新建会话目录对话框；不会在左栏常驻 `New session` 行 |
+
+### 中间 Codex 面板
+
+| 快捷键/操作 | 作用 |
+| --- | --- |
+| 普通键盘输入 | 原样发送给 Codex PTY |
+| `Alt-↑/↓` | 上下滚动 PTY 历史 |
+| `Alt-PageUp/PageDown` | 按页滚动 PTY 历史 |
+| `Alt-Home/End` | 跳到 PTY 历史顶部/当前屏幕 |
+| 鼠标左键拖拽 | 选择终端文本；没有选区时点击仍交给 Codex 的鼠标协议 |
+| 鼠标滚轮 | 优先滚动中间栏自己的终端历史 |
+| `Ctrl-C` | 有终端选区时复制；没有选区时发送给 Codex |
+| `Ctrl-Shift-C` | 有终端选区时复制 |
+
+### 左侧项目与会话栏
+
+| 快捷键/操作 | 作用 |
+| --- | --- |
+| `↑` / `↓` | 选择项目或会话 |
+| `Home` / `End` | 跳到列表首尾 |
+| `←` / `→` | 折叠/展开当前项目；会话行上也会作用于其所属项目 |
+| `Enter` | 恢复选中的会话；在项目行打开以该项目目录为默认值的新会话弹窗 |
+| `Delete` | 异步删除选中的已有会话 |
+| `r` | 从 App Server 刷新会话列表 |
+| 鼠标滚轮 | 按列表方向移动选择 |
+| 鼠标左键 | 选择并打开会话 |
+
+### 右侧文件栏
+
+| 快捷键/操作 | 作用 |
+| --- | --- |
+| `↑` / `↓` | 选择文件或目录 |
+| `PageUp` / `PageDown` | 按页移动选择或预览滚动 |
+| `←` / `Backspace` | 返回父目录；在根目录关闭预览 |
+| `→` / `Enter` | 进入目录或打开文件预览 |
+| `g` | 切换完整文件树 / Git changes |
+| `d` | 打开当前文件的 diff；预览中切换文件 / diff |
+| `r` | 刷新目录或重新读取当前预览 |
+| `e` | 在普通文件预览中进入编辑器 |
+| 预览中的 `Esc` / `Backspace` | 关闭当前预览；编辑器用 `Esc`（无未保存修改时）关闭 |
+| `Ctrl-S` | 保存编辑器内容 |
+| `Ctrl-Shift-R` | 从磁盘重载并丢弃本地编辑 |
+| 鼠标左键拖拽 | 选择目录文本或代码文本 |
+| `Ctrl-C` | 复制当前右栏选区 |
+
+搜索面板打开时：
+
+| 快捷键/操作 | 作用 |
+| --- | --- |
+| `Tab` / `Shift-Tab` | 在模式标签、搜索框和结果树之间切换焦点 |
+| `Ctrl-←` / `Ctrl-→` | 切换文件搜索 / 代码搜索 |
+| `↑` / `↓` | 选择搜索结果 |
+| `Enter` | 文件搜索打开文件；代码搜索打开文件并定位匹配行 |
+| `Esc` | 关闭搜索面板并恢复普通文件树 |
+| 鼠标点击模式标签 | 切换搜索方式 |
+
+## 项目结构
+
+```text
+codesk/
+├── src/main.rs                 # 参数解析和程序入口
+├── src/app.rs                  # TUI 生命周期、焦点、会话切换
+├── src/app_server.rs           # App Server proxy、会话和额度读取
+├── src/terminal.rs             # Codex PTY、虚拟终端和终端选区
+├── src/search.rs               # 右栏搜索面板和搜索结果树
+├── src/search_engine.rs        # 后台 ripgrep 搜索任务和结果解析
+├── src/files.rs                # 文件树、Git 状态、预览、diff 和复制
+├── src/editor.rs               # 工作区边界内的轻量编辑器
+├── src/syntax.rs               # 文件预览语法着色
+├── src/ui.rs                   # 三栏布局、状态标记和快捷键提示
+├── src/theme.rs                # CODESK 和代码预览颜色
+├── bin/codesk.js               # npm 主包的跨平台 launcher
+├── scripts/                    # npm 平台包生成和版本检查脚本
+├── package.json                # npm 主包元数据
+└── .codex/skills/              # 项目级 Codex 工作流 skill
+```
+
+## 开发检查
+
+提交 Rust 代码前建议执行：
+
+```bash
+cargo fmt --all
+cargo test
+cargo build --release
+git diff --check
+```
+
+UI 行为、快捷键、文件预览和会话状态的变化应优先补充对应的 Rust 测试；当前测试位于各源码模块的 `#[cfg(test)]` 区域。
+
+## 发布方式
+
+CODESK 的发行方式是统一使用 npm 分发跨平台预编译二进制：
+
+- 主 npm 包提供 `codesk` 命令入口；
+- 平台 npm 包分别承载 Linux、macOS 和 Windows 的 Rust 二进制；
+- 主包根据运行平台选择对应平台包；
+- GitHub 用于源码、版本 tag 和可选 Release，用户安装入口仍然是 npm。
+
+当前仓库已经包含 npm 主包 launcher 和平台包生成脚本。发布流程在本地完成：先构建并检查五个平台包，再按顺序发布平台包和主包；平台包不会提交到 Git，而是在本地发布前生成。
+
+npm 二进制包的版本同步、平台矩阵、`npm pack --dry-run`、认证和发布顺序由项目级 skill 约束：
+[`github-npm-release`](.codex/skills/github-npm-release/SKILL.md)。首个 `v0.1.0` npm 版本完成发布前，本地仍使用上面的 `cargo run` 和 `cargo build --release`；发布完成后，用户安装命令为：
+
+```bash
+npm install -g @jiawei666/codesk
+codesk
+```
+
+## 设计边界
+
+- CODESK 不编译或修改 `codex-rs`。
+- CODESK 不接管 Codex 的会话存储；会话元数据通过 App Server 读取。
+- App Server 是会话和额度的控制/元数据平面，PTY 是中间栏的交互/渲染平面。
+- 右侧文件操作始终受当前工作区边界限制，不提供任意路径编辑能力。
+- CODESK 只负责自己创建的 PTY；退出时不杀掉其他 Codex 客户端或共享 daemon。

package/bin/codesk.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+const { spawn } = require("node:child_process");
+
+const platformPackages = {
+  "darwin-arm64": "@jiawei666/codesk-darwin-arm64",
+  "darwin-x64": "@jiawei666/codesk-darwin-x64",
+  "linux-arm64": "@jiawei666/codesk-linux-arm64",
+  "linux-x64": "@jiawei666/codesk-linux-x64",
+  "win32-x64": "@jiawei666/codesk-win32-x64"
+};
+
+const platformKey = `${process.platform}-${process.arch}`;
+const packageName = platformPackages[platformKey];
+
+if (!packageName) {
+  console.error(`CODESK does not provide a binary for ${platformKey}.`);
+  process.exit(1);
+}
+
+const binaryName = process.platform === "win32" ? "codesk.exe" : "codesk";
+let binaryPath;
+
+try {
+  binaryPath = require.resolve(`${packageName}/bin/${binaryName}`);
+} catch {
+  console.error(`The CODESK binary package ${packageName} is not installed.`);
+  console.error("Reinstall @jiawei666/codesk to restore the platform binary.");
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: false
+});
+
+child.on("error", (error) => {
+  console.error(`Failed to start CODESK: ${error.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@jiawei666/codesk",
+  "version": "0.2.0",
+  "description": "A Rust terminal workbench for the installed Codex CLI.",
+  "private": false,
+  "bin": {
+    "codesk": "bin/codesk.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jiawei666/codesk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jiawei666/codesk/issues"
+  },
+  "homepage": "https://github.com/jiawei666/codesk#readme",
+  "keywords": [
+    "codex",
+    "tui",
+    "terminal",
+    "rust",
+    "cli"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@jiawei666/codesk-darwin-arm64": "0.2.0",
+    "@jiawei666/codesk-darwin-x64": "0.2.0",
+    "@jiawei666/codesk-linux-arm64": "0.2.0",
+    "@jiawei666/codesk-linux-x64": "0.2.0",
+    "@jiawei666/codesk-win32-x64": "0.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "check:release": "node scripts/check-release-version.mjs",
+    "pack:check": "npm pack --dry-run"
+  }
+}