KRunner에서 tmux 명령과 세션을 바로 찾는다

KDE Plasma 6용 KRunner 플러그인 Tmux Cheatsheet는 tmux 명령어를 입력하면 다음에 쓸 수 있는 옵션과 설명을 보여준다. 실행 중인 세션과 창·패널 정보도 검색해 명령을 단계적으로 만들거나 세션에 바로 접속할 수 있다.

KRunner를 Alt+Space로 열고 tmux 또는 명령어 일부를 입력하면 된다. 예를 들어 tmux attach를 입력하면 -d(다른 클라이언트 연결 해제), -r(읽기 전용), -t <target-session> 같은 옵션이 표시된다. tmux attach -t 뒤에는 실제 실행 중인 세션 이름이 나오며, tmux splitw -t 뒤에는 현재 패널과 실행 중인 프로그램이 표시된다. ls, neww, splitw 같은 별칭과 a 같은 고유 접두어, -dr처럼 결합한 옵션도 인식한다.

추천 항목에서 Enter를 누르면 해당 내용이 KRunner 입력창에 들어가고 창은 열린 채로 유지된다. Run: tmux … 항목을 선택하면 기본 터미널에서 명령을 실행한다. attach나 -d 없는 new처럼 상호작용이 필요한 명령은 터미널을 차지하며, 나머지 명령은 실행 후 Enter를 누를 때까지 출력을 보여준다. 세션 항목을 선택하면 해당 세션에 접속할 수 있고, 다른 클라이언트 연결을 끊고 접속하거나 명령을 클립보드에 복사하는 추가 동작도 제공한다.

필요 조건은 KDE Plasma 6(KDE Frameworks 6, Qt 6), tmux, C++20 컴파일러와 CMake다. 소스에서 설치하려면 배포판별 빌드 의존성을 설치한 뒤 저장소를 내려받아 빌드하고 설치한다.

Arch / Manjaro / EndeavourOS:

sudo pacman -S --needed base-devel cmake extra-cmake-modules krunner kio qt6-base tmux

Fedora:

sudo dnf install gcc-c++ cmake extra-cmake-modules kf6-krunner-devel kf6-kio-devel qt6-qtbase-devel tmux

Debian / Ubuntu / KDE neon(Plasma 6이 포함된 릴리스):

sudo apt install build-essential cmake extra-cmake-modules libkf6runner-dev libkf6kio-dev qt6-base-dev tmux

openSUSE Tumbleweed:

sudo zypper install gcc-c++ cmake extra-cmake-modules kf6-krunner-devel kf6-kio-devel qt6-base-devel tmux

git clone https://github.com/ChristianHrs/tmux_hints.git
cd tmux_hints
cmake -B build -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release
cmake --build build
sudo cmake --install build

설치 후 kquitapp6 krunner를 실행해 KRunner를 재시작한다. 다음에 Alt+Space를 누르면 KRunner가 다시 시작된다. 플러그인이 나타나지 않으면 시스템 설정의 검색 항목에서 Tmux Cheatsheet가 활성화됐는지 확인한다. 세션 목록이 비어 있다면 tmux 서버가 실행 중인지 확인해야 한다. 설치 파일은 build/install_manifest.txt에 기록되며, 이 목록으로 제거할 수 있다.

명령어와 옵션, 설명은 저장소의 tmuxcommands.h에 표 형태로 들어 있다. 항목을 추가하거나 바꾼 뒤 다시 빌드·설치하면 된다. 프로젝트는 GitHub 저장소에서 확인할 수 있으며, 라이선스는 GPL-2.0-or-later다.