Terminal UI (TUI)

An interactive terminal interface over the same encrypted vault — browse, search, add, delete, and reveal secrets without leaving your shell.

  1. Launch
  2. Browsing & searching
    1. Panels & focus
    2. Navigation
    3. Search & filters
    4. Reveal & copy
    5. Edit the vault
    6. App
  3. Adding & editing
  4. When to use which interface

Launch

concealer tui        # or: cer tui

Unlock the same way as the CLI — a CONCEALER_TOKEN in your environment (from unlock / init), or a master-password prompt on the TTY.

concealer TUI splash screen


Browsing & searching

The screen has three panels — 1 · Filters, 2 · Secrets, 3 · Details. Move focus between them, browse, reveal, copy, and edit entirely from the keyboard. Secret fields stay masked until you reveal them — the same record-aware masking rules as everywhere else (see Secret Types).

concealer TUI — searchable secret list


Keyboard shortcuts

Press ? anytime to see this table in-app. It is bilingual (press L to toggle TR/EN).

Panels & focus

Keys Action
Tab / Shift+Tab Cycle focus through the visible panels
/ h l Move focus between panels
1 / 2 / 3 Jump straight to Filters / Secrets / Details
Keys Action
/ j k Move the selection up / down
g / G Jump to top / bottom
PgUp / PgDn, Ctrl+U / Ctrl+D Page up / down

Search & filters

Keys Action
s or / Live search — filters as you type
Esc Clear the search / exit search mode
Space / Enter In the Filters panel: toggle a facet (type, project, env, tenant, repo, tag)
x Clear all active filters

Reveal & copy

Keys Action
m In the Secrets panel: reveal / hide all fields of the selected record
/ j k then Enter / m In the Details panel: pick a field and reveal just that one
c Copy the value to the clipboard
u Copy the username
w Copy the url

The clipboard is auto-cleared after 45 seconds (uses pbcopy / xclip / wl-copy). There is no paste — the TUI reads secrets out; to put a value in, use add/edit below.

Edit the vault

Keys Action
a Add a new secret (type-aware form)
e Edit the selected secret
d Delete the selected secret (with confirm)
r Rotate its value to a random one

App

Keys Action
R Reload the vault from disk
Ctrl+L Force a redraw
L Toggle language (TR / EN)
? Show the in-app help
q / Ctrl+Q Quit

Terminal rendering: concealer draws box characters (┌│─) in UTF-8 terminals and falls back to ASCII (+-\|) where needed (e.g. VS Code’s integrated terminal). Force it with CONCEALER_TUI_ASCII=1 (ASCII) or =0 (UTF-8).


Adding & editing

Add and edit use the same type-aware model as the web UI and CLI: pick a type, fill only the fields that make sense for it, and secret fields are stored masked.

concealer TUI — type-aware edit form

Every reveal, create, update, and delete is written to the tamper-evident audit log with source recorded — the TUI is a first-class interface, not a bypass.


When to use which interface

You want… Use
Scripting, CI, piping into run/deploy CLI
Rich forms, filters, deploy renderers, audit viewer Web UI
Fast keyboard browsing inside the terminal TUI (this page)
Agents using secrets without seeing them MCP

Developed by FXerkan — Code more, worry less. · MIT License

This site uses Just the Docs, a documentation theme for Jekyll.