Release 4.3.1

Author: Numman Ali

CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project are documented here. Dates use the ISO format (YYYY-MM-DD).
 
+## [4.3.1] - 2026-01-08
+
+**Installer safety release**: JSONC support, safe uninstall, and minimal reasoning clamp.
+
+### Added
+- **JSONC-aware installer**: preserves comments/formatting and prioritizes `opencode.jsonc` over `opencode.json`.
+- **Safe uninstall**: `--uninstall` removes only plugin entries + our model presets; `--all` removes tokens/logs/cache.
+- **Installer tests**: coverage for JSONC parsing, precedence, uninstall safety, and artifact cleanup.
+
+### Changed
+- **Default config path**: installer creates `~/.config/opencode/opencode.jsonc` when no config exists.
+- **Dependency**: `jsonc-parser` added to keep JSONC updates robust and comment-safe.
+
+### Fixed
+- **Minimal reasoning clamp**: `minimal` is now normalized to `low` for GPT‑5.x requests to avoid backend rejection.
+
 ## [4.3.0] - 2026-01-04
 
 **Feature + reliability release**: variants support, one-command installer, and auth/error handling fixes.

README.md

@@ -36,6 +36,11 @@ Legacy OpenCode (v1.0.209 and below):
 npx -y opencode-openai-codex-auth@latest --legacy
 opencode run "write hello world to test.txt" --model=openai/gpt-5.2-medium
 ```
+Uninstall:
+```bash
+npx -y opencode-openai-codex-auth@latest --uninstall
+npx -y opencode-openai-codex-auth@latest --uninstall --all
+```
 ---
 ## 📦 Models
 - **gpt-5.2** (none/low/medium/high/xhigh)

config/README.md

@@ -15,12 +15,12 @@ This directory contains the official opencode configuration files for the OpenAI
 
 **If you have OpenCode v1.0.210 or newer** (check with `opencode --version`):
 ```bash
-cp config/opencode-modern.json ~/.config/opencode/opencode.json
+cp config/opencode-modern.json ~/.config/opencode/opencode.jsonc
 ```
 
 **If you have OpenCode v1.0.209 or older**:
 ```bash
-cp config/opencode-legacy.json ~/.config/opencode/opencode.json
+cp config/opencode-legacy.json ~/.config/opencode/opencode.jsonc
 ```
 
 ### Why two configs?
@@ -59,10 +59,10 @@ Both configs provide:
 2. **Copy the appropriate config** based on your version:
    ```bash
    # For v1.0.210+ (recommended):
-   cp config/opencode-modern.json ~/.config/opencode/opencode.json
+   cp config/opencode-modern.json ~/.config/opencode/opencode.jsonc
 
    # For older versions:
