Skip to content

feat(acp): add /help command#24839

Merged
sripasg merged 1 commit intomainfrom
sripas_fix_acp_help
Apr 7, 2026
Merged

feat(acp): add /help command#24839
sripasg merged 1 commit intomainfrom
sripas_fix_acp_help

Conversation

@sripasg
Copy link
Copy Markdown
Contributor

@sripasg sripasg commented Apr 7, 2026

Summary

Add a /help command to the Agent Client Protocol (ACP) interface to list available commands and basic usage instructions, matching the TUI functionality.

Details

  • Implement HelpCommand in packages/cli/src/acp/commands/help.ts.
  • Register the command in commandHandler.ts and pass the CommandRegistry to it.
  • Format the output using Markdown headers and bullet points for better rendering in chat interfaces.
  • Exclude the "shell mode" instruction from the help output as it is not yet fully supported in the ACP context.
  • Add unit tests for command parsing in commandHandler.test.ts.

Related Issues

Part of request from Jetbrains.

How to Validate

Should appear in / completion on ACP mode in IDE

image

Should list the help commands appropriate for the ACP

image

Pre-Merge Checklist

  • [NA] Updated relevant documentation and README (if needed)
  • [✅] Added/updated tests (if needed)
  • [NA] Noted breaking changes (if any)
  • [✅] Validated on required platforms/methods:
    • [✅] MacOS
      • [✅] npm run
      • npx
      • Docker
      • Podman
      • Seatbelt
    • Windows
      • npm run
      • npx
      • Docker
    • Linux
      • npm run
      • npx
      • Docker

@sripasg sripasg requested a review from a team as a code owner April 7, 2026 17:15
@gemini-cli
Copy link
Copy Markdown
Contributor

gemini-cli Bot commented Apr 7, 2026

Hi @sripasg, thank you so much for your contribution to Gemini CLI! We really appreciate the time and effort you've put into this.

We're making some updates to our contribution process to improve how we track and review changes. Please take a moment to review our recent discussion post: Improving Our Contribution Process & Introducing New Guidelines.

Key Update: Starting January 26, 2026, the Gemini CLI project will require all pull requests to be associated with an existing issue. Any pull requests not linked to an issue by that date will be automatically closed.

Thank you for your understanding and for being a part of our community!

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a help functionality to the Agent Client Protocol, improving user experience by allowing them to discover available commands directly within the interface. The implementation leverages the existing command registry to dynamically generate a list of commands, ensuring that the help output remains consistent with the current system state.

Highlights

  • New Help Command: Implemented a new /help command within the Agent Client Protocol (ACP) to provide users with a list of available commands and usage instructions.
  • Command Registration: Integrated the HelpCommand into the existing CommandHandler to ensure it is properly registered and accessible.
  • Testing: Added unit tests to commandHandler.test.ts to verify that the /help command is correctly parsed.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@sripasg sripasg self-assigned this Apr 7, 2026
@sripasg sripasg added ACP priority/p1 Important and should be addressed in the near term. labels Apr 7, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a new /help command to the CLI, providing users with information on basic context usage and a list of available commands. A test case was added to verify the command's registration. Feedback suggests sorting the command list alphabetically to improve discoverability and usability as the number of commands grows.

Comment thread packages/cli/src/acp/commands/help.ts Outdated
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 7, 2026

Size Change: -898 B (0%)

Total Size: 34 MB

