Skip to content

docs(readme): clarify claude and codex plugin installs#57

Merged
duyet merged 1 commit into
masterfrom
codex/readme-claude-codex-installs
Apr 24, 2026
Merged

docs(readme): clarify claude and codex plugin installs#57
duyet merged 1 commit into
masterfrom
codex/readme-claude-codex-installs

Conversation

@duyet

@duyet duyet commented Apr 24, 2026

Copy link
Copy Markdown
Owner

Summary

  • rename the README framing to Claude/Codex Plugins
  • split quick install instructions for Claude Code and Codex
  • document the Codex marketplace file and workflow-skill wrappers

Test Plan

  • not run; docs-only change

Summary by Sourcery

Clarify documentation for installing and using the shared Claude/Codex plugin collection.

Documentation:

  • Retitle and reframe the README to emphasize a shared Claude/Codex plugin collection and expanded plugin capabilities.
  • Split quick install instructions into separate sections for Claude Code and Codex, detailing Codex marketplace file usage and workflow-skill wrappers.

Summary by CodeRabbit

  • Documentation
    • Repositioned project as a shared collection of Claude Code and Codex plugins with expanded feature descriptions
    • Enhanced installation guide with dedicated setup workflows for Claude Code and Codex platforms
    • Added documentation for additional utility categories and prompt-engineering resources

Rename the README framing to Claude/Codex Plugins and split quick install guidance between Claude Code and Codex.
@sourcery-ai

sourcery-ai Bot commented Apr 24, 2026

Copy link
Copy Markdown

Reviewer's Guide

Updates the README to clarify that the repository provides a shared plugin collection for both Claude Code and Codex, and splits/expands installation instructions with explicit steps for each, including Codex marketplace file usage and workflow-skill wrappers.

Flow diagram for Codex plugin installation via local marketplace file

flowchart TD
  A[Start] --> B[Clone duyet/claude-plugins repository]
  B --> C[Change directory to claude-plugins]
  C --> D[Locate Codex marketplace file at .agents/plugins/marketplace.json]
  D --> E[In Codex, add or import local marketplace.json]
  E --> F[Duyet Claude and Codex Plugins marketplace appears in Codex]
  F --> G[Browse available plugins and workflow skills]
  G --> H[Install selected plugins from marketplace]
  H --> I[Use installed plugins and skills in Codex]
  I --> J[End]
Loading

File-Level Changes

Change Details Files
Clarified project framing and description as a shared Claude/Codex plugin collection.
  • Updated main README title to reference both Claude and Codex plugins.
  • Refined the introductory tagline to emphasize one shared plugin collection for Claude Code and Codex.
  • Expanded the description of included capabilities to mention statusline utilities and prompt engineering guidance in addition to existing features.
README.md
Split and expanded quick installation instructions for Claude Code and Codex, documenting Codex marketplace usage and workflow skills.
  • Added a dedicated Claude Code install subsection that retains and labels the existing marketplace-based installation commands.
  • Introduced a separate Codex subsection explaining cloning the repo, locating the local Codex marketplace JSON file, and adding it in Codex.
  • Documented how the Codex marketplace file maps plugin entries to local directories with an example JSON snippet.
  • Clarified that, after importing the marketplace, plugins are installed from the named marketplace and that Codex-facing workflow skills reside in each plugin's skills/ folder, including wrappers for command-heavy plugins.
README.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Apr 24, 2026
@coderabbitai

coderabbitai Bot commented Apr 24, 2026

Copy link
Copy Markdown

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 61b26f83-4539-477e-a4d5-1e794d67f6f9

📥 Commits

Reviewing files that changed from the base of the PR and between 697e0d6 and 73f47b4.

📒 Files selected for processing (1)
  • README.md

📝 Walkthrough

Walkthrough

The README was updated to explicitly position the project as a combined Claude Code and Codex plugin collection. The update includes expanded feature descriptions and separate installation workflows for Claude Code (using plugin marketplace CLI) and Codex (with local marketplace configuration and source mapping details).

Changes

Cohort / File(s) Summary
Documentation
README.md
Updated project title and description to reflect shared Claude Code + Codex plugin collection; added feature categories (statusline utilities, prompt engineering); expanded "Quick Install" with separate installation instructions for Claude Code and Codex workflows, including marketplace CLI usage, repo-local Codex marketplace paths, local source mapping examples, and reference to plugin skills/ directory structure.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Poem

🐰 A README refreshed with clarity bright,
Two plugin homes unified in sight,
Claude Code and Codex, side by side,
With install paths and feature guides,
Our shared collection stands with pride! ✨

🚥 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 accurately and concisely describes the main change: clarifying installation instructions for both Claude and Codex plugins in the 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 codex/readme-claude-codex-installs

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.

@github-actions

Copy link
Copy Markdown

Welcome! 👋

Thank you for your first contribution to this project! We appreciate you taking the time to improve our codebase.

Next Steps

  • A maintainer will review your PR shortly
  • Please check for any review comments and address them
  • Feel free to ask questions if anything is unclear

Contribution Guidelines

  • Ensure all tests pass
  • Update documentation if needed
  • Keep changes focused and atomic

Thanks again for contributing! 🎉

@sourcery-ai sourcery-ai 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.

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@duyet duyet merged commit 6234bca into master Apr 24, 2026
2 of 3 checks passed
@duyet duyet deleted the codex/readme-claude-codex-installs branch April 24, 2026 12:13
@duyet duyet restored the codex/readme-claude-codex-installs branch April 24, 2026 12:13

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the README to include documentation and installation instructions for Codex, expanding the project's scope beyond Claude Code. It introduces a dedicated Codex section explaining how to use the local marketplace file and provides a JSON configuration example. A review comment correctly identified that the provided JSON example was missing mandatory 'category' and 'policy' fields required by the repository's validation scripts.

Comment thread README.md
Comment on lines +57 to +63
{
"name": "github",
"source": {
"source": "local",
"path": "./github"
}
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

The example JSON for the Codex marketplace entry is missing the policy and category fields. According to the repository's validation script (scripts/validate-plugins.sh), these fields are required for all plugins in the Codex marketplace manifest. Adding them ensures the documentation provides a valid and complete example for users.

Suggested change
{
"name": "github",
"source": {
"source": "local",
"path": "./github"
}
}
{
"name": "github",
"source": {
"source": "local",
"path": "./github"
},
"category": "Git",
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_USE"
}
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant