@iamdevlinph/codex-kit 1.0.1 → 1.0.3

package/README.md

@@ -12,13 +12,18 @@ Codex model configuration; configuration is a separate, explicit command.
 
 ## Install on a device
 
-No npm or GitHub login is required:
+No npm or GitHub login is required. For regular use, install the CLI globally:
 
 ```sh
-pnpm dlx @iamdevlinph/codex-kit@latest global install
-pnpm dlx @iamdevlinph/codex-kit@latest global configure
+pnpm add --global @iamdevlinph/codex-kit@latest
+codex-kit global install
+codex-kit global configure
 ```
 
+`npm install --global @iamdevlinph/codex-kit@latest` works as an alternative.
+For one-off use without a global installation, prefix a command with
+`pnpm dlx @iamdevlinph/codex-kit@latest`.
+
 `global install` copies reusable agents to `${CODEX_HOME:-~/.codex}` and
 maintains a marked routing section in the global `AGENTS.md`.
 
@@ -27,8 +32,13 @@ maintains a marked routing section in the global `AGENTS.md`.
 ```toml
 model = "gpt-5.6-sol"
 model_reasoning_effort = "high"
+plan_mode_reasoning_effort = "high"
 ```
 
+Before changing these keys, codex-kit creates a timestamped `config.toml`
+backup and records their previous values. `global uninstall` restores those
+values without replacing unrelated configuration changed afterward.
+
 Use a different Codex home when needed:
 
 ```sh
@@ -44,8 +54,9 @@ Inspect the installed setup:
 pnpm dlx @iamdevlinph/codex-kit@latest global list
 ```
 
-The summary shows the Codex home, orchestrator, reasoning effort, routing
-status, and installed custom agents without dumping unrelated configuration.
+The summary shows the Codex home, orchestrator, normal and Plan-mode reasoning
+effort, routing status, and installed custom agents without dumping unrelated
+configuration.
 
 Uninstall package-managed global files:
 
@@ -60,6 +71,8 @@ unmanaged `commit-pusher.toml` is reported but never silently deleted.
 
 | Action | Command |
 | --- | --- |
+| Show command help | `codex-kit --help` |
+| Print the installed version | `codex-kit --version` |
 | Install global agents and routing | `codex-kit global install` |
 | Configure the orchestrator | `codex-kit global configure` |
 | Inspect global configuration | `codex-kit global list` |

package/bin/codex-kit.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { createHash } from "node:crypto";
 import { spawnSync } from "node:child_process";
 import { homedir } from "node:os";
@@ -71,7 +71,7 @@ function topLevelConfigEntries(contents) {
         }
         if (inTable)
             continue;
-        const match = /^(\s*)(model|model_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
+        const match = /^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
         const key = match?.[2];
         const value = match?.[3];
         if (key && value !== undefined && !entries.has(key))
@@ -97,7 +97,7 @@ function setTopLevelConfig(contents, desired) {
         const line = lines[index];
         if (line === undefined)
             continue;
-        const match = /^(\s*)(model|model_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
+        const match = /^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
         const key = match?.[2];
         if (!match || !key || seen.has(key))
             continue;
@@ -128,7 +128,7 @@ function restoreTopLevelConfig(contents, config) {
         const line = lines[index];
         if (line === undefined)
             continue;
-        const match = /^(\s*)(model|model_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
+        const match = /^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
         const key = match?.[2];
         if (!match || !key || restored.has(key))
             continue;
@@ -286,6 +286,7 @@ function configureGlobal(options) {
     const desired = {
         model: options.orchestrator,
         model_reasoning_effort: options.reasoningEffort,
+        plan_mode_reasoning_effort: options.reasoningEffort,
     };
     const priorState = loadState(home);
     const original = existsSync(configFile) ? readText(configFile) : "";
@@ -327,6 +328,7 @@ function configureGlobal(options) {
     saveState(home, priorState);
     console.log(`Orchestrator: ${desired.model}`);
     console.log(`Reasoning effort: ${desired.model_reasoning_effort}`);
+    console.log(`Plan mode reasoning effort: ${desired.plan_mode_reasoning_effort}`);
 }
 function listGlobal(options) {
     const home = options.codexHome;
@@ -353,6 +355,7 @@ function listGlobal(options) {
     console.log(`Config: ${configFile}${existsSync(configFile) ? "" : " (missing)"}`);
     console.log(`Orchestrator: ${value("model")}`);
     console.log(`Reasoning effort: ${value("model_reasoning_effort")}`);
+    console.log(`Plan mode reasoning effort: ${value("plan_mode_reasoning_effort")}`);
     console.log(`Kit state: ${existsSync(stateFile) ? state.version : "not installed"}`);
     const hasRoutingBlock = existsSync(globalAgents) && readText(globalAgents).includes(GLOBAL_BEGIN);
     console.log(`Global routing: ${hasRoutingBlock ? "installed" : "not installed"}`);
@@ -653,10 +656,11 @@ Usage:
   codex-kit project status [--cwd PATH]
   codex-kit project mark-applied [--cwd PATH]
   codex-kit version check
+  codex-kit --help
   codex-kit --version
 
-Global configure defaults to gpt-5.6-sol with high reasoning and edits only
-the top-level model settings in CODEX_HOME/config.toml.
+Global configure defaults to gpt-5.6-sol with high normal and Plan-mode reasoning
+and edits only those top-level model settings in CODEX_HOME/config.toml.
 Global install manages custom agents and a marked routing block under CODEX_HOME.
 Project sync refreshes TEMPLATE_AGENTS.md and never merges it into AGENTS.md.`);
 }
@@ -685,7 +689,8 @@ export function main(argv = process.argv.slice(2)) {
         return checkVersion();
     throw new Error(`Unknown command: ${options.positionals.join(" ")}`);
 }
-if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+if (process.argv[1] &&
+    realpathSync(resolve(process.argv[1])) === realpathSync(fileURLToPath(import.meta.url))) {
     try {
         main();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamdevlinph/codex-kit",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Portable Codex subagents and project AGENTS.md defaults.",
   "type": "module",
   "bin": {