@slorenzot/memento-tui

Terminal UI explorer for Memento database — read-only visual navigation with keyboard controls.

Requirements

• Bun >= 1.0.0 (required — uses bun:sqlite internally)

Install

# Local install
bun add @slorenzot/memento-tui

# Global install (recommended for CLI usage)
bun add -g @slorenzot/memento-tui

Usage

Run directly with bunx (no install needed)

bunx memento-tui

Run after local install

# Via bunx
bunx memento-tui

# Via node_modules/.bin
./node_modules/.bin/memento-tui

Run after global install

memento-tui

Specify a custom database path

memento-tui --db /path/to/memento.db

By default, the TUI opens the Memento database at ~/.memento/memento.db.

Navigation Bar

The top of the screen shows a breadcrumb-style navigation bar with all views:

Dashboard › Observations › Sessions › Projects

The current view is highlighted in bold cyan. Switch views with number keys or ←/→ arrows.

Features

• Dashboard — overview of observations, types, and projects
• Observations — browse observations with split-pane detail view (paginated)
• Observation detail — view full content with metadata in right panel
• Sessions — list and explore sessions (paginated)
• Projects — list projects with statistics
• Search — full-text search across all observations (press / from Observations)

Keyboard Controls

| Key | Action | |-----|--------| | 1-4 | Switch views | | ←/→ | Previous / next view | | ↑/↓ or j/k | Navigate lists | | Enter | Select / expand | | < / > | Previous / next page (in Observations and Sessions) | | / | Open search (from Observations) | | Tab | Toggle left/right panel (in Observations) | | Esc | Back / cancel | | q | Quit |

License

CC-BY-NC-ND-4.0