# SuperShell: TUI Vault Browser

<figure><img src="/files/lq8uvWBq21lxcPPeBklr" alt=""><figcaption></figcaption></figure>

## Overview

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

{% hint style="info" %}
Requires Commander version 17.2.2 or newer
{% endhint %}

<figure><img src="/files/zV6RBadalUuqWwu3PYR8" alt=""><figcaption></figcaption></figure>

## Getting Started

Launch SuperShell with `supershell` or `ss` command:

```
keeper supershell
```

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

```
supershell
```

## Feature Overview

<figure><img src="/files/144gBtrn30a7d8hI0Ko3" alt=""><figcaption></figcaption></figure>

SuperShell displays a split-pane interface:

* Top pane - Search input, account info, and device status
* Left pane - Folder tree with nested folders and records
* Right pane - Folder and Record details (normal or JSON view)
* Bottom pane - Command shell and terminal output, use `Ctrl+\` to show/hide

### Keyboard 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. When a pane is selected, vi commands can be used to control scrolling. The shortcuts are listed below.

### Command Pane

When the command pane is displayed, Commander commands can be executed and the output is displayed in the terminal window.

| Key                                                 | Action                                                  |
| --------------------------------------------------- | ------------------------------------------------------- |
| <h3> <code>Ctrl + \</code> </h3>                    | Open the bottom command shell pane with terminal output |
| <h3><code>Tab</code> or <code>Shift+Tab</code></h3> | Cycle between visible panes                             |
| <h3><code>!</code></h3>                             | Exit to the standard Keeper Commander shell             |

### Basic Movement

| Key                                       | Action          |
| ----------------------------------------- | --------------- |
| <h3><code>j</code> or <code>↓</code></h3> | Move down       |
| <h3><code>k</code> or <code>↑</code></h3> | Move up         |
| <h3><code>h</code> or <code>←</code></h3> | Collapse folder |
| <h3><code>l</code> or <code>→</code></h3> | Expand folder   |
| <h3><code>g</code></h3>                   | Go to top       |
| <h3><code>G</code></h3>                   | Go to bottom    |

### Page Navigation

| Key                          | Action               |
| ---------------------------- | -------------------- |
| <h3><code>Ctrl+d</code></h3> | Half page down       |
| <h3><code>Ctrl+u</code></h3> | Half page up         |
| <h3><code>Ctrl+e</code></h3> | Scroll down one line |
| <h3><code>Ctrl+y</code></h3> | Scroll up one line   |
| <h3><code>Ctrl+f</code></h3> | Full page down       |
| <h3><code>Ctrl+b</code></h3> | Full page up         |

### Focus Cycling

| Key                             | Action                        |
| ------------------------------- | ----------------------------- |
| <h3><code>Tab</code></h3>       | Cycle: Tree → Detail → Search |
| <h3><code>Shift+Tab</code></h3> | Cycle backwards               |
| <h3><code>/</code></h3>         | Focus search input            |
| <h3><code>Esc</code></h3>       | 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                                      |
| --------------------------------------------- | ------------------------------------------- |
| <h3><code>/</code></h3>                       | Start search                                |
| <h3><code>Enter</code> or <code>↓</code></h3> | Navigate to results                         |
| <h3><code>Ctrl+U</code></h3>                  | Clear search input                          |
| <h3><code>Esc</code></h3>                     | Clear search and restore previous selection |

### Copying Values

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

| Key                     | Action                    |
| ----------------------- | ------------------------- |
| <h3><code>p</code></h3> | Copy password             |
| <h3><code>u</code></h3> | Copy username             |
| <h3><code>c</code></h3> | Copy entire record (JSON) |
| <h3><code>w</code></h3> | Copy URL                  |
| <h3><code>i</code></h3> | Copy record UID           |

When running SuperShell on your local device, you can also click on any line to copy the value to the clipboard.

<figure><img src="/files/J2kPTR7Wh0CkN6ul8UuJ" alt=""><figcaption></figcaption></figure>

### View Modes

When a Keeper record is selected, SuperShell offers two view modes that toggle between normal and JSON view. Press `t` to toggle.

<figure><img src="/files/TaICCAPbsmnVOfBqDVMd" alt=""><figcaption><p>Normal Record View</p></figcaption></figure>

<figure><img src="/files/3QswWtLzI9CQwHLZB6nU" alt=""><figcaption><p>JSON Record View</p></figcaption></figure>

### 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                                  |
| ----------------------- | --------------------------------------- |
| <h3><code>t</code></h3> | 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                                  |
| ----------------------- | --------------------------------------- |
| <h3><code>m</code></h3> | 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

<figure><img src="/files/Xnt5sWaxBKDHXha0c83h" alt=""><figcaption></figcaption></figure>

## Additional Actions

| Key                     | Action                           |
| ----------------------- | -------------------------------- |
| <h3><code>d</code></h3> | Sync vault (refresh from server) |
| <h3><code>W</code></h3> | Show user information            |
| <h3><code>D</code></h3> | Show device information          |
| <h3><code>P</code></h3> | Open preferences (color themes)  |
| <h3><code>?</code></h3> | Show keyboard shortcuts help     |

## Exiting SuperShell

| Key                          | Action                     |
| ---------------------------- | -------------------------- |
| <h3><code>!</code></h3>      | Exit to Keeper shell       |
| <h3><code>Ctrl+q</code></h3> | Quit SuperShell completely |

## Feature Requests

We plan to add many new Vault and KeeperPAM features to SuperShell. Please submit all feature requests by [opening an issue](https://github.com/Keeper-Security/Commander/issues).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/en/keeperpam/commander-cli/commander-installation-setup/supershell-tui-vault-browser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.