feat: add no-useless-echo rule

[nzakas]

Adds shell/no-useless-echo, which mirrors ShellCheck SC2116: cmd $(echo foo) is just cmd foo.

Behavior

• Reports a command substitution ($(...) or backticks) whose body is exactly one echo command, not negated and with no redirects.
• The check doesn't look at echo's arguments, so $(echo -n foo) is reported too.
• Not reported: substitutions with more than one statement ($(echo a; echo b)), pipelines ($(echo foo | tr a-z A-Z)), or redirected echoes.
• No autofix: removing the substitution can change quoting and word splitting.
• Recommended config: "error".

Documentation

Adds docs/rules/no-useless-echo.md, following the format of the @eslint/json, @eslint/css, and @eslint/markdown rule docs: description, background, rule details with incorrect and correct examples, options, when not to use it, and the ShellCheck reference. The rule's meta.docs.url points at that file, and its README table entry links to it.

Testing

8 RuleTester cases and 5 documentation checks (233 total); build, lint, and format checks pass.

🤖 Generated with Claude Code

---

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 31 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: 7e662514-01fc-4832-b706-af89076f6026

📥 Commits

Reviewing files that changed from the base of the PR and between ff13b63 and f572af5.

📒 Files selected for processing (6)

• README.md
• docs/rules/no-useless-echo.md
• src/index.spec.ts
• src/index.ts
• src/rules/no-useless-echo.spec.ts
• src/rules/no-useless-echo.ts

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Copilot review overview

🟢 Approval recommended

The implementation and integration are sound; only a minor test-coverage gap remains.

Review effort: Balanced
Findings: 1

Open (1)

• Add test for documented negated-command exception · New

What changed in this PR

Adds a ShellCheck-inspired rule detecting redundant echo command substitutions.

Changes:

• Implements and tests bash/no-useless-echo.
• Enables the rule in the recommended configuration.
• Adds rule documentation and README registration.

File	Description
src/​rules/​no-useless-echo.ts	Implements detection logic.
src/​rules/​no-useless-echo.spec.ts	Adds RuleTester coverage.
src/​index.ts	Registers and enables the rule.
src/​index.spec.ts	Verifies rule exposure.
README.md	Adds the rule to the catalog.
docs/​rules/​no-useless-echo.md	Documents behavior and usage.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[nzakas]

@copilot address review comments. Be sure to add tests.

[Copilot]

@copilot address review comments. Be sure to add tests.

Added the negated echo regression case and verified it with the targeted test suite. Commit: 7b6d5b7.