Skip to content

Add rule-porter to Utilities#181

Open
nedcodes-ok wants to merge 1 commit intoPatrickJS:mainfrom
nedcodes-ok:add-rule-porter
Open

Add rule-porter to Utilities#181
nedcodes-ok wants to merge 1 commit intoPatrickJS:mainfrom
nedcodes-ok:add-rule-porter

Conversation

@nedcodes-ok
Copy link

@nedcodes-ok nedcodes-ok commented Feb 27, 2026

Adds rule-porter to the Utilities section.

rule-porter is a zero-dependency CLI that converts Cursor .mdc rules to AGENTS.md, CLAUDE.md, Copilot, and Windsurf formats — and back. It handles edge cases like broken frontmatter and non-English content, and warns about lossy conversions (glob patterns, alwaysApply flags) that don't have equivalents in flat markdown formats.

npx rule-porter --to agents-md
npx rule-porter --from agents-md --to cursor

Published on npm: https://www.npmjs.com/package/rule-porter

Summary by CodeRabbit

  • Documentation
    • Updated README with new information about the rule-porter utility under the Utilities section.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 27, 2026

📝 Walkthrough

Walkthrough

Two new bullet entries introducing rule-porter are added to the Utilities section of README.md. The entries describe rule-porter's functionality and usage, with identical content in both bullets. This is a documentation-only change with no code modifications.

Changes

Cohort / File(s) Summary
Documentation
README.md
Added two identical bullet entries for rule-porter under the Utilities section, documenting its description and usage.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 A hop, a skip, a tool so fine,
Rule-porter shines with its design,
In README's glow, our words align,
Two entries dance—utilities shine! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and directly describes the main change: adding rule-porter to the Utilities section of the README.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


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.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 289: Update the README entry so the absolute GitHub URL is converted to a
relative link: replace "https://github.com/nedcodes-ok/rule-porter" with the
repository-relative path for the rule-porter project (referencing the existing
README link style), keeping the link text "[rule-porter]" and the rest of the
description unchanged; ensure the final line still shows the `npx rule-porter
--to agents-md` usage snippet and that the link follows the README guideline for
relative links.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fc2ce04 and e0cfaf9.

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

### Utilities

- [Cursor Watchful Headers](https://github.com/johnbenac/cursor-watchful-headers) - A Python-based file watching system that automatically manages headers in text files and maintains a clean, focused project tree structure. Perfect for maintaining consistent file headers and documentation across your project, with special features to help LLMs maintain better project awareness.
- [rule-porter](https://github.com/nedcodes-ok/rule-porter) - A zero-dependency CLI that converts Cursor `.mdc` rules to AGENTS.md, CLAUDE.md, Copilot, and Windsurf formats (and back). Bidirectional conversion with lossy-conversion warnings. `npx rule-porter --to agents-md`
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Use a relative link for this new README entry.

This new Utilities link is absolute, while the README guideline requires relative links.

Suggested update
-- [rule-porter](https://github.com/nedcodes-ok/rule-porter) - A zero-dependency CLI that converts Cursor `.mdc` rules to AGENTS.md, CLAUDE.md, Copilot, and Windsurf formats (and back). Bidirectional conversion with lossy-conversion warnings. `npx rule-porter --to agents-md`
+- [rule-porter](./rules/rule-porter/README.md) - A zero-dependency CLI that converts Cursor `.mdc` rules to AGENTS.md, CLAUDE.md, Copilot, and Windsurf formats (and back). Bidirectional conversion with lossy-conversion warnings. `npx rule-porter --to agents-md`

As per coding guidelines, "Ensure all links in the README.md file are relative and correct".

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- [rule-porter](https://github.com/nedcodes-ok/rule-porter) - A zero-dependency CLI that converts Cursor `.mdc` rules to AGENTS.md, CLAUDE.md, Copilot, and Windsurf formats (and back). Bidirectional conversion with lossy-conversion warnings. `npx rule-porter --to agents-md`
- [rule-porter](./rules/rule-porter/README.md) - A zero-dependency CLI that converts Cursor `.mdc` rules to AGENTS.md, CLAUDE.md, Copilot, and Windsurf formats (and back). Bidirectional conversion with lossy-conversion warnings. `npx rule-porter --to agents-md`
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 289, Update the README entry so the absolute GitHub URL is
converted to a relative link: replace
"https://github.com/nedcodes-ok/rule-porter" with the repository-relative path
for the rule-porter project (referencing the existing README link style),
keeping the link text "[rule-porter]" and the rest of the description unchanged;
ensure the final line still shows the `npx rule-porter --to agents-md` usage
snippet and that the link follows the README guideline for relative links.

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