v0.7.8-beta1

Fate UI v0.7.8-beta1

This beta makes the busiest parts of Fate UI easier to navigate, faster to switch, and less cramped on smaller windows. It also turns saved conversation branches into something you can understand and use directly.

Conversation paths

The old read-only Branches list is now an interactive Conversation paths panel.

• Shows the current path and meaningful alternate paths instead of raw Pi entry types such as custom and message.
• Switches to a saved path without creating another session or deleting the path you came from.
• Restores an editable prompt to the composer when the selected path ends at one.
• Blocks stale targets and path changes while the session, a child agent, Agent Teams, or GoalMax still has active work.
• Supports keyboard navigation, visible focus, loading and disabled states, bounded lists, and narrow sidebars.

Faster Inspector navigation

• Reorganizes the Inspector into Work, Run, and System destinations, with a smaller set of relevant views under each one.
• Remembers the last view used inside each destination.
• Keeps the active child count on Run so ongoing agent work remains visible.
• Narrows runtime subscriptions and moves workspace initialization out of the main App render path, which avoids broad rerenders when switching Inspector destinations.
• Removes several decorative transitions and layout effects that made routine navigation feel slower or busier.

Child-agent conversations

• Replaces the lower Flight Recorder surface with a resizable, read-only conversation preview for the selected child.
• Opens retained conversations for both legacy subagents and Agent Teams V2 nodes without leaving the agent tree.
• Shows retained team messages, final answers, tool activity, failures, and affected paths in chronological order.
• Opens and reopens transcripts at the latest output.
• Follows new output only while the transcript is already pinned to the bottom, so manual scrolling is not interrupted.

Resizable work areas

Horizontal resize handles now divide:

• project files from the file preview;
• changed files or commit history from the diff preview;
• the child-agent tree from its conversation preview;
• session history from Conversation paths.

The handles work with pointer input and the keyboard. Double-clicking a handle restores its default size.

Session and Agent Team storage

• Stores Agent Teams V2 child sessions beneath FATE_GUI_DATA_DIR/agent-teams when a custom Fate UI data directory is configured.
• Continues to discover child sessions in the legacy ~/.pi/fateGUI/agent-teams location.
• Deletes persisted sibling and nested child sessions before deleting their parent session.
• Leaves the parent session untouched if child-history cleanup fails, preventing a partially deleted session tree.

Interface polish

• Simplifies composer attachment, resource-tagging, and fork controls into compact icon actions with accessible labels and tooltips.
• Tightens the Changes review bar, recorded-origin chips, preview actions, welcome cards, activity indicators, and narrow-window layouts.
• Adds selected states for child rows and clearer focus treatment across the Inspector.
• Removes visual separators and motion that did not help users understand the interface.

Compatibility and installers

Existing projects, sessions, settings, themes, and Agent Team data do not require a manual migration. This beta does not introduce an intentional breaking change.

The release workflow builds and smoke-tests Windows x64, macOS Apple Silicon, macOS Intel, and Linux x64 packages. The prerelease contains seven installers plus SHA256SUMS:

• Windows x64: NSIS .exe
• macOS arm64 and x64: .dmg and .pkg
• Linux x64: .AppImage and .deb

Public beta installers remain unsigned. Windows SmartScreen or macOS Gatekeeper may show an unknown-publisher warning, so verify downloads against SHA256SUMS.

v0.7.7-beta2

What’s new in 0.7.7-beta2

GoalMax foundations

GoalMax adds a persistent goal layer to agent sessions, with coordinated state, progress tracking, evidence, budgets, and linked subagent work.

Use /goalmax <objective> to start a visible engineering goal that keeps its success criteria and progress attached to the session across agent turns.

Cleaner Inspector tabs

The Inspector tabs now read as one continuous control. The vertical separators between Files and Agents, and between Tools and Resources, have been removed.

Runtime and workspace polish

• Improved GoalMax lifecycle integration with the flight recorder and subagent controls.
• Cleaned up multi-agent coordination and handoffs.
• Polished Context panel behavior and the workspace activity pulse.

