TUI (Terminal UI)

Experimental — The TUI is a showcase of what's possible with Agent Messenger's SDK. It's not intended for production use, but demonstrates the power of having a unified adapter layer across 10 messaging platforms.

What Is It?

The TUI (Terminal User Interface) is a blessed-based interactive terminal app that unifies all your messaging platforms into a single screen. Navigate between Slack, Discord, Teams, Webex, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk — all from your terminal.

Launch

agent-messenger tui

On startup, the TUI attempts to log in to all platforms simultaneously using your stored credentials. Platforms that authenticate successfully appear as available; the rest show as "(offline)" and can be authenticated interactively.

If only one platform succeeds, it auto-selects and jumps straight to the channel list.

Navigation

The TUI has three navigation levels and three input modes.

Navigation Levels

Input Modes

Keybindings

Features

Multi-Platform Login

All platforms authenticate in parallel on startup. The TUI reuses credentials already stored by each platform's CLI (e.g., agent-slack auth extract). Platforms that haven't been set up appear as "(offline)" — select them to trigger an interactive auth flow right in the TUI.

Real-Time Messages

For platforms with listener support (Slack and Discord), new messages appear in real time. The listener starts automatically when you open a channel.

Fuzzy Pickers

Press Ctrl+K to open the channel picker or Ctrl+W for the workspace picker. Both support fuzzy matching — just start typing to filter.

Interactive Auth

If a platform isn't authenticated, selecting it in the sidebar starts an interactive auth flow. The TUI prompts for any required input (phone numbers, pairing codes, etc.) directly in the message pane.

Architecture

The TUI demonstrates the adapter pattern at the core of Agent Messenger:

┌─────────────┐
│   TUI App   │  blessed screen, views, key bindings
├─────────────┤
│  Adapters   │  PlatformAdapter interface (one per platform)
├─────────────┤
│  SDK Layer  │  SlackClient, DiscordClient, TeamsClient, ...
└─────────────┘

Each platform implements the PlatformAdapter interface:

interface PlatformAdapter {
  readonly name: string
  login(): Promise<void>
  getChannels(): Promise<UnifiedChannel[]>
  getMessages(channelId: string, limit?: number): Promise<UnifiedMessage[]>
  sendMessage(channelId: string, text: string): Promise<void>
  startListening?(onMessage: (msg: UnifiedMessage) => void): Promise<void>
  stopListening?(): void
  getWorkspaces?(): Promise<Workspace[]>
  switchWorkspace?(workspaceId: string): Promise<void>
  getCurrentWorkspace?(): Workspace | null
  getAuthHint(): AuthHint
  authenticate(io: AuthIO): Promise<void>
}

This means adding a new platform to the TUI is just implementing one adapter — the same SDK clients that power each CLI also power the TUI.

Source

The TUI source lives in src/tui/:

src/tui/
├── app.ts                          # Main app (screen, layout, modes)
├── cli.ts                          # CLI entry point
├── utils.ts                        # Timestamp formatting, fuzzy match, etc.
├── adapters/
│   ├── types.ts                    # PlatformAdapter interface
│   ├── slack-adapter.ts
│   ├── discord-adapter.ts
│   ├── teams-adapter.ts
│   ├── webex-adapter.ts
│   ├── telegram-adapter.ts
│   ├── whatsapp-adapter.ts
│   ├── line-adapter.ts
│   ├── instagram-adapter.ts
│   ├── kakaotalk-adapter.ts
│   └── channeltalk-adapter.ts
└── views/
    ├── channel-picker.ts           # Ctrl+K fuzzy channel search
    └── workspace-picker.ts         # Ctrl+W fuzzy workspace search