TUI Interface¶

Tokuye provides a rich terminal chat interface powered by Textual.

Layout¶

The interface is split into two panels:

┌─────────────────────────────────┬──────────────────────┐
│           Chat Panel            │     Side Panel       │
│                                 │                      │
│  [Assistant message]      [⎘]  │  💰 Cost display     │
│  [User message]           [⎘]  │                      │
│                                 │  System log          │
│  thinking...                    │                      │
│                                 │  Token log           │
│  [Text input area]              │                      │
│  [Send] [Reset] [Recall Issue]  │                      │
└─────────────────────────────────┴──────────────────────┘

Chat Panel¶

Message Display¶

Each message is rendered as a Markdown widget with a colored border:

Sender	Border color	Border title
You	Bright white	`You`
Assistant	Light sky blue	Agent name (e.g. `Alice`)
System	Violet	`System`

Copy Button¶

Every message has a ⎘ button in the top-right corner. Clicking it copies the full message content to your clipboard.

Uses pyperclip if available, falls back to Textual's built-in clipboard API
A Copied! notification appears briefly after copying

Thinking Indicator¶

While the agent is processing, a thinking... label is displayed below the chat log. It disappears automatically when the agent finishes.

Input Area¶

Text input: Multi-line text area (12 rows). Press Enter for new lines.
Send (Ctrl+D): Submit the message
Reset: Clear the conversation and start a new session (agent state is reset)
Recall Issue: Restore the last saved issue content into the input area (see Issue Management)

Side Panel¶

Cost Display¶

Shows the estimated AWS Bedrock cost for the current session:

💰 Estimated cost: $0.12
This amount is an estimate for ap-northeast-1.
Accuracy is not guaranteed.

System Log¶

Displays internal logs from Tokuye (INFO, WARNING, ERROR level). Useful for debugging tool calls and agent behavior.

Token Log¶

Shows per-turn token usage breakdown:

📊 Turn Token Usage: 4,231 total (3,890 input + 341 output)
   Cache: 3,200 created, 690 read | Cache Cost: $0.000412 (¥0.06)
   Embeddings: 1,024 tokens | Embedding Cost: $0.000030 (¥0.00)

Keyboard Shortcuts¶

Key	Action
`Ctrl+D`	Send message
`Enter`	New line in input
`Ctrl+Q`	Quit

Theme Customization¶

The TUI theme is controlled by the theme setting in your config:

theme: tokyo-night

Any theme name supported by Textual can be used. See the Textual documentation for available themes.