ssot-tui 0.1.6.dev1

Terminal UI package for ssot-registry workflows.

🔷 ssot-tui

Textual terminal UI for browsing SSOT registries.

ssot-tui is a Textual-based terminal UI for browsing SSOT registries.

It is focused on read-oriented exploration and safe workflow bridges rather than full CRUD parity with the CLI.

What this package owns

• The ssot-tui console entry point
• The Textual app shell and browser screen
• TUI widgets for section navigation, entity tables, and detail panes

When to use this package

Use ssot-tui when you want:

• an interactive terminal browser for SSOT registry content
• a navigable view across entity sections with filters, recent repos, and keyboard-first navigation
• structured entity detail views with a raw JSON fallback
• safe workflow bridges such as validation, CLI read previews, and opening repo resources
• a Textual UI on top of the ssot-core runtime

Use another package when you want:

• ssot-cli for full command-line workflow coverage
• ssot-core for direct Python API access
• ssot-contracts for packaged schemas and templates
• ssot-views for report and graph builders
• ssot-codegen for regeneration of metadata artifacts

Install

python -m pip install ssot-tui

For local development from this repository:

python -m pip install -e pkgs/ssot-tui

This package depends on ssot-core, ssot-contracts, and textual.

Start the TUI

ssot-tui

The current entry point launches SsotTuiApp, which mounts a browser-oriented screen when the application starts.

Interaction model

The browser now supports:

• repo auto-discovery from the current working directory
• persisted recent repos and last-viewed session state
• inline filtering with /
• a command palette with Ctrl+P
• a help overlay with ?
• pane navigation with Tab, Shift+Tab, h, j, k, and l
• reload and validation via r and v
• structured detail rendering with t to toggle raw JSON
• table view cycling with m

The detail pane can traverse linked entity ids, preview file-backed resources, and render safe CLI read previews for the current section or entity.

Screenshots

Regenerate these assets with python scripts/generate_tui_screenshots.py.

Captured against examples/minimal-repo in this workspace:

Current scope

The current implementation is browser-first and read-first:

• workspace loading, recent repo switching, and validation summaries
• section-based navigation with per-section counts and failure rollups
• tabular browsing with filter and mode switching
• structured and raw detail inspection for the selected item
• safe bridge actions for opening files, revealing paths, and previewing read-only CLI output

The package still does not implement full CRUD or guided operational workflows with CLI-level parity.

Main UI concepts

The current source tree exposes these UI building blocks:

• BrowserScreen: the primary browser screen
• SectionNavigation: a section chooser with counts and validation indicators
• EntityTable: a table view for entities in the active section
• EntityDetailPane: a structured detail view with related-resource traversal
• CommandPaletteScreen: an action launcher backed by the shared action registry
• HelpScreen: a keyboard and action reference overlay
• StatusCenter: a persistent status and toast history panel

At the application level, SsotTuiApp provides a header, footer, and browser screen composition.

Package relationships

• Package type: terminal UI package
• Depends on: ssot-core, ssot-contracts, textual
• Consumed by: users who want interactive browsing on top of the core SSOT runtime

If you need complete operational coverage today, use ssot-cli. If you want an interactive terminal browser for current registry content, this package is the right entry point.