-   cp config/opencode-legacy.json ~/.config/opencode/opencode.json
+   cp config/opencode-legacy.json ~/.config/opencode/opencode.jsonc
    ```
 
 3. **Run opencode**:

docs/configuration.md

@@ -328,7 +328,7 @@ Different agents use different models:
 
 Global config has defaults, project overrides for specific work:
 
-**~/.config/opencode/opencode.json** (global):
+**~/.config/opencode/opencode.jsonc** (global, preferred):
 ```json
 {
   "plugin": ["opencode-openai-codex-auth"],
@@ -413,7 +413,8 @@ CODEX_MODE=1 opencode run "task"  # Temporarily enable
 > **⚠️ REQUIRED:** You MUST use the config that matches your OpenCode version (`opencode-modern.json` or `opencode-legacy.json`). Minimal configs are NOT supported for GPT 5 models and will fail unpredictably. OpenCode's auto-compaction and usage widgets also require the full config's per-model `limit` metadata.
 
 **Your Configs:**
-- `~/.config/opencode/opencode.json` - Global config
+- `~/.config/opencode/opencode.jsonc` - Global config (preferred)
+- `~/.config/opencode/opencode.json` - Global config (fallback)
 - `<project>/.opencode.json` - Project-specific config
 - `~/.opencode/openai-codex-auth-config.json` - Plugin config
 

docs/development/CONFIG_FLOW.md

@@ -18,14 +18,15 @@ OpenCode loads and merges configuration from multiple sources in this order (**l
 
 ### 1. Global Config
 ```
-~/.opencode/config.json
-~/.opencode/opencode.json
-~/.opencode/opencode.jsonc
+~/.config/opencode/opencode.jsonc
+~/.config/opencode/opencode.json
 ```
 
 ### 2. Project Configs (traversed upward from cwd)
 ```
+<project>/.opencode/opencode.jsonc
 <project>/.opencode/opencode.json
+<parent>/.opencode/opencode.jsonc
 <parent>/.opencode/opencode.json
 ... (up to worktree root)
 ```

docs/development/TESTING.md

@@ -446,7 +446,7 @@ DEBUG_CODEX_PLUGIN=1 opencode run "test" --model=openai/gpt-5-codex
 (cd ~ && rm -rf .cache/opencode/node_modules/opencode-openai-codex-auth)
 
 # 2. Use minimal config
-cat > ~/.config/opencode/opencode.json <<'EOF'
+cat > ~/.config/opencode/opencode.jsonc <<'EOF'
 {
   "plugin": ["opencode-openai-codex-auth"],
   "model": "openai/gpt-5-codex"
@@ -470,7 +470,7 @@ DEBUG_CODEX_PLUGIN=1 opencode run "write hello world to test.txt"
 
 ```bash
 # Update config with custom models
-cat > ~/.config/opencode/opencode.json <<'EOF'
+cat > ~/.config/opencode/opencode.jsonc <<'EOF'
 {
   "plugin": ["opencode-openai-codex-auth"],
   "provider": {

docs/getting-started.md

@@ -28,7 +28,7 @@ Works on **Windows, macOS, and Linux**:
 npx -y opencode-openai-codex-auth@latest
 ```
 
-This writes the **global** config at `~/.config/opencode/opencode.json`, backs it up, and clears the OpenCode plugin cache so the latest version installs.
+This writes the **global** config at `~/.config/opencode/opencode.jsonc` (falls back to `.json` if needed), backs it up, and clears the OpenCode plugin cache so the latest version installs.
 
 Need legacy config (OpenCode v1.0.209 and below)?
 
@@ -54,7 +54,7 @@ OpenCode automatically installs plugins - no `npm install` needed!
 - OpenCode features require proper model metadata
 - This configuration has been tested and verified to work
 
-Add this to `~/.config/opencode/opencode.json`:
+Add this to `~/.config/opencode/opencode.jsonc` (or `.json`):
 
 **Tip**: The snippet below is a truncated excerpt. For the complete legacy list, copy `config/opencode-legacy.json`. For the modern variants config (OpenCode v1.0.210+), use `config/opencode-modern.json`.
 
@@ -335,7 +335,7 @@ OpenCode checks multiple config files in order:
 
 1. **Project config**: `./.opencode.json` (current directory)
 2. **Parent configs**: Walks up directory tree
-3. **Global config**: `~/.config/opencode/opencode.json`
+3. **Global config**: `~/.config/opencode/opencode.jsonc` (or `~/.config/opencode/opencode.json`)
 
 **Recommendation**: Use global config for plugin, project config for model/agent overrides.
 
@@ -355,6 +355,13 @@ Legacy OpenCode (v1.0.209 and below):
 npx -y opencode-openai-codex-auth@latest --legacy
 ```
 
+## Uninstall
+
+```bash
+npx -y opencode-openai-codex-auth@latest --uninstall
+npx -y opencode-openai-codex-auth@latest --uninstall --all
+```
+
 **When to update:**
 - New features released
 - Bug fixes available

docs/index.md

@@ -55,7 +55,7 @@ npx -y opencode-openai-codex-auth@latest --legacy
 Then run OpenCode and authenticate:
 
 ```bash
-# 1. Add plugin to ~/.config/opencode/opencode.json
+# 1. Add plugin to ~/.config/opencode/opencode.jsonc (or .json)
 # 2. Run OpenCode
 opencode
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-openai-codex-auth",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "description": "OpenAI ChatGPT (Codex backend) OAuth auth plugin for opencode - use your ChatGPT Plus/Pro subscription instead of API credits",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -62,7 +62,8 @@
   },
   "dependencies": {
     "@openauthjs/openauth": "^0.4.3",
-    "hono": "^4.10.4"
+    "hono": "^4.10.4",
+    "jsonc-parser": "^3.3.1"
   },
   "overrides": {
     "hono": "^4.10.4",