docs: Refocus README description on MCP proxy pattern #29
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Revised opening description to emphasize the general MCP proxy
architecture rather than Codex-specific features:
- Lead with MCP proxy pattern (filter tools, preset parameters)
- Highlight tool specialization capability (e.g., planning_assistant)
- De-emphasize Git workflows (just example tools, not core feature)
- Remove Codex-centric framing ("turns Codex into...")
- More concise (43 vs 53 words, -18%)
The new description better reflects the actual architecture: a proxy
that can work with any MCP server, creating specialized assistants
from generic tools via configuration.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add "customizable" to emphasize config-driven nature - Use "MCP proxy server" without expanding acronym (target audience knows MCP) - More concise: 39 words vs 43 (-9%) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Revised the opening README description to better reflect Hoopoe's actual architecture as a general MCP proxy pattern rather than a Codex-specific wrapper.
Changes
planning_assistantfrom generic Codex toolRationale
The previous description over-emphasized Codex and Git features, obscuring the core value: a proxy that filters/specializes any MCP server's tools. The config.yaml shows this pattern clearly:
This is tool specialization via configuration filtering—the actual innovation here.
Test Plan
🤖 Generated with Claude Code