Skip to content

docs(guides): Codex setup guide (CLI, IDE extension, ChatGPT desktop app) - #755

Merged
p-diogo merged 2 commits into
mainfrom
docs/codex-setup-guide
Nov 17, 2026
Merged

p-diogo merged 2 commits into
mainfrom
docs/codex-setup-guide

Conversation

@p-diogo

@p-diogo p-diogo commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

Adds docs/guides/codex-setup.md: TotalReclaw for Codex (CLI, IDE extension and the ChatGPT desktop app), and links it from the README, docs/README.md and the Claude Desktop guide's "Other chat apps" section.

Route: the existing Claude plugin. Codex reads .claude-plugin/marketplace.json as is, so users run:

codex plugin marketplace add graphprotocol/totalreclaw
codex plugin add totalreclaw@totalreclaw

They then restart, pair in the browser, and restart again. ChatGPT desktop users without a codex command use the copy bundled in the app. One optional config block turns off approval prompts for TotalReclaw's tools. An MCP-only fallback (codex mcp add) is included.

Verified on 2026-11-17 (Codex 0.169.0-alpha.11.1 bundled in the ChatGPT app, staging):

  • Install from GitHub: both commands install plugin 3.5.3, with the skill and the MCP server.
  • Full user flow with the public plugin: pairing, remember, recall in a new session, pin, scope, correction, forget, phrase refusal and the write limit all pass.
  • Approval prompts: 0 across 7 sessions with the documented key.
  • Codex installing it itself: given the guide's canonical prompt with no codex on PATH, Codex used the bundled path, installed the plugin from GitHub, and told the user to restart. It did not add the approval block without asking.

Statements we did not verify ourselves are attributed to OpenAI's docs: the shared ~/.codex folder and the desktop app's MCP settings screen. Regular ChatGPT chat is stated as unsupported, because TotalReclaw runs locally and keeps its keys on the device.

Review: an independent model reviewed it. Its findings are fixed in the second commit: a duplicate-TOML-section trap in the MCP-only snippet, and softer wording about ChatGPT chat.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VcqeXnhqFWzV2DAzAC2Qos

p-diogo and others added 2 commits November 17, 2026 13:31
@p-diogo
p-diogo merged commit 5f10014 into main Nov 17, 2026
15 checks passed
@p-diogo
p-diogo deleted the docs/codex-setup-guide branch November 17, 2026 13:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant