Skip to content

feat: add rargs plugin — xargs alternative with regex pattern matching#283

Merged
javimosch merged 1 commit into
masterfrom
mago/task-22
Jun 22, 2026
Merged

feat: add rargs plugin — xargs alternative with regex pattern matching#283
javimosch merged 1 commit into
masterfrom
mago/task-22

Conversation

@javimosch

@javimosch javimosch commented Jun 22, 2026

Copy link
Copy Markdown
Owner

Summary by CodeRabbit

  • New Features
    • Added rargs plugin, an xargs alternative with pattern-matching regex groups functionality. Includes installation guidance and quickstart documentation.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@coderabbitai

coderabbitai Bot commented Jun 22, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

A new rargs plugin is added under plugins/rargs/. It includes the plugin manifest (plugin.json) with a passthrough command and binary dependency check, metadata (meta.json), Homebrew-based install guidance (install-guidance.json), and a quickstart skill document (SKILL.md).

Changes

rargs Plugin Addition

Layer / File(s) Summary
Plugin manifest, metadata, and install guidance
plugins/rargs/plugin.json, plugins/rargs/meta.json, plugins/rargs/install-guidance.json
plugin.json defines the rargs plugin (v0.1.0) with a passthrough command invoking the rargs binary and a which rargs dependency check. meta.json sets the description, tags (rargs, utility), and has_learn: true. install-guidance.json specifies brew install rargs as the install step.
Quickstart skill
plugins/rargs/skills/quickstart/SKILL.md
Adds SKILL.md with front matter (name, description) and introductory headings for the rargs plugin quickstart skill.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • javimosch/supercli#241: Adds new plugins using the same install-guidance.json, meta.json, and plugin.json structure with identical binary check and passthrough command patterns.

Poem

A rabbit hops through terminal lines,
With rargs now joining the plugin shrines,
Pattern-matching regex, what a delight,
brew install rargs and everything's right,
🐇 Hop hop hooray, new commands take flight!

🚥 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 a new rargs plugin and characterizes it as an xargs alternative with regex pattern matching, which aligns with the changeset.
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 mago/task-22

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.

Actionable comments posted: 1

🤖 Prompt for all review comments with 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.

Inline comments:
In `@plugins/rargs/plugin.json`:
- Line 1: The install_guidance configuration is duplicated across two files with
divergent schemas: the embedded install_guidance object in plugin.json includes
a "note" field that is absent from the separate
plugins/rargs/install-guidance.json file, creating an inconsistency. Consolidate
these into a single source of truth by either removing the separate
install-guidance.json file and keeping the complete install_guidance definition
in plugin.json, or ensure both files define the identical install_guidance
schema and add documentation explaining why both files coexist.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0073bec6-2a2d-4cbf-b0c0-ea297729fdb0

📥 Commits

Reviewing files that changed from the base of the PR and between 05b7e80 and e4abe1f.

📒 Files selected for processing (4)
  • plugins/rargs/install-guidance.json
  • plugins/rargs/meta.json
  • plugins/rargs/plugin.json
  • plugins/rargs/skills/quickstart/SKILL.md

Comment thread plugins/rargs/plugin.json
@@ -0,0 +1 @@
{"name":"rargs","version":"0.1.0","description":"rargs — xargs alternative with pattern-matching regex groups","source":"https://github.com/lotabout/rargs","checks":[{"type":"binary","name":"rargs"}],"install_guidance":{"plugin":"rargs","binary":"rargs","check":"which rargs","install_steps":["brew install rargs"],"note":"System utility."},"learn":{"file":"skills/quickstart/SKILL.md"},"commands":[{"namespace":"rargs","resource":"_","action":"_","description":"Passthrough to rargs","adapter":"process","adapterConfig":{"command":"rargs","passthrough":true,"missingDependencyHelp":"Install rargs: brew install rargs"},"args":[]}]} No newline at end of file

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check the structure difference between embedded and separate install guidance

echo "=== Embedded install_guidance in plugin.json ==="
jq '.install_guidance' plugins/rargs/plugin.json

echo ""
echo "=== Separate install-guidance.json ==="
cat plugins/rargs/install-guidance.json

echo ""
echo "=== Field comparison ==="
echo "Embedded fields: $(jq '.install_guidance | keys | sort' plugins/rargs/plugin.json)"
echo "Separate fields: $(jq 'keys | sort' plugins/rargs/install-guidance.json)"

Repository: javimosch/supercli

Length of output: 582


Resolve install_guidance duplication and field divergence.

The embedded install_guidance in plugins/rargs/plugin.json includes a "note": "System utility." field that is absent from plugins/rargs/install-guidance.json. The separate file is incomplete or serves a different purpose. Either consolidate to a single source of truth (recommend using the plugin.json manifest), or document why both files should coexist with divergent schemas.

🤖 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 `@plugins/rargs/plugin.json` at line 1, The install_guidance configuration is
duplicated across two files with divergent schemas: the embedded
install_guidance object in plugin.json includes a "note" field that is absent
from the separate plugins/rargs/install-guidance.json file, creating an
inconsistency. Consolidate these into a single source of truth by either
removing the separate install-guidance.json file and keeping the complete
install_guidance definition in plugin.json, or ensure both files define the
identical install_guidance schema and add documentation explaining why both
files coexist.

@javimosch javimosch closed this Jun 22, 2026
@javimosch javimosch reopened this Jun 22, 2026
@javimosch

Copy link
Copy Markdown
Owner Author

Review — Head of Org Engineering: The diff adds a new rargs plugin with valid JSON files, proper scoping under plugins/rargs/, no syntax errors, security issues, or leaked secrets. The change is consistent with adding the described plugin.

@javimosch javimosch merged commit 1e822d9 into master Jun 22, 2026
0 of 3 checks passed
@javimosch javimosch deleted the mago/task-22 branch June 22, 2026 09:20
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