Add a /bug-memory command that takes a memory snapshot and saves it to disk

[jacob314]

Command to export a memory snapshot

This will speed up user's reporting memory issues. Right now users have to connect to chrome devtools and take a snapshot which is higher friction then just typing a command in Gemini CLI.

This could be integrated directly in /bug automatically saving a memory snapshot to disk if memory usage is over 2GB and surfacing the URL to the snapshot to let the user know they can share the snapshot with the bug if they want.

Concerns: taking a snapshot via the V8 API can be slow. We would need to make sure the bug url is shown before we potentially lock their machine for 20 seconds taking the snapshot.
See the existing usage of the Node V8 API to open the debugger. We'd want to open the debugger and then use the V8 API commands to take a snapshot and save to disk. We should ensure we close the debugger after the task is complete and use an available port rather than requiring 9229.

[Adib234]

Thank you for the suggestion! This would be a very useful tool for diagnosing memory-related issues in the CLI. The technical approach using the Node V8 API is well-defined. We are labeling this as 'help wanted' for any community members who would like to contribute this diagnostic command.

[Anjaligarhwal]

/assign

[gemini-cli]

👋 @Anjaligarhwal, you've been assigned to this issue! Thank you for taking the time to contribute. Make sure to check out our contributing guidelines.

[Anjaligarhwal]

Hey @jacob314, I’ve opened #25639 for this. /bug-memory captures a V8 heap snapshot on demand, /bug auto-captures the same when RSS crosses 2GB, and the bug URL renders before the stop-the-world phase so the CLI doesn't look frozen. Used v8.getHeapSnapshot() piped through node:stream/promises, which keeps everything in-process with no port exposed.

would appreciate your feedback whenever you get a chance. Happy to iterate on any suggestions.