Skip to main content

​
TUI Client

The @igentai/dim-tui package provides a rich terminal user interface for interacting with Diminuendo. It is designed for headless environments, SSH sessions, and developers who prefer terminal-based workflows.

​
When to Use

  • Working over SSH without a graphical environment
  • Lightweight interaction without browser or desktop app overhead
  • Server environments where only a terminal is available
  • Developers who prefer keyboard-driven workflows

​
Quick Start

cd clients
npm install
npm run dev:tui
The TUI connects to the gateway at ws://localhost:8080/ws by default.

​
Architecture

The TUI uses the TypeScript SDK directly for gateway communication, bypassing the React/Zustand stack used by the web and desktop clients: 
Terminal UI → TypeScript SDK → WebSocket → Diminuendo Gateway

​
Features

  • Session management (create, list, join, archive, delete)
  • Real-time streaming of agent responses
  • Tool call visualization and approval
  • File browsing and content viewing
  • Keyboard-driven navigation