Changelog

0.4.3 (2026-09-09)

• 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)
• fix(sdk): the breaking change needs a version that says so (#636)
• feat(sdk)!: create_session says which failure happened (#635)
• Thread spend_total_tokens to the client (UsageBreakdown)
• telemetry: emit user.id for Langfuse User Tracking
• telemetry: propagate session.id to child spans for Langfuse best practices
• telemetry: pricing-table cost on spans + dedicated Langfuse backend
• telemetry: stamp provider cost on LLM spans + OTLP protocol selection for Langfuse
• feat(reliability): compute is_error_result on tool.call_completed
• feat(tui): render human template names in tool tree (post-#136 follow-up) (#137)
• tui 0.4.2: pass client_type through to IPCRecoveryClient (SDK 0.12.0 compat)
• tui 0.4.1: restore Ctrl+B (toggle budget panel) keybinding
• tui 0.4.0: minor bump for reconnect helper print
• tui: print reconnect helper to terminal after detach
• tui: fix crash on multi-wave tool finalization (TypeError None - int)
• release: coordinated bump for gap 1-5 SDK release
• sdks: protocol-version compat (gap 5)
• sdks: subscribe API, profile picker, inline session spec, cost/usage refactor
• openers: action-dict shape with raw/diff actions and fallthrough
• Fix TUI startup crash: invalid 's-h' keybinding rejected by prompt_toolkit
• SDK + TUI parity: end_session / delete_session typed methods
• Add hide / show-hidden / gitignore-toggle bindings to the workspace panel
• SDK helpers: compute_cache_hit_percent + TUI adoption
• Add workspace panel keybinding to paste selection as @reference
• Add per-extension openers for workspace panel "open file" action
• TUI j-table: render at OutputBuffer width, not Rich's default 80
• Render / in the TUI; drop per-client branching on the server
• References: knowledge bundles with per-bundle sidecars + reconcile
• References: move sidecar row ordering to embedding_config.json
• Cache hit rate: divide by total input, not just new (uncached) input
• signal_completion: typed payloads from profile-declared schema
• template: rename writeFileFromTemplate → renderTemplateToFile
• Fix: remove stale icon_lines reference that crashed TUI event handler
• Bundle tool_id_mappings in SessionInfoEvent for guaranteed delivery
• ToolIdRegistryEvent: server pushes ID→name mapping to clients
• TUI: resolve hash-derived tool/category IDs in argument display
• Complete agent/profile split: SDK, TUI, and deprecation warning
• Remove gen-references profile from example directory
• Remove gen-references prompt template
• Rewrite gen-references profile and prompt for full catalog generation
• Add gen-references profile and prompt template
• Fix completed step results lost on plan structural changes
• Unify EventBus as single internal event backbone

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