agent-tui

agent-tui

Terminal user interface for AI agents built on agent-core.

A Textual-based terminal interface for interacting with AI agents. Built on agent-core and InteropRouter for unified model provider support.

[!NOTE] This library is in early development and subject to change.

Usage

Ensure OPENAI_API_KEY is set in your environment.

Run the TUI:

uv run agent-tui

Or run directly with Textual:

uv run textual run src.agent_tui.app:AgentApp

Development

Prerequisites

• uv
• prek

Setup

Create uv virtual environment and install dependencies:

uv sync --frozen --all-groups

Set up git hooks:

prek install

To update dependencies (updates the lock file):

uv sync --all-groups

Run formatting, linting, and type checking:

uv run ruff format && uv run ruff check --fix && uv run ty check