A lightweight, persistent popup terminal plugin for the Omarchy Linux desktop status bar with command history, Polkit graphical authentication, and working directory persistence.
- Fast & Lightweight: Clean QML popup integrated seamlessly into Omarchy's status bar.
- Working Directory Persistence: Automatically tracks and preserves your active working directory across commands (including
cd). - Native Polkit/Sudo Support: Seamlessly routes
sudocommands through Omarchy's graphical authentication dialog (pkexec). - Command History: Use ↑ and ↓ arrow keys to quickly cycle through previous commands.
- Clean UI & Auto-Scrolling: Color-coded prompts, command block dividers, execution status indicator, and automatic output scrolling.
- Omarchy Theme Integration: Uses Omarchy's native
StyleandColortokens matching your active system theme.
omarchy plugin add https://github.com/Rizmi/omarchy-terminal-plugin.git --enable-
Clone the repository into your Omarchy plugins directory:
git clone https://github.com/Rizmi/omarchy-terminal-plugin.git \ ~/.config/omarchy/plugins/io.github.rizmi.terminal -
Validate and enable the plugin on your status bar:
omarchy plugin validate ~/.config/omarchy/plugins/io.github.rizmi.terminal omarchy plugin enable io.github.rizmi.terminal --section right
-
Reload the shell if necessary:
omarchy restart shell
omarchy plugin disable io.github.rizmi.terminal
rm -rf ~/.config/omarchy/plugins/io.github.rizmi.terminal
omarchy restart shell- Click icon or use IPC (
omarchy shell io.github.rizmi.terminal toggle) to open/close the popup. - Enter: Run command
- Kill button: Kill running command
- ↑ / ↓: Navigate command history
- Esc: Close popup
- Clear button: Clear terminal output history
You can customize dimensions directly in your ~/.config/omarchy/shell.json:
{
"id": "io.github.rizmi.terminal",
"width": 440,
"maxHeight": 560
}MIT License © 2026 Omarchy Community