# Textual TUI

Storyteller features a rich Terminal User Interface (TUI) for a more immersive experience.

## Launching the TUI

Use the `--tui` flag with the `start` command:

```bash
storyteller start --tui
```

## Features

- **Chat Window**: Scrollable history of your adventure.
- **Sidebar**: (Planned) Real-time display of character stats, inventory, and active quests.
- **Lore Browser**: (Planned) Quickly browse your lore files without leaving the app.

## Advanced Dashboard

The TUI now includes a rich dashboard with multiple panels:

- **Character Sheet**: Displays HP, Gold, and Inventory (left sidebar).
- **Chat Tab**: The main interface for interacting with the AI.
- **Lore Browser**: A tab to browse and read unlocked lore files without leaving the game.
- **World State**: Displays current location and time (right sidebar).

## Controls

- **Input**: Type your actions in the box at the bottom.
- **Tabs**: Click tabs to switch between Chat and Lore.
- **Quit**: Type `exit` or press `Ctrl+C`. to toggle dark mode.
- **Quit**: Type `exit` or press `Ctrl+C`.
