Changelog

0.6.0 (2026-09-20)

• declare the jaato-sdk floor instead of accepting any version (#1055)
• raise requires-python to >=3.12, the version CI actually tests (#1076)
• One marker, and the index descriptor is not it (#1130 follow-up)
• Document the uv equivalent of every install command
• events: ToolOutputEvent.generated_by -- model media carries provenance (Art. 50(2))
• scaffold: a .gitignore that keeps .jaato/ assets committable and its state out
• Files panel: hide and .gitignore toggles, served daemon-side as workspace.ignore (protocol 1.12)
• permission: send the prompt content on the runner path, and render it
• Remove max_turns: a bound declared everywhere and enforced nowhere (#1068)

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