Filename Size Change
./bundle/chunk-PSNFPUFY.js 0 B -14.8 MB (removed) 🏆
./bundle/chunk-U36YPFWC.js 0 B -3.15 MB (removed) 🏆
./bundle/chunk-UV75IQ6X.js 0 B -1.96 MB (removed) 🏆
./bundle/core-RM5PEJW4.js 0 B -45.2 kB (removed) 🏆
./bundle/devtoolsService-XBB3Z3UQ.js 0 B -28.4 kB (removed) 🏆
./bundle/interactiveCli-XAC4YB33.js 0 B -1.64 MB (removed) 🏆
./bundle/oauth2-provider-6YGO65LR.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-EH5ACEN5.js 3.15 MB +3.15 MB (new file) 🆕
./bundle/chunk-GFUOVHXW.js 1.96 MB +1.96 MB (new file) 🆕
./bundle/chunk-VQ53DKLT.js 14.8 MB +14.8 MB (new file) 🆕
./bundle/core-3AUUF4IB.js 45.2 kB +45.2 kB (new file) 🆕
./bundle/devtoolsService-65KSUMK6.js 28.4 kB +28.4 kB (new file) 🆕
./bundle/interactiveCli-UQ64YKPW.js 1.64 MB +1.64 MB (new file) 🆕
./bundle/oauth2-provider-NRGDJZQY.js 9.16 kB +9.16 kB (new file) 🆕
ℹ️ View Unchanged
Filename Size Change
./bundle/bundled/third_party/index.js 8 MB 0 B
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-5PS3AYFU.js 1.18 kB 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/devtools-36NN55EP.js 696 kB 0 B
./bundle/dist-T73EYRDX.js 356 B 0 B
./bundle/events-XB7DADIJ.js 418 B 0 B
./bundle/gemini.js 553 kB +904 B (+0.16%)
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/memoryDiscovery-JL5XPI6O.js 0 B -980 B (removed) 🏆
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js 222 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js 229 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js 13.4 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js 132 B 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.82 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 5.02 kB 0 B
./bundle/src-QVCVGIUX.js 47 kB 0 B
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/memoryDiscovery-ACCRGPX3.js 980 B +980 B (new file) 🆕

compressed-size-action

@gemini-cli gemini-cli Bot added the status/need-issue Pull requests that need to have an associated issue. label Apr 7, 2026
@sripasg sripasg force-pushed the sripas_fix_acp_help branch from afd85f2 to f8ffbaf Compare April 7, 2026 18:32
Add a /help command to the Agent Client Protocol (ACP) interface to list available commands and basic usage instructions, matching the TUI functionality.

- Implement HelpCommand in packages/cli/src/acp/commands/help.ts.
- Register the command in commandHandler.ts and pass the CommandRegistry to it.
- Format the output using Markdown headers and bullet points for better rendering in chat interfaces.
- Exclude the "shell mode" instruction from the help output as it is not yet fully supported in the ACP context.
- Add unit tests for command parsing in commandHandler.test.ts.
@sripasg sripasg force-pushed the sripas_fix_acp_help branch from f8ffbaf to 7bbb5be Compare April 7, 2026 18:41
@sripasg sripasg added this pull request to the merge queue Apr 7, 2026
Merged via the queue into main with commit 06fcdc2 Apr 7, 2026
46 of 47 checks passed
@sripasg sripasg deleted the sripas_fix_acp_help branch April 7, 2026 21:05
warrenzhu25 pushed a commit to warrenzhu25/gemini-cli that referenced this pull request Apr 9, 2026
@SandyTao520
Copy link
Copy Markdown
Contributor

/patch stable

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 9, 2026

🚀 [Step 1/4] Patch workflow(s) waiting for approval!

📋 Details:

  • Channels: stable
  • Commit: 06fcdc231c32c2d336129c79be8b4a95f52c958e
  • Workflows Created: 1

⏳ Status: The patch creation workflow has been triggered and is waiting for deployment approval. Please visit the specific workflow links below and approve the runs.

🔗 Track Progress:

github-actions Bot pushed a commit that referenced this pull request Apr 9, 2026
# Conflicts:
#	packages/cli/src/acp/commandHandler.test.ts
#	packages/cli/src/acp/commandHandler.ts
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 9, 2026

🚀 [Step 2/4] Patch PR Created!

📋 Patch Details:

📝 Next Steps:

  1. ⚠️ Resolve conflicts in the hotfix PR first: #25051
  2. Test your changes after resolving conflicts
  3. Once merged, the patch release will automatically trigger
  4. You'll receive updates here when the release completes

🔗 Track Progress:

SandyTao520 pushed a commit that referenced this pull request Apr 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ACP priority/p1 Important and should be addressed in the near term. status/need-issue Pull requests that need to have an associated issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants