feat: manage Codex config and localize usage resets

[ygpark80]

Changes

• Add prism codex enable, disable, and status to switch the shared Codex App and CLI configuration between Prism and the previous provider settings.
• Select gpt-5.6-sol, use its default reasoning effort, preserve unrelated Codex configuration, retain symlinked config files, and refuse to overwrite managed settings after drift.
• Show ChatGPT usage reset timestamps in the local timezone with friendly remaining time such as in 16h 13m.
• Keep prism claude as a Claude Code CLI launcher and simplify the README guidance accordingly.

Testing

• go test -mod=vendor -race ./...
• go vet -mod=vendor ./...
• test -z "$(gofmt -l .)"
• GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -mod=vendor -trimpath ...
• Built the CLI, enabled Prism in an isolated CODEX_HOME, confirmed codex features list accepted the generated configuration, then disabled Prism and confirmed direct status.
• Ran go run -mod=vendor . chatgpt usage and confirmed local KST reset timestamps and friendly remaining durations against live usage data.
• git diff --check

Notes

• Configuration changes apply to newly opened Codex tasks.
• disable restores only managed values that still match what enable applied; otherwise status reports drift.

Summary by CodeRabbit

• New Features

  • Added Codex CLI integration with enable, disable, and status commands.
  • Codex configuration changes preserve unrelated settings and detect unexpected modifications.
  • Usage reset times now display in local time with readable remaining or elapsed durations.

• Documentation

  • Simplified Codex setup instructions and documented configuration behavior.
  • Clarified that Claude Code launches the installed CLI and forwards arguments unchanged.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: fd41cb56-346f-4d98-ad99-569fceb60973

📥 Commits

Reviewing files that changed from the base of the PR and between ed121e7 and 51e1713.

📒 Files selected for processing (5)

• README.md
• internal/cli/codex.go
• internal/cli/codex_test.go
• internal/cli/run.go
• internal/cli/run_test.go

---

📝 Walkthrough

Walkthrough

The CLI adds prism codex enable, disable, and status. It manages Codex TOML configuration and JSON state, detects drift, preserves unrelated settings, and supports symlinks. Usage resets now show local time and relative duration. Documentation and tests cover the new behavior.

Changes

Codex CLI integration

Layer / File(s)	Summary
CLI command and usage surface internal/cli/run.go, internal/cli/run_test.go, internal/cli/codex.go	The CLI dispatches Codex subcommands, updates help text, and formats usage reset times in the local timezone with relative durations.
Codex configuration and document engine internal/cli/codex.go	The implementation defines managed Codex values and state, resolves configuration paths, parses TOML, preserves file details, and performs atomic updates.
Codex lifecycle and validation internal/cli/codex.go, internal/cli/codex_test.go, README.md	Enable, disable, and status manage Prism settings, restore saved values, detect drift, classify configuration states, and preserve unrelated changes. Tests and documentation cover the command behavior.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant CLI
  participant CodexConfiguration
  participant ConfigFiles
  User->>CLI: prism codex enable|disable|status
  CLI->>CodexConfiguration: dispatch subcommand
  CodexConfiguration->>ConfigFiles: read TOML and JSON state
  CodexConfiguration->>ConfigFiles: update or restore configuration
  CodexConfiguration-->>User: return status or operation result

Loading

Possibly related PRs

• circlesac/prism-cli#7: Both changes modify CLI dispatch and help handling in internal/cli/run.go.
• circlesac/prism-cli#8: Both changes modify usage display and reset-time formatting.
• circlesac/prism-cli#9: Both changes cover prism codex setup and command documentation.

Suggested labels: size:L

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/codex-config-toggle

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}