Changelog

0.5.0 (2026-09-10)

• feat(tui): collapse reasoning blocks by default, stream deltas as one block (#755) (#956)
• ci: publish to PyPI, and add jaato-eval to the release set (#923)
• feat(media): deliver binary media chunks, and know when a spoken turn ended (#824)
• chore: normalise line endings to LF, once, in one commit (#794) (#807)
• fix(tui,permission): make a permission prompt readable, and answerable only as chosen (#796)
• fix(tui,clarification): answer a batched clarification instead of hanging (#704) (#783)
• fix(providers): one prompt-token convention, converted at the seam (#758) (#763)
• fix(security): close the symlink escapes in file tools and search (#669) (#746)
• fix(daemon): refuse a relative path at the process boundary (#742) (#744)
• test(guards): a guard that cannot detect its own reversion now fails the build (#665)
• fix(memory): list_memory_tags reported an empty store while holding a raw queue (#664)

Rich Client

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

Installation

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 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