Merge remote-tracking branch 'origin/split/pr59-wrapper-docs' into release/all-open-v0.1.8

# Conflicts:
#	test/documentation.test.ts

Author: ndycode

docs/reference/commands.md

@@ -55,6 +55,14 @@ Compatibility aliases are supported:
 
 ---
 
+## Compatibility and Non-TTY Behavior
+
+- `codex` remains the primary wrapper entrypoint. It routes `codex auth ...` and the compatibility aliases to the multi-auth runtime, and forwards every other command to the official `@openai/codex` CLI.
+- In non-TTY or host-managed sessions, including `CODEX_TUI=1`, `CODEX_DESKTOP=1`, `TERM_PROGRAM=codex`, or `ELECTRON_RUN_AS_NODE=1`, auth flows degrade to deterministic text behavior.
+- The non-TTY fallback keeps `codex auth login` predictable: it defaults to add-account mode, skips the extra "add another account" prompt, and auto-picks the default workspace selection when a follow-up choice is needed.
+
+---
+
 ## Dashboard Hotkeys
 
 ### Main Dashboard
@@ -80,15 +88,13 @@ Compatibility aliases are supported:
 
 ### Settings Screens
 
-| Key | Action |
-| --- | --- |
-| `Enter` | Toggle/select/open |
-| `1-9` | Quick toggle for numbered options |
-| `S` | Save |
-| `R` | Reset |
-| `Q` | Back/cancel without saving draft changes |
-| `[` / `]` | Reorder fields in summary settings |
-| `+` / `-` | Adjust focused numeric backend setting |
+Settings screen hotkeys are panel-specific:
+
+- Account List View: `Enter Toggle | Number Toggle | M Sort | L Layout | S Save | Q Back (No Save)`
+- Summary Line: `Enter Toggle | 1-3 Toggle | [ ] Reorder | S Save | Q Back (No Save)`
+- Menu Behavior: `Enter Select | 1-3 Delay | P Pause | L AutoFetch | F Status | T TTL | S Save | Q Back (No Save)`
+- Color Theme: `Enter Select | 1-2 Base | S Save | Q Back (No Save)`
+- Backend Controls: `Enter Open | 1-4 Category | S Save | R Reset | Q Back (No Save)`
 
 ---
 

docs/reference/storage-paths.md

@@ -35,6 +35,14 @@ Ownership note:
 
 - `~/.codex/multi-auth/*` is managed by this project.
 - `~/.codex/accounts.json` and `~/.codex/auth.json` are managed by official Codex CLI.
+- The `codex` wrapper preserves that official CLI file-backed auth layout by forwarding non-auth commands with `-c cli_auth_credentials_store="file"`, unless the caller already set `cli_auth_credentials_store` explicitly.
+- Set `CODEX_MULTI_AUTH_FORCE_FILE_AUTH_STORE=0` to opt out of that wrapper-injected file-store override and leave the downstream CLI auth store untouched.
+
+Compatibility note:
+
+- This file-store forwarding keeps auth state readable from disk outside interactive terminals, so wrapper forwarding and non-TTY auth flows stay deterministic after the Ink migration.
+
+> **Windows note:** The wrapper keeps the official Codex CLI file-store layout unchanged, so Windows `EPERM`/`EBUSY` retry handling still lives with the downstream CLI writes rather than this wrapper layer. Opting out with `CODEX_MULTI_AUTH_FORCE_FILE_AUTH_STORE=0` stops injecting the file-store override for future wrapper launches, but it does not rewrite or expose previously written CLI auth files beyond the standard `~/.codex/auth.json` and `~/.codex/accounts.json` locations.
 
 ---
 
@@ -72,6 +80,33 @@ Examples:
 
 ---
 
+## Named Backup Exports
+
+Experimental named backup exports are written under the local plugin-owned backup namespace beside the active accounts file:
+
+- global root: `~/.codex/multi-auth/backups/<name>.json`
+- project root: `~/.codex/multi-auth/projects/<project-key>/backups/<name>.json`
+
+Rules:
+
+- `.json` is appended when omitted
+- backup names may only contain letters, numbers, `_`, and `-`
+- path separators and `..` are rejected
+- `.rotate.`, `.tmp`, and `.wal` names are rejected
+- existing files are not overwritten unless a lower-level force path is used explicitly
+
+---
+
+## oc-chatgpt Target Paths
+
+Experimental sync targets the companion `oc-chatgpt-multi-auth` storage layout:
+
+- global target: `~/.opencode/openai-codex-accounts.json`
+- project target: `~/.opencode/projects/<project-key>/openai-codex-accounts.json`
+- target backups: `~/.opencode/backups/` or project-local `backups/` beside the target account file
+
+---
+
 ## Verification Commands
 
 ```bash