@bryanhu/codexly 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# 更新日志
+
+本文件记录 Codexly 的重要版本变化。版本号遵循 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)。
+
+## [Unreleased]
+
+## [0.1.0] - 2026-08-24
+
+### 新增
+
+- 添加 Codex 官方账号快速模式、细粒度审批策略和通知偏好，并让新任务继承项目最近一次完整设置。
+- 支持有序的多根项目与根目录切换，接入 Codex 原生模糊文件搜索和 Git 元数据监听，按当前根精确刷新文件与仓库状态。
+- 接入 Codex 持久化线程队列和 MCP 补充输入请求，支持跟进消息跨重启交付，并完善 Goal、异步 Hook、多 Agent 与模型切换状态同步。
+- 添加项目归档任务管理，支持恢复、单项永久删除和批量清空全部归档任务。
+- 支持直接添加经过验证的宿主绝对目录，并保留多根项目的目录树选择流程。
+
+### 优化
+
+- 确立 Codex `projectId` 为项目身份真相源，统一多根 Project Runtime、任务作用域和临时任务生命周期。
+- 为任务历史添加游标分页与活动任务并发恢复，缓存 Codex 原生状态读取，并优化事件批次、JSONL 分片和长会话资源释放。
+- 聚合连续工具与命令操作摘要，持久化临时任务分组状态，并整合中英文用户文档与维护者文档。
+- 统一 Codexly 品牌标识、终端提示符和浏览器图标资产。
+
+### 修复
+
+- 修复文件搜索查询调度、Reviewer 与跨 Turn 历史分页，以及自定义 Provider 配置切换和登录失败回滚。
+- 修复 Project Runtime 并发释放、任务退订、未物化任务归属、新增项目任务列表状态及多根目录选择控件。
+- 修复未发布首版本的更新判断、历史 Turn 分页 Item 水合，以及超限 Git Diff 阻断状态读取的问题。
+
+### 工程
+
+- 升级内置 Codex 至 `0.149.0`，刷新真实 App Server Schema 基线，并对齐原生 Project 归属、异步消息投递和严格审核通知。
+- 动态映射自定义 Provider 的模型思考量元数据，支持 `max`、`ultra` 和 Provider 自定义档位，并校验当前 Provider 运行时能力。
+- 拆分全栈测试套件并限制 Vitest 并发，提升跨平台门禁稳定性；GitHub Release 改为严格提取对应版本的完整更新日志。
+- 将最低 Node.js 版本调整为 `22.14.0`，同步 CLI、CI、发布环境和使用文档。
+
+[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codexly contributors
+
+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,87 @@
+# Codexly
+
+English | [简体中文](README.zh-CN.md)
+
+Codexly is a local AI coding workspace for using Codex in a browser. It organizes work by project, streams Codex activity, and provides file, code review, and Git tools while the host computer remains the source of its project filesystem.
+
+## Features
+
+- Run project or temporary Codex tasks and follow responses, commands, and file changes in real time
+- Attach files and images, reference project files with `@`, and answer input requests from configured MCP servers
+- Choose the model, reasoning effort, Fast mode, approval behavior, and file access level for each task
+- Organize ordered multi-root projects, archive completed tasks, and permanently delete tasks when needed
+- Inspect files and diffs, review code, manage branches and worktrees, and commit or push changes
+- Fork a task from an AI response and continue it in a new Git worktree
+- Access the workspace from another device on a trusted local network
+
+## Requirements
+
+- Node.js >=22.14.0
+- Chrome/Chromium 116+, Firefox 124+, or Safari 17.4+
+
+Codexly includes a supported Codex CLI through `@openai/codex`; a separate installation is not required. Use `--codex-bin <path>` or `CODEXLY_CODEX_BIN` only when you need another executable.
+
+## Quick Start
+
+Run the latest version without installing it:
+
+```bash
+npx --package @bryanhu/codexly@latest codexly start
+```
+
+Codexly opens the browser automatically. If it does not, use the address printed in the terminal; the default is `http://127.0.0.1:3210`. Keep the terminal running and press `Ctrl+C` to stop.
+
+On first launch, sign in with ChatGPT or configure an OpenAI-compatible service that supports the Responses API and `GET /models`.
+
+For regular use, install Codexly globally:
+
+```bash
+npm install --global @bryanhu/codexly
+codexly start
+```
+
+## Usage
+
+Select **New task** for work that does not need a project. For repository work, add one or more host directories as ordered project roots, create a task, and submit your request with any required files, images, project references, or Skills. Archived tasks can be restored or permanently deleted from the project task list.
+
+Task controls set the model, reasoning, Fast mode, approval, and file access behavior. Notification preferences and the last complete project settings are saved for later tasks. The right inspector provides project files, sources, code changes, Git history, review, and commit actions. Project directories and files always come from the computer running Codexly, including when the UI is opened on another device.
+
+## Local Network Access
+
+Start trusted LAN access with:
+
+```bash
+codexly start --lan
+```
+
+The terminal prints the LAN address and a random access password. Common options are:
+
+| Option                      | Purpose                                                                                    |
+| --------------------------- | ------------------------------------------------------------------------------------------ |
+| `--port <port>`             | Choose the starting port; occupied ports are skipped automatically                         |
+| `--lan-password <password>` | Set a 16-128 character password containing uppercase, lowercase, number, and symbol        |
+| `--allowed-host <domain>`   | Allow an exact reverse proxy domain; repeat the option for multiple domains                |
+| `--session-ttl <duration>`  | Set a fixed LAN session lifetime such as `12h`; omitted sessions last until server restart |
+
+Quote passwords containing shell-special characters. LAN mode uses unencrypted HTTP, so use it only on a trusted network and never expose it directly to the internet. Restarting Codexly invalidates the password and all sessions.
+
+## Diagnostics and Updates
+
+Run `codexly doctor` when startup, Codex, or local data checks fail. Run `codexly --help` for the current command and option reference.
+
+Interactive startup and **Settings > About** check for new releases. A global installation can also be updated with:
+
+```bash
+npm install --global @bryanhu/codexly@latest
+```
+
+## Help
+
+- [Report an issue](https://github.com/BryanHoo/Codexly/issues)
+- [Contributing guide](CONTRIBUTING.md)
+- [Security policy](SECURITY.md)
+- [Changelog](CHANGELOG.md)
+
+## License
+
+[MIT](LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,87 @@
+# Codexly
+
+[English](README.md) | 简体中文
+
+Codexly 是一个在浏览器中使用 Codex 的本地 AI 编程工作台。它按项目组织任务，实时展示 Codex 的执行过程，并提供文件、代码审查和 Git 工具；项目文件系统始终由运行端电脑提供。
+
+## 主要功能
+
+- 运行项目任务或临时任务，实时查看回复、命令和文件变更
+- 添加文件与图片、使用 `@` 引用项目文件，并回答已配置 MCP 服务的补充输入请求
+- 为每个任务选择模型、思考量、快速模式、审批方式和文件访问范围
+- 组织有序的多根项目、归档已完成任务，并按需永久删除任务
+- 查看文件与差异、审查代码、管理分支与 worktree，并提交或推送变更
+- 从 AI 回复处分叉任务，在新的 Git worktree 中继续工作
+- 从可信局域网中的其他设备访问工作台
+
+## 环境要求
+
+- Node.js >=22.14.0
+- Chrome/Chromium 116+、Firefox 124+ 或 Safari 17.4+
+
+Codexly 通过 `@openai/codex` 自带受支持的 Codex CLI，无需单独安装。仅在需要使用其他可执行文件时传入 `--codex-bin <path>` 或设置 `CODEXLY_CODEX_BIN`。
+
+## 快速开始
+
+无需安装，直接运行最新版本：
+
+```bash
+npx --package @bryanhu/codexly@latest codexly start
+```
+
+Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址；默认地址为 `http://127.0.0.1:3210`。使用期间需保持终端运行，按 `Ctrl+C` 停止。
+
+首次启动时，使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务。
+
+经常使用时可以全局安装：
+
+```bash
+npm install --global @bryanhu/codexly
+codexly start
+```
+
+## 使用方式
+
+不依赖项目时，直接选择“新建任务”。处理仓库时，先添加一个或多个运行端目录作为有序的项目根，再创建任务，并按需附加文件、图片、项目引用或 Skills 后提交需求。归档的任务可以从项目任务列表中恢复或永久删除。
+
+任务控件用于设置模型、思考量、快速模式、审批方式和文件访问范围。通知偏好与项目最近一次完整设置会保存给后续任务。右侧检查器提供项目文件、来源、代码变更、Git 历史、审查和提交操作。即使从其他设备打开界面，项目目录和文件仍来自运行 Codexly 的电脑。
+
+## 局域网访问
+
+在可信局域网中启动：
+
+```bash
+codexly start --lan
+```
+
+终端会输出局域网地址和随机访问密码。常用选项如下：
+
+| 选项                        | 用途                                                  |
+| --------------------------- | ----------------------------------------------------- |
+| `--port <port>`             | 指定起始端口；端口被占用时自动尝试后续端口            |
+| `--lan-password <password>` | 设置 16 至 128 位密码，必须包含大小写字母、数字和符号 |
+| `--allowed-host <domain>`   | 允许精确的反向代理域名；多个域名可重复传入            |
+| `--session-ttl <duration>`  | 设置固定会话期限，如 `12h`；省略时持续到 Server 重启  |
+
+密码含 Shell 特殊字符时请使用引号。局域网模式使用未加密 HTTP，只能用于可信网络，禁止直接暴露到互联网。重启 Codexly 会使密码和全部会话失效。
+
+## 诊断与更新
+
+启动、Codex 或本地数据检查失败时运行 `codexly doctor`。使用 `codexly --help` 查看当前命令和选项。
+
+交互式启动和“设置 > 关于”会检查新版本。全局安装也可以通过以下命令更新：
+
+```bash
+npm install --global @bryanhu/codexly@latest
+```
+
+## 获取帮助
+
+- [问题反馈](https://github.com/BryanHoo/Codexly/issues)
+- [贡献指南](CONTRIBUTING.md)
+- [安全策略](SECURITY.md)
+- [版本记录](CHANGELOG.md)
+
+## 许可证
+
+[MIT](LICENSE)

package/dist/chunk-3OBVX5TN.js

@@ -0,0 +1,15 @@
+import { createRequire } from 'node:module';
+
+createRequire(import.meta.url);
+
+// packages/core/src/agent-provider.ts
+var PendingRequestResolutionError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "PendingRequestResolutionError";
+  }
+  code;
+};
+
+export { PendingRequestResolutionError };