Adds new console commands for clearing the screen and managing command history in the GUI RPC console.
Introduces four new commands:
clear - clears the console output area.clear-all - clears both output and command history.history - lists stored command history.history-clear - clears command history only.Provides explicit, privacy-orientd ways to clear console history and output without altering default behavior. Useful in shared or long-running sessions.
The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.
See the guideline for information on the review process.
| Type | Reviewers |
|---|---|
| Concept NACK | luke-jr |
If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.
Reviewers, this pull request conflicts with the following ones:
If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.
I don’t think this change is practical. Clearing the console should remove the visible output, but it shouldn’t also clear the command history. In most terminal environments (e.g., bash, zsh, cmd, PowerShell, etc.), using clear or Ctrl+L clears the screen while preserving command history, which remains accessible via the arrow keys. Users often rely on this history to repeat or modify previous commands, and removing it could unintentionally disrupt that workflow. I suggest keeping the command history intact when clearing the console.
Also, just a heads-up: this GUI repository is currently in maintenance mode and primarily focused on bugfixes — new feature additions are unlikely to be considered or prioritized unless they’re closely tied to functionality in Bitcoin Core. If you’re interested in contributing new features or improvements, I encourage you to take a look at bitcoin-core/gui-qml, which is the new GUI project under active development. Your contributions would be very welcome there.
I don’t think this change is practical. Clearing the console should remove the visible output, but it shouldn’t also clear the command history. In most terminal environments (e.g., bash, zsh, cmd, PowerShell, etc.), using clear or Ctrl+L clears the screen while preserving command history, which remains accessible via the arrow keys. Users often rely on this history to repeat or modify previous commands, and removing it could unintentionally disrupt that workflow. I suggest keeping the command history intact when clearing the console.
Also, just a heads-up: this GUI repository is currently in maintenance mode and primarily focused on bugfixes — new feature additions are unlikely to be considered or prioritized unless they’re closely tied to functionality in Bitcoin Core. If you’re interested in contributing new features or improvements, I encourage you to take a look at bitcoin-core/gui-qml, which is the new GUI project under active development. Your contributions would be very welcome there.
Thanks for the feedback. I understand the comparison to typical terminal behavior, but I think the context here is different.
In the RPC console, the command history is never cleared unless you shut down Bitcoin Qt. It stays even after using the “Clear” button, closing the console, or even closing the wallet. This means any sensitive or debug-related commands remain accessible via the arrow keys across sessions. Clearing only the output gives a false impression that the console was fully reset.
This change makes the “Clear” button behave more like a full reset, which helps with privacy and general cleanup during debugging. It also aligns with what some users expect from a GUI console.
I understand the repo is in maintenance mode, but I still think this is a relevant and useful change. If needed, I’m open to submitting it to gui-qml instead.
Thanks for the update, but I don’t think relying on a hidden keyboard combination (Shift modifier and Ctrl+Shift+L) is a good long-term solution. Most users will never discover it, and without documentation, it risks becoming an obscure feature that only a handful of people know about. It also deviates from common terminal behavior, where clearing the output and clearing history are separate, explicit actions. On top of that, shortcut bindings can be difficult to maintain long-term — they may conflict with other shortcuts, differ across platforms, or get broken by Qt or OS changes.
I think that a more user-friendly and discoverable approach would be to support terminal-style commands in the console, so users can interact in a way they already understand from bash, zsh, cmd, PowerShell, etc. For example:
0history # list cached commands
1help history # show usage info for the history command
2history -c # clear command history
3clear # clear visible console output only
4help clear # explain clear options (e.g. 'clear history')
5clear history # clear command history
This way, clearing history becomes an intentional action the user explicitly types, and it can be documented alongside other commands in the console’s help output. It’s discoverable, consistent with terminal norms but mainly with the current rpc console behaviour, and extensible if more sub-commands are needed in the future.
Thanks for the update, but I don’t think relying on a hidden keyboard combination (Shift modifier and Ctrl+Shift+L) is a good long-term solution. Most users will never discover it, and without documentation, it risks becoming an obscure feature that only a handful of people know about. It also deviates from common terminal behavior, where clearing the output and clearing history are separate, explicit actions. On top of that, shortcut bindings can be difficult to maintain long-term — they may conflict with other shortcuts, differ across platforms, or get broken by
QtorOSchanges.I think that a more user-friendly and discoverable approach would be to support terminal-style commands in the console, so users can interact in a way they already understand from bash, zsh, cmd, PowerShell, etc. For example:
0history # list cached commands 1help history # show usage info for the history command 2history -c # clear command history 3clear # clear visible console output only 4help clear # explain clear options (e.g. 'clear history') 5clear history # clear command historyThis way, clearing history becomes an intentional action the user explicitly types, and it can be documented alongside other commands in the console’s help output. It’s discoverable, consistent with terminal norms but mainly with the current rpc console behaviour, and extensible if more sub-commands are needed in the future.
Thanks for the feedback, I agree that discoverability is important, and this is addressed in the latest update.
The patch now adds explicit console commands in addition to the button and shortcut:
These commands are listed in the help-console output and also documented in the welcome message shown when the console is cleared, so they are easy to discover. This covers the terminal-style interaction you suggested, while still providing a UI button and shortcut for convenience.
The Ctrl+Shift+L shortcut remains as an extra option for users who prefer a quick key combo, but it is no longer the only way to perform the action.
Sorry I haven’t had the chance to check the PR earlier.
Replacing this line:
Use up and down arrows to navigate history, and Ctrl+L to clear screen.
By:
Use up and down arrows to navigate history, Ctrl+L to clear screen and Ctrl+L to clear screen and Ctrl+Shift+L to clear the command history.
For the new console commands…
- clear -> clears output
- history-clear -> clears output and history
- history -> prints command history
I find them useful but I’d split the clear screen from the clear history (history-clear) and if you want to clear both perhaps a “clear-all”.
Same for the button, I’d add a different button for clearing the history.
Please keep in mind that new features like this may not be merged and help would be also much appreciated in the new QML GUI.
Thanks a lot for the review!
The shortcut is already documented as "Use %9 to clear both the screen and the command history.\n", but I can update it to match the exact wording you suggested.
About splitting the clear functionality: since the output history already includes the input commands, I’m not sure there’s much benefit in clearing just the commands while keeping the output. But if you think it’s more useful that way, I’m happy to adjust and split them.
On the QML side, I don’t see a mockup of the RPC console yet, and I feel like starting it from scratch on my own might not be the best approach. These are features I use myself right now, so I think they add value in the current console even before the experimental QML GUI is ready.
Rebased on current master. Simplified to console commands only, dropped the keyboard shortcut and clear button (no new buttons added). Added the clear-all command for completness and ease of use.
Tested all commands (clear, clear-all, history, history-clear) on Ubuntu 24.04 and Windows 11 – all work as expected.
Adds the following console commands:
- `clear`: clears the console output area.
- `clear-all`: clears both output and command history.
- `history`: lists stored command history.
- `history-clear`: clears command history only.
These additions improve privacy and convenience in shared or long-lived
sessions by allowing users to remove sensitive commands and output from view.