SuperShell: TUI Vault Browser

Keeper vault TUI available in Keeper Commander

Overview

SuperShell is a full-screen Terminal User Interface (TUI) for browsing and managing your Keeper vault. It provides a keyboard-driven (vim) style navigation, optimized for power users and developers.

Requires Commander version 17.2.2 or newer

Getting Started

Launch SuperShell with either command:

keeper supershell
keeper ss

If you're already in the Keeper shell, simply type:

supershell

Interface Overview

SuperShell displays a split-pane interface:

• Left pane - Folder tree with nested folders and records

• Right pane - Folder and Record details (normal or JSON view)

• Top bar - Search input, account info, and device status

Navigation

SuperShell supports vi-style keyboard navigation for efficient usage over SSH sessions or within any standard system terminal. All functionality can be accomplished without taking your hands off the keyboard. For example, the j and k keys navigate up and down, and tab switches between the search, folder tree and detail panes. The shortcuts are listed below.

Basic Movement

Key	Action
j or ↓	Move down
k or ↑	Move up
h or ←	Collapse folder
l or →	Expand folder
g	Go to top
G	Go to bottom

Page Navigation

Key	Action
Ctrl+d	Half page down
Ctrl+u	Half page up
Ctrl+e	Scroll down one line
Ctrl+y	Scroll up one line
Ctrl+f	Full page down
Ctrl+b	Full page up

Focus Cycling

Key	Action
Tab	Cycle: Tree → Detail → Search
Shift+Tab	Cycle backwards
/	Focus search input
Esc	Clear search / Return to tree

Search

Press / to activate search mode or use the tab key. SuperShell provides live incremental search that filters as you type.

Key	Action
/	Start search
Enter or ↓	Navigate to results
Ctrl+U	Clear search input
Esc	Clear search and restore previous selection

Copying Values

SuperShell makes it easy to copy record fields to your clipboard.

Key	Action
p	Copy password
u	Copy username
c	Copy entire record (JSON)
w	Copy URL
i	Copy record UID

You can also click on any field value in the detail view to copy it directly.

View Modes

SuperShell offers two view modes that toggle between normal and JSON view. Press t to toggle.

Normal Record View

JSON Record View

JSON View

Displays the raw JSON representation of the record, useful for:

• Viewing all record data

• Debugging record structure

• Copying complete record data

Key	Action
t	Toggle between Detail and JSON view

Sensitive Data

By default, SuperShell masks sensitive fields that contain "password", "secret", or "passphrase" in their names.

Key	Action
m	Toggle mask/unmask for sensitive fields

TOTP Codes

For records with Two-Factor Authentication configured, SuperShell displays:

• The current TOTP code

• A countdown bar showing time remaining

• Automatic refresh every second

Additional Actions

Key	Action
d	Sync vault (refresh from server)
W	Show user information
D	Show device information
P	Open preferences (color themes)
?	Show keyboard shortcuts help

Exiting SuperShell

Key	Action
!	Exit to Keeper shell
Ctrl+q	Quit SuperShell completely

Use ! to drop to the Keeper shell for running commands, then type supershell or ss to return.

Requirements

SuperShell requires the following Python packages (automatically installed):

• textual>=0.82.0 - TUI framework

• pyperclip - Clipboard support

Troubleshooting

SuperShell won't start

Ensure you have the required dependencies installed:

shell

pip install textual pyperclip

Clipboard not working

On Linux, you may need to install xclip or xsel:

Debian/Ubuntu

sudo apt install xclip

Fedora

sudo dnf install xclip

Display issues

SuperShell works best with:

• Terminal width of at least 80 columns

• A terminal that supports 256 colors

• A monospace font with Unicode support

If you experience display issues, try resizing your terminal or switching to a different terminal emulator.