Skip to content

docs: add Codex install notes to plugin README#70

Merged
yyiilluu merged 1 commit into
mainfrom
docs/plugin-codex-install-20260608
Jun 8, 2026
Merged

docs: add Codex install notes to plugin README#70
yyiilluu merged 1 commit into
mainfrom
docs/plugin-codex-install-20260608

Conversation

@yyiilluu

@yyiilluu yyiilluu commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add explicit Codex install and uninstall instructions to the published plugin README.
  • Split install/uninstall docs into Claude Code and Codex subsections for faster scanning.
  • Note that Codex and Claude Code reuse the same local Preferences, Project-specific skills, and Shared skills.

Test Plan / Validation

  • git diff --check
  • Manual read-through of plugin/README.md

Marketing rationale

Codex support is a meaningful discovery and conversion hook for developers comparing local agent memory tools. The PyPI/plugin README is a public-facing package surface, so making Codex installation obvious reduces friction without changing product claims.

Summary by CodeRabbit

  • Documentation
    • Enhanced setup and uninstall instructions with explicit host-specific guidance for Claude Code and Codex integration.
    • Added detailed steps for configuring the plugin across different hosts and properly reloading changes.
    • Expanded notes on local data locations to help users understand the full cleanup process during uninstallation.

@coderabbitai

coderabbitai Bot commented Jun 8, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The plugin README is updated to provide explicit, host-aware setup instructions. Claude Code installation steps are now under a dedicated subsection header. Codex installation and uninstallation workflows are newly documented, including the --host codex command-line flag and guidance to quit and reopen the application so hooks reload. Cleanup notes now mention both local data locations.

Changes

Host-Specific Setup Documentation

Layer / File(s) Summary
Install instructions for Claude Code and Codex
plugin/README.md
Structured install section with separate Claude Code subsection header and new Codex subsection containing the npx claude-smart install --host codex command plus instructions to fully quit and reopen Codex so hooks reload.
Uninstall instructions and cleanup for Codex
plugin/README.md
New Codex subsection under Uninstall with npx claude-smart uninstall --host codex command, restart guidance for Codex, and expanded cleanup notes covering local data in ~/.reflexio/ and ~/.claude-smart/ for both hosts.

Possibly Related PRs

  • ReflexioAI/claude-smart#64: Both PRs modify plugin/README.md to add/clarify Codex support—one updating the intro/summary metadata and the other expanding Codex-specific install/uninstall commands.
  • ReflexioAI/claude-smart#23: The main PR's plugin/README.md Codex install/uninstall instructions (including the npx claude-smart ... --host codex commands and "quit/reopen so hooks reload") directly align with and extend the Codex install/runtime behavior and help/docs introduced in the retrieved PR.
  • ReflexioAI/claude-smart#67: Both PRs are documentation-only updates that clarify the claude-smart install/uninstall and host restart flow needed to reload updated plugin payloads (Codex/Claude Code in plugin/README.md vs the local rebuilt tarball reinstall loop in DEVELOPER.md).

Poem

A rabbit's guide now gleams so bright, ✨
with Codex and Claude Code in sight—
Install and uninstall both ways shown,
hooks reload when fully quit and known,
Two homes for tools, one clear and right! 🐇

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and specifically describes the main change: adding Codex installation notes to the plugin README documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/plugin-codex-install-20260608

Warning

Tools execution failed with the following error:

Failed to run tools: 13 INTERNAL: Received RST_STREAM with code 2 (Internal server error)


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (2)
plugin/README.md (2)

28-36: ⚡ Quick win

Consider aligning restart terminology between hosts.

Line 28 says "restart Claude Code" while line 36 says "fully quit and reopen Codex so hooks reload." If both hosts require a full quit-and-reopen for hooks to reload (rather than just a soft restart), consider using consistent wording. The Codex instruction's explicit mention of hook reloading is helpful context that could benefit Claude Code users as well.

📝 Optional consistency improvement
-Then restart Claude Code.
+Then fully quit and reopen Claude Code so hooks reload.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugin/README.md` around lines 28 - 36, The README uses inconsistent restart
terminology between "restart Claude Code" and "fully quit and reopen Codex so
hooks reload"; update the Claude Code section (the sentence referencing "restart
Claude Code") to mirror the Codex wording and explicitly state "fully quit and
reopen" and mention hooks reload so both host instructions (Claude Code and the
Codex command shown as `npx claude-smart install --host codex`) use the same
clear guidance about requiring a full quit-and-reopen for hooks to take effect.

43-51: ⚡ Quick win

Consider adding restart instruction after Claude Code uninstall.

The Codex uninstall section (line 59) instructs users to "Restart Codex after uninstalling," but the Claude Code uninstall section has no equivalent restart instruction. If Claude Code also requires a restart to fully unload hooks, this guidance should be added for symmetry and user clarity.

📝 Proposed addition for consistency
 ```bash
 npx claude-smart uninstall   # or: uvx claude-smart uninstall

+Then restart Claude Code.

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @plugin/README.md around lines 43 - 51, Add a one-line restart instruction to
the Claude Code uninstall section so it matches the Codex guidance: after the
existing uninstall commands (the "claude plugin uninstall
claude-smart@reflexioai" and the "npx claude-smart uninstall" / "uvx
claude-smart uninstall" variants) append a short sentence telling the user to
restart Claude Code to fully unload the plugin/hooks.


</details>

<!-- cr-comment:v1:47e5a8a3c6712851e4355f38 -->

</blockquote></details>

</blockquote></details>

<details>
<summary>🤖 Prompt for all review comments with AI agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In @plugin/README.md:

  • Around line 28-36: The README uses inconsistent restart terminology between
    "restart Claude Code" and "fully quit and reopen Codex so hooks reload"; update
    the Claude Code section (the sentence referencing "restart Claude Code") to
    mirror the Codex wording and explicitly state "fully quit and reopen" and
    mention hooks reload so both host instructions (Claude Code and the Codex
    command shown as npx claude-smart install --host codex) use the same clear
    guidance about requiring a full quit-and-reopen for hooks to take effect.
  • Around line 43-51: Add a one-line restart instruction to the Claude Code
    uninstall section so it matches the Codex guidance: after the existing uninstall
    commands (the "claude plugin uninstall claude-smart@reflexioai" and the "npx
    claude-smart uninstall" / "uvx claude-smart uninstall" variants) append a short
    sentence telling the user to restart Claude Code to fully unload the
    plugin/hooks.

</details>

---

<details>
<summary>ℹ️ Review info</summary>

<details>
<summary>⚙️ Run configuration</summary>

**Configuration used**: defaults

**Review profile**: CHILL

**Plan**: Pro Plus

**Run ID**: `6d4cb5b4-84af-4c20-9f5d-0291f4fcc5b5`

</details>

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between cefa8010d852cc3ad4b41793ab3e9b06f0d7a60e and c077f05ce149f6bb9adc8c1bf5706a83dd06613b.

</details>

<details>
<summary>📒 Files selected for processing (1)</summary>

* `plugin/README.md`

</details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

@yyiilluu yyiilluu merged commit 4a04568 into main Jun 8, 2026
7 checks passed
@yilu331 yilu331 deleted the docs/plugin-codex-install-20260608 branch June 12, 2026 07:11
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