codex-worker 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yigit Konur
+
+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,102 @@
+# codex-worker
+
+`codex-worker` is a daemon-backed CLI for driving the official `codex app-server --listen stdio://` runtime from scripts, local automation, and long-running operator workflows.
+
+It wraps the app-server protocol in a stable shell surface with local state, resumable threads, pending-request handling, and multi-profile failover.
+
+## Requirements
+
+- Node.js 22+
+- `codex` CLI installed and authenticated
+
+## Install
+
+Global install:
+
+```bash
+npm install -g codex-worker
+```
+
+One-off execution:
+
+```bash
+npx codex-worker doctor
+```
+
+From source:
+
+```bash
+npm install
+npm run build
+node dist/src/cli.js --help
+```
+
+## CLI Surface
+
+```text
+codex-worker run <task.md>
+codex-worker send <thread-id> <message.md>
+codex-worker read <thread-id>
+codex-worker logs <thread-id>
+codex-worker thread start|resume|read|list
+codex-worker turn start|steer|interrupt
+codex-worker model list
+codex-worker account read|rate-limits
+codex-worker skills list
+codex-worker app list
+codex-worker request list|read|respond
+codex-worker wait
+codex-worker doctor
+codex-worker daemon start|status|stop
+```
+
+## Common Flows
+
+Start a file-backed task:
+
+```bash
+codex-worker run task.md
+```
+
+Resume a thread with a follow-up prompt:
+
+```bash
+codex-worker send <thread-id> followup.md
+```
+
+Read local thread state and recent transcript/log output:
+
+```bash
+codex-worker read <thread-id>
+codex-worker logs <thread-id>
+```
+
+Handle a pending approval or user-input request:
+
+```bash
+codex-worker request list
+codex-worker request read <request-id>
+codex-worker request respond <request-id> --json '{"decision":"accept"}'
+codex-worker request respond <request-id> --answer "yes"
+```
+
+## State And Environment
+
+- Default state root: `~/.codex-worker`
+- Preferred override: `CODEX_WORKER_STATE_DIR`
+- Backward-compatible fallback override: `CLI_CODEX_WORKER_STATE_DIR`
+- Profile discovery: `CODEX_HOME_DIRS` or `CODEX_HOME`
+- Fleet toggle: `CODEX_ENABLE_FLEET=1`
+
+When fleet mode is enabled, `codex-worker` appends a `[codex-worker:fleet]` suffix to outgoing developer instructions on thread start and resume paths.
+
+## Development
+
+```bash
+npm run build
+npm test
+npm run smoke
+node --import tsx src/cli.ts --help
+```
+
+`npm run smoke` exercises a live local flow against the installed `codex` binary.

package/bin/codex-worker.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const binDir = dirname(fileURLToPath(import.meta.url));
+const entrypointUrl = pathToFileURL(resolve(binDir, '../dist/src/cli.js')).href;
+
+await import(entrypointUrl);

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};