Changelog

1.0.0 (2026-09-23)

• Rename squatted top-level packages to jaato_server / jaato_tui (#1079)
• Files panel reset that survives a reconnect (#1189)
• fix(packaging): declare the SDK floor at the cut's lowest point (#1153)

Rich Client

Interactive TUI client for jaato with multi-agent support, streaming output, and rich formatting.

Installation

pip install jaato-tui
# or:  uv pip install jaato-tui

Overview

The rich client provides:

• Multi-agent conversation view with agent cycling
• Streaming output with real-time rendering
• Permission prompts for tool execution
• Plan panel for tracking agent plans
• Customizable keybindings and themes

Running

# Start server daemon first
.venv/bin/python -m jaato_server --ipc-socket /tmp/jaato.sock --daemon

# Connect TUI to running server
.venv/bin/python jaato-tui/rich_client.py --connect /tmp/jaato.sock

Commands

General

Model

Tools

Plugins

Sessions

Plan

Screenshot

Capture TUI state as images. The command is intercepted client-side. By default, a system hint is sent to the model with the capture path.

Captures are saved to /tmp/jaato_vision/ by default. SVG is the default format. PNG requires cairosvg package.

Keybindings

Authentication

Anthropic Claude:

Antigravity (Google IDE Backend):

Theme

Default Keybindings

Configuration

Keybindings

Keybindings can be configured via:

1. Project config: .jaato/keybindings.json
2. User config: ~/.jaato/keybindings.json
3. Environment variables: JAATO_KEY_<ACTION>=<key>

Priority: Environment variables > Project config > User config > Defaults

Themes

The rich client supports customizable themes with automatic persistence.

Built-in Themes:

Custom themes can be defined in:

• Project: .jaato/theme.json
• User: ~/.jaato/theme.json

Theme selection is persisted to ~/.jaato/preferences.json.

Custom Theme Example:

{
  "name": "my-theme",
  "version": "1.0",
  "colors": {
    "primary": "#5fd7ff",
    "secondary": "#87d787",
    "success": "#5fd75f",
    "warning": "#ffff5f",
    "error": "#ff5f5f",
    "muted": "#808080",
    "background": "#1a1a1a",
    "surface": "#333333",
    "text": "#ffffff",
    "text_muted": "#aaaaaa"
  }
}

Environment Variables

File References

Reference files in prompts with @ prefix:

What's in @screenshot.png?
Review @src/main.py

Related

• Vision Capture Plugin - Screenshot implementation
• Architecture - Framework architecture