User Interface

seekr features a rich, responsive Terminal UI (TUI) that organizes multiple streams of information into a cohesive interface.

Layout Overview

The UI is divided into several persistent and contextual areas:

1. Navigation Tabs

At the top of the screen, you'll find the main navigation:

  • Chat: Your conversation history with the AI.
  • Tasks: Active goals and sub-tasks. Features a real-time Concurrency Indicator showing how many threads are active.
  • Setup: Configuration management.

2. Interaction Area

The largest portion of the screen, where chat messages, reasoning, and tool executions are displayed. The Activity Log within this area numbers parallel tool calls (e.g., 7/12) for better visibility.

3. Popups & Dialogs

  • Session List: Press Ctrl+S to view, resume, or delete previous chat sessions.
  • Help Menu: Press F1 to toggle a cheat sheet of all available shortcuts.
  • Confirmation Dialogs: Standard [Y]es / [N]o prompts for quitting or approving dangerous tool calls.

4. Status Bar

Located at the bottom, showing the current state of the agent (Idle, Thinking, Running Tool), the selected model, resource usage, and active shortcuts.

Key Shortcuts

KeyAction
TabCycle focus between Chat and Tasks panel.
EnterSend message / Confirm selection.
Ctrl+SOpen Session List to resume or delete chats.
Ctrl+RToggle visibility of agent Reasoning tokens.
Ctrl+LClear the current chat view.
F1Show the Help shortcut menu.
EscCancel / Go back / Open Quit dialog.
PageUp/DnScroll the focused panel quickly.
Ctrl+CForce quit the application.

Themes

Currently, seekr supports a high-contrast dark theme optimized for most modern terminal emulators.

Next: Agent Logic