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, now featuring full syntax highlighting for code blocks.
  • Tasks: Active goals and sub-tasks. Features a real-time Concurrency Indicator showing how many threads are active.

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. Use Visual Selection mode to copy text directly from the chat history.

3. Popups & Dialogs

  • Unified Menu: Press Ctrl+G to view, resume, or delete sessions, switch models/providers, and adjust settings.
  • 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, Flowing, Thinking), the selected model, token usage, and active shortcuts.

Key Shortcuts

KeyAction
TabCycle focus between Chat and Tasks panel.
Ctrl+GOpen Unified Menu (Sessions, Models, Providers, Settings).
Ctrl+RClear Chat history.
F1Show the Help shortcut menu.
EscCancel / Go back / Open Quit dialog.
Ctrl+CForce quit the application.

Chat Selection & Copy (focused)

KeyAction
j / kScroll selection up/down.
v / VEnter Visual / Visual-Line mode.
yCopy current selection to clipboard.
cQuick-copy the code block under the cursor.
i / EscReturn to Input focus.

Themes

Currently, seekr supports a premium high-contrast dark theme optimized for most modern terminal emulators, featuring vibrant HSL-tailored colors for better readability.

Next: Agent Logic