This beta does not introduce intentional breaking changes.

v0.6.6-beta1

Fate UI v0.6.6-beta1

Important

Child-agent failures are now isolated from the root session. Fate UI no longer queues child reports during Pi's unsafe agent_end → agent_settled gap. A failed or late subagent report is deferred, delivered after settlement, and cannot terminate the main agent with Cannot continue from message role: assistant.

Root-session resilience

• Adds an explicit root turn lifecycle gate for legacy subagents and Agent Teams V2.
• Defers child reports that arrive after agent_end, appends all pending reports, and wakes the parent only once after agent_settled.
• Falls back to the next direct turn if a child report cannot be attached, while keeping the full child result available in the Agents inspector.
• Adds regression coverage for the exact fatal continuation race and for V2 root-envelope routing.

Performance pass

• Replaces per-stream cloning of normalized 5,000-entry message, reasoning, tool, and timeline records with immutable entity values plus scalar projection versions.
• Stops rescanning the full visible timeline for ordinary tool-output updates; wait-poll grouping now invalidates only on relevant wait-tool lifecycle changes.
• Prunes post-cap timeline entities incrementally instead of rebuilding every normalized record on each overflow.
• Lazy-loads Settings, Command Palette, optional interface fonts, music, terminal, and Monaco surfaces. The unused React Query runtime was removed.
• Ships a purpose-built Monaco runtime with the complete editor interaction surface and Fate UI's supported language set, instead of every Monaco grammar and the unused LSP entrypoint.
• Loads Inter, Montserrat, and Poppins only when selected; Poppins now ships Chromium-native WOFF2 payloads without duplicate legacy WOFF files.
• Coalesces terminal resize work to one animation frame and suppresses unchanged PTY resize IPC.
• Resolves large directory-entry metadata with bounded concurrency while preserving ordering, symlink confinement, truncation, and project-generation checks.
• Extends the repeatable Electron renderer profiler with configurable 600/5,000-entry workloads and post-burst idle CPU sampling.

On the same Windows x64 development machine, five-run production medians versus the pre-pass baseline showed:

• 600-entry live workload: wall time 2,529.75 → 2,053.57 ms (-18.8%), script time 176.28 → 158.75 ms (-9.9%), and heap growth 7.12 MB → 1.98 MB (-72.2%).
• 5,000-entry live workload: task time 988.71 → 854.49 ms (-13.6%), heap growth 14.11 MB → 5.97 MB (-57.7%), and p95 timer lag 11.7 → 5.6 ms (-52.1%).
• The production entry chunk fell from approximately 1.9 MB to 852 KB, while the formerly monolithic Monaco payload was split and reduced from approximately 7.5 MB to 3.85 MB before on-demand language workers.

Exact results vary by hardware, project, model output, and operating system. The profiler reports contained no renderer console errors or long tasks.

Security hardening

• Routes yt-dlp extraction through a loopback-only HTTPS CONNECT proxy that resolves each destination once, rejects any private/local answer, and connects to the validated public IP directly.
• Routes Electron renderer HTTPS traffic through the same public-address gate, closing the DNS-rebinding and redirect gap for remote audio and other renderer media.
• Keeps cleartext proxy requests, non-443 CONNECT targets, credentials, local hostnames, mixed public/private DNS answers, and private IPv4/IPv6 ranges blocked.
• Updates Vite, Vitest, PostCSS, jsdom, @electron/asar, and vulnerable transitive packages. pnpm audit --audit-level low reported zero known advisories at release verification time.
• Retains SHA-pinned GitHub Actions, least-privilege job permissions, exact artifact-set checks, installer smoke tests, and release checksum verification.

This was a bounded defensive review, not a claim that any non-trivial application is vulnerability-free. Optional standalone Semgrep/gitleaks/pip-audit analyzers were unavailable locally; the release is additionally gated by dependency audit, deterministic candidate scanning, manual trust-boundary review, unit/integration tests, Electron E2E, and the cross-platform CI matrix.

Compatibility and known limitations

• Existing settings, sessions, projects, themes, fonts, music queues, and Agent Team data require no manual migration.
• Public beta installers remain unsigned, so Windows SmartScreen and macOS Gatekeeper may show an unknown-publisher warning.
• Optional fonts and heavy editor workers now load on first use; subsequent opens reuse the cached module and font resources.

Verification and installers

The release is gated by strict TypeScript, the full Vitest suite, Playwright Electron E2E, version/tag validation, dependency audit, production builds, and the GitHub Actions package matrix. CI builds, installs or mounts, and smoke-tests fresh Windows x64, macOS Apple Silicon, macOS Intel, and Linux x64 packages before publishing exactly seven versioned installers plus SHA256SUMS. No prior-release installer is reused.

v0.6.0-beta1

Fate UI v0.6.0-beta1

Important

Custom-model image generation is now independent of the active chat model. Choose Automatic, ChatGPT OAuth, OpenAI API, Google Gemini, OpenRouter, or a compatible custom Pi provider under Settings → Agent → Image generation. Fate UI reuses Pi-managed authentication, never exposes provider credentials to the renderer, validates raster output, and stores generated images under ~/.pi/agent/generated-images/<session-id>/.

Custom-model image generation

• Adds dedicated image-provider and image-model selection without forcing the conversation onto that provider.
• Supports ChatGPT OAuth, OpenAI API credentials, Gemini credentials, OpenRouter OAuth/API credentials, and custom OpenAI-compatible Pi providers configured in ~/.pi/agent/models.json.
• Preserves Pi-composed provider/model headers, rejects credentialed cleartext endpoints except loopback model servers, refuses cross-origin redirects, bounds provider responses, and accepts only validated PNG, JPEG, or WebP output.
• Propagates the configured route to root sessions, legacy subagents, and Agent Teams V2 children.
• Records the requested and actual output formats in the generated-image metadata sidecar.

User-facing fixes and improvements

• Smaller usable windows (#11): the native minimum is now 600 × 620, with a responsive center track and regression coverage for the fully collapsed layout.
• Music looping (#12): the player now cycles through Off, Loop queue, and Loop current track without unnecessarily resolving the repeated track again.
• Collapsed Settings alignment (#13): the Settings control now fills the collapsed sidebar width consistently.
• Session-card polish (#14): shorter action tooltips, a clearer compaction icon, outlined tooltip arrows, right-side full-title tooltips, current Git branch and relative activity, and whole-row drag-to-reorder behavior.
• Stable code-copy control (#15): horizontal code scrolling no longer moves the copy button.
• Pi theme support (#16): Fate UI can discover Pi's bundled, global, package, and trusted-project themes and map them into the Fate theme contract. Theme discovery is bounded, cached, trust-aware, and does not install missing packages.
• Reliable continuation after compaction/output limits: a length-truncated assistant turn now resumes automatically instead of stopping after conversation compaction. Continuations are bounded, stale-session safe, and never inserted behind an already queued user request.
• Compaction telemetry: a newer compaction can no longer leave an older token estimate displayed.

Behavior, migration, and known limitations

• Existing settings migrate automatically. Image generation defaults to Automatic and does not change the selected chat model.
• generate_image remains available in Read only mode because it does not modify the active project. It can still make a billable network request and write under Pi's generated-images directory.
• Custom image providers must expose an OpenAI-compatible /images/generations endpoint that returns base64 raster data. HTTPS is required except for localhost, 127.0.0.0/8, and ::1.
• OpenRouter currently chooses exact image dimensions and quality according to its selected model; Fate UI still validates the returned raster format and bounds.
• Pi themes map Pi's larger terminal palette into Fate UI's 18 semantic tokens. The Pi CLI's currently selected theme is not selected automatically, and theme files do not hot-reload; restart Fate UI or switch project context to refresh discovery. Project-local themes are available only after the project is trusted.
• Public beta installers remain unsigned, so Windows SmartScreen and macOS Gatekeeper may show an unknown-publisher warning.

Testing status

This prerelease is gated by the full local pnpm verify suite (strict TypeScript, Vitest unit/integration tests, and Playwright Electron E2E) plus a production build. The GitHub Actions release matrix repeats verification and then builds, installs or mounts, and smoke-tests fresh packages on Windows x64, macOS Apple Silicon, macOS Intel, and Linux x64. Publication requires exactly seven versioned installers, packaged Pi-theme smoke markers, and a verified SHA256SUMS file; no prior-release installer is reused.

Thanks

Thank you to @KiKaraage for the detailed reports, screenshots, and product feedback behind issues #11–#16.

Fate UI v0.5.1-beta2

Fate UI 0.5.1 beta 2 is a cross-provider compatibility and observability release.

Highlights

Broader OpenAI-compatible provider support

• Reworked the subagent_manage and subagent_workflow function definitions into portable object-root JSON Schemas.
• Fixes empty successful responses from gateways that do not accept top-level anyOf tool parameter schemas, including the observed Crof behavior.
• Keeps action-specific validation inside Fate UI, so orchestration behavior remains strict without requiring provider-side union support.
• Providers that already support schema unions continue to work normally; Fate UI now sends the more broadly compatible schema form to every provider.

Token and cache telemetry

• Added a full Context dashboard for live context pressure, session token traffic, cache coverage, output and reasoning composition, estimated cost, and recent active-branch response history.
• Uses bounded, provider-reported token data with strict IPC validation.
• Separates uncached input, cache reads, cache writes, output, and reasoning subsets to avoid misleading totals.

Interface and reliability polish

• Refined extension-status placement and hover behavior without shifting the conversation layout.
• Added regression coverage for provider-compatible tool schemas and token telemetry.
• Hardened timing-sensitive desktop E2E assertions without enabling blanket test retries.

Downloads

• Windows x64: NSIS installer (.exe)
• macOS Apple Silicon: .dmg and .pkg
• macOS Intel: .dmg and .pkg
• Linux x64: .AppImage and .deb
• Integrity: SHA256SUMS

Verification

Every platform artifact is built from the same v0.5.1-beta2 tag. GitHub Actions runs type checking, 611 unit/integration tests, the production Electron E2E flow, native dependency checks, unpacked-package smoke tests, installer creation, and platform-specific install/mount/run smoke tests before publication.

This is a prerelease. Existing settings and sessions are preserved during a normal upgrade, but closing Fate UI before installing is recommended.

Fate UI v0.5.1-beta1

Fate UI 0.5.1 Beta 1 introduces Fate Flight Deck, a clearer way to understand what Pi and its agents are doing while work is in progress and while reviewing changes.

What's new

• Activity Pulse — see the current runtime state, active and queued work, context usage, changed-file count, and whether Fate is thinking, testing, editing, waiting, or ready.
• Flight Recorder — inspect a bounded, chronological history spanning the root agent, legacy subagents, and Agent Teams V2, with navigation back to retained tools, messages, runs, and team activity.
• Review Runway — move through current Git changes and connect changed or renamed files to the agent and direct file operation that produced them when verified provenance is available.
• Structured tool provenance — Fate now records validated actor identity and project-relative paths for direct read, write, and edit operations instead of guessing from model text or command output.
• Reliability improvements — tighter event ordering prevents stale or duplicate events from replacing newer state, interrupted child restoration is safer, and review navigation/state cleanup is more predictable.
• Workspace polish — improved pane resizing, review shortcuts, inspector navigation, and conversation auto-scroll behavior.

Downloads

All installers below were built and smoke-tested on native GitHub-hosted runners:

• Windows x64: NSIS .exe installer
• macOS Apple Silicon: .dmg and .pkg
• macOS Intel: .dmg and .pkg
• Linux x64: .AppImage and .deb

Use the attached SHA256SUMS file to verify downloads.

Beta notice: These public beta installers are currently unsigned. Windows SmartScreen or macOS Gatekeeper may show an unknown-publisher warning.

Full changelog: v0.4.1-beta2...v0.5.1-beta1

Fate UI v0.4.1-beta2

This beta adds a lightweight manual update check and strengthens multi-agent workflows, session reliability, repository safety, and cross-platform packaging. It remains prerelease software, so keep a backup of important project work.

Highlights

• Added a subtle Check for Updates action in Settings. It runs only when clicked, compares semantic versions, and directs users to the official Releases page when a newer build is available.
• Added explicit recovery messages for missing or invalid local version data, unavailable update checks, and invalid remote version data.
• Added a packaged PRODVER file on Windows, macOS, and Linux. Build and release validation now prevent the app version, installer metadata, release tag, and PRODVER from drifting apart.
• Added the Agent Teams V2 runtime with nested team coordination, scheduling, persistence, collaboration tools, and legacy-compatible contracts.
• Added desktop controls and clearer runtime status handling for nested agent-team workflows.
• Improved the conversation timeline by grouping repeated subagent wait updates while preserving failed and interrupted waits.
• Prevented stale subagent checkpoints from reopening completed work and stopped empty sessions from multiplying in the sidebar.
• Expanded local image support to files outside the current project.
• Hardened Git repository detection by rejecting nested Git roots before repository status is read.
• Expanded unit, end-to-end, package, and installer coverage across supported platforms.

Downloads

• Windows x64: assisted .exe installer with an optional fate terminal command.
• macOS Apple Silicon and Intel: .dmg and .pkg installers. The PKG also installs the fate command.
• Linux x64: portable .AppImage and Debian .deb packages.

The installers are unsigned, so Windows SmartScreen or macOS Gatekeeper may show an unknown-publisher warning. Verify downloads with the included SHA256SUMS file.

Full changelog

Fate UI v0.4.1-beta1

This beta is a substantial update to agent workflows and the composer. It is still prerelease software, so keep a backup of important project work.

What changed

• Fate UI can now launch and manage subagents as separate sessions. You can choose their models, reasoning levels, tools, skills, retries, fallbacks, and permissions.
• The Agents inspector shows child transcripts, tool activity, usage, workflow state, and controls for steering, retargeting, follow-ups, renaming, stopping, and closing sessions.
• Agent handles now autocomplete with @. Runtime, idle, turn, and budget limits report back to the parent instead of silently stopping the child.
• Project files and folders now autocomplete with #. Folder tags include nested files, while quoted tags handle paths containing spaces.
• Unfinished messages now stay with the project and session where they were written. Switching sessions no longer flashes text from another draft or loses the current one.
• Fixed a caret timing bug that could insert an agent or project tag in the wrong place.
• Cleaned up the Diff and History switch in the Git panel.

Downloads

• Windows x64: assisted .exe installer with an optional fate terminal command.
• macOS Apple Silicon and Intel: .dmg and .pkg installers. The PKG also installs the fate command.
• Linux x64: portable .AppImage and Debian .deb packages.

Every installer in this release passed its native build, install, and smoke checks. The beta installers are unsigned, so Windows SmartScreen or macOS Gatekeeper may show an unknown-publisher warning. You can verify each download with SHA256SUMS.

Full changelog

Fate UI v0.1.0-beta.2

Full Changelog: v0.1.0-beta.1...v0.1.0-beta.2

Fate UI v0.1.0-beta.1

First public beta of Fate UI.

Installation

Windows x64:* download and run Fate-UI-0.1.0-beta.1-Windows-x64.exe.

• The installer is currently unsigned, so Windows SmartScreen may show an unknown-publisher warning.
• Verify the download with SHA256SUMS if desired.

macOS and Linux\nPrebuilt packages are temporarily unavailable. Build this tagged source natively by following the README instructions.

Beta notice

This is beta software. Expect rough edges and back up important work.