linux/ohmyzsh
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2026-01-23 02:35:38 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
ohmyzsh/plugins/kate-admin-helper/README.md
Javier Rubio 6ad9814c04
 Add kate-admin-helper plugin for elevated file access 
This plugin provides automatic privilege elevation for the Kate editor using the `admin://` KIO protocol. It ensures secure handling of files requiring root permissions and prevents running Kate as root, adhering to KDE security practices.
2025-04-25 21:07:39 +02:00

1.3 KiB
Raw Blame History

kate-admin-helper

This plugin provides an automatic privilege elevation helper for Kate (KDE text editor) when opening files in zsh.

When opening files that the user does not have write access to, the plugin automatically uses the admin:// KIO protocol, allowing Kate to request privilege elevation via Polkit.
This avoids running the entire Kate process as root and follows modern KDE security practices.

If privilege elevation is needed, a message will be shown, and the user will be prompted to authenticate with their password through Polkit.

Installation

Add kate-admin-helper to your plugin list in ~/.zshrc:

plugins=(
  ...
  kate-admin-helper
)

Usage

Open files as usual:

kate /etc/hosts
kt /etc/fstab /etc/ssh/sshd_config

If the file requires elevated privileges to edit, it will be opened automatically with admin://.
A colored message will inform you that privilege elevation is needed, and a Polkit prompt will ask for your password.

The kt command is also available and behaves the same way.

Requirements

  • Kate installed
  • kio-admin installed
  • A running Polkit authentication agent (e.g., polkit-kde-agent-5 or polkit-kde-agent-6)
  • pkexec available to create new files if needed