Skip to content

Add Terminal Command Explainer agent - #751

Open
KoderOP wants to merge 5 commits into
AditthyaSS:mainfrom
KoderOP:add-terminal-command-explainer
Open

Add Terminal Command Explainer agent#751
KoderOP wants to merge 5 commits into
AditthyaSS:mainfrom
KoderOP:add-terminal-command-explainer

Conversation

@KoderOP

@KoderOP KoderOP commented Jul 5, 2026

Copy link
Copy Markdown

Closes #578 Add Terminal Command Explainer agent

What does this PR do?

Adds a new Terminal Command Explainer agent which takes any terminal/shell command and breaks it down in plain English — a summary, a part-by-part breakdown table, an example execution walkthrough, and flag-by-flag explanations, tailored to the user's selected experience level (Beginner / Intermediate / Expert). It also flags destructive commands (rm, dd, chmod 777, etc.) with a warning and a safer alternative.

Type of change

  • [ ✅ ] New agent

Checklist

  • [✅ ] I ran npm run build locally and it passed ✅
  • [✅ ] I tested my changes in the browser ✅
  • [✅ ] I did not break any existing agents ✅
  • [✅] I did not use import agents from '../agents/registry'
  • [✅] My PR has a clear description above ✅

Screenshots

image

Summary by CodeRabbit

Summary by CodeRabbit

  • New Features
    • Added a new command-explainer assistant that converts terminal commands into clear, plain-English guidance.
    • Includes an experience-level selector (Beginner/Intermediate/Expert) to tailor the explanation style.
    • Produces structured Markdown responses covering a quick summary, step-by-step breakdown, example execution, commonly used flags/options, and key safety/important notes (with warnings and safer alternatives for potentially destructive commands).

@KoderOP
KoderOP requested a review from AditthyaSS as a code owner July 5, 2026 20:16
@vercel

vercel Bot commented Jul 5, 2026

Copy link
Copy Markdown

@KoderOP is attempting to deploy a commit to the aditthyass' projects Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai

coderabbitai Bot commented Jul 5, 2026

Copy link
Copy Markdown

Review Change Stack

Note

.coderabbit.yaml has unrecognized properties

CodeRabbit is using all valid settings from your configuration. Unrecognized properties (listed below) have been ignored and may indicate typos or deprecated fields that can be removed.

⚠️ Parsing warnings (1)
Validation error: Unrecognized key: "issues"
⚙️ Configuration instructions
  • Please see the configuration documentation for more information.
  • You can also validate your configuration using the online YAML validator.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Walkthrough

This PR adds a new terminal-command-explainer agent definition with metadata, required command and experience-level inputs, a markdown-formatted system prompt, and outputType: "markdown".

Changes

Terminal Command Explainer Agent

Layer / File(s) Summary
Agent metadata, inputs, and prompt configuration
src/agents/definitions/terminal-command-explainer.js
Adds the new agent definition export with core metadata, example inputs, required command and experience-level fields, a structured markdown prompt, and markdown output formatting.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

  • AditthyaSS/iloveAgents#710: Also adds a new agent definition module with structured markdown prompt instructions and agent metadata.

Suggested labels: level:beginner, gssoc:approved, type:feature

Suggested reviewers: AditthyaSS

🚥 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 matches the main change: adding the Terminal Command Explainer agent.
Linked Issues check ✅ Passed The new agent definition covers the requested ID, category, icon, provider, inputs, markdown output, and warning behavior.
Out of Scope Changes check ✅ Passed The PR appears scoped to creating the requested agent definition file with no obvious unrelated changes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Biome (2.5.1)
src/agents/definitions/terminal-command-explainer.js

File contains syntax errors that prevent linting: Line 94: expected , but instead found rm; Line 94: expected , but instead found ```; Line 94: Expected a property, a shorthand property, a getter, a setter, or a method but instead found 'dd'.; Line 94: Expected a property, a shorthand property, a getter, a setter, or a method but instead found '`chmod 777`'.; Line 94: expected `,` but instead found `other`; Line 94: expected `,` but instead found `destructive`; Line 94: expected `,` but instead found `operations`; Line 94: expected `,` but instead found `a`; Line 94: Unexpected token `!`; Line 94: Unexpected token `️`; Line 95: expected `,` but instead found `-`; Line 95: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 95: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 95: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 95: Expected an identifier but instead found ','.; Line 95: expected `,` but instead found `for`; Line 96: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 96: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 96: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 96: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 96: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 96: Expected a semicolon or an implicit semicolon after a statement, but found none; Line 96: unterminated template literal


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.

@mergify

mergify Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

Hey @KoderOP! 👋
Wow — your first contribution to iloveAgents! This is a big deal and I want you to know it means a lot. 🎊
Every agent on this platform started exactly like this — someone like you deciding to spend their time building something useful for everyone. That is something to be proud of.
A few things while you wait for the review:

  • Star the repo if you haven't already. Star it here
  • 📖 Check the Contributing Guide
  • 💬 Drop a comment if you get stuck — I reply within 24 hours
    Can't wait to ship this with you. 🚀
    Welcome to the iloveAgents family. 🙏
    @AditthyaSS

@mergify

mergify Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

hey @KoderOP! 👋
Your PR title doesn't follow our required format.
Please update it to:
type: short description
Valid types: feat, fix, docs, style, refactor, test, chore
Example: feat: add sales discovery agent
@AditthyaSS

@mergify mergify Bot added the needs-fix label Jul 5, 2026
@mergify

mergify Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

hey @KoderOP! 👋
Your PR doesn't seem to be linked to an issue.
Please add this line to your PR description:
Closes #issue_number
Replace issue_number with the actual issue number you are solving.
This helps us track what each PR is fixing! 🔗
@AditthyaSS

@mergify

mergify Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

⚠️ This branch is out of date with main.
Please click "Update branch" to sync before merging.

@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 `@src/agents/definitions/terminal-command-explainer.js`:
- Around line 93-96: The dangerous-command guidance in
terminal-command-explainer.js includes a bogus token that will trigger false
positives on harmless commands. Update the prompt text in the command-safety
instructions to remove the invalid `:/` entry, and keep the checks focused on
real destructive patterns handled by the explainer logic so `ALWAYS CHECK FOR
DANGEROUS COMMANDS` only mentions actual risky commands.
🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 0e9432b4-765f-477b-9d62-0b6b8319f2ac

📥 Commits

Reviewing files that changed from the base of the PR and between 8ccdb05 and 4c1d8ee.

📒 Files selected for processing (1)
  • src/agents/definitions/terminal-command-explainer.js

@KoderOP KoderOP changed the title Pull Request for #578 Add Terminal Command Explainer agent #578 Jul 5, 2026
@KoderOP KoderOP changed the title Add Terminal Command Explainer agent #578 Add Terminal Command Explainer agent Jul 5, 2026
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

@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 `@src/agents/definitions/terminal-command-explainer.js`:
- Around line 93-96: Escape the literal backticks inside the systemPrompt
template string in terminal-command-explainer.js so the prompt text does not
terminate the backtick-delimited literal early. Update the dangerous-commands
guidance near the ALWAYS CHECK FOR DANGEROUS COMMANDS section, and make sure the
symbols around the embedded command examples (`rm`, `dd`, `chmod 777`, and `rm
-i`) are all consistently escaped the same way as the other prompt text in this
file.
🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 2dc944a4-62e1-4eed-b158-ec72cc8cc92b

📥 Commits

Reviewing files that changed from the base of the PR and between 4c1d8ee and 663f3fb.

📒 Files selected for processing (1)
  • src/agents/definitions/terminal-command-explainer.js

Comment thread src/agents/definitions/terminal-command-explainer.js
@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
iloveagents Error Error Jul 10, 2026 4:02pm

@mergify mergify Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

❌ Build is failing on this PR.
Please fix before merging:

  1. Run npm run build locally
  2. Fix any errors shown
  3. Push your fix — the check will re-run automatically
    Most common issue: broken registry import.
    Replace:
    import agents from '../agents/registry'
    With:
    import { useAgents } from '../lib/useAgents'
    const { agents } = useAgents()
    See CONTRIBUTING.md for help. 🙏

@mergify mergify Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

❌ Build is failing on this PR.
Please fix before merging:

  1. Run npm run build locally
  2. Fix any errors shown
  3. Push your fix — the check will re-run automatically
    Most common issue: broken registry import.
    Replace:
    import agents from '../agents/registry'
    With:
    import { useAgents } from '../lib/useAgents'
    const { agents } = useAgents()
    See CONTRIBUTING.md for help. 🙏

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: add Terminal Command Explainer agent

2 participants