更新日志

同步自 GitHub Releases

v0.6.8

This release adds a conversation minimap, safe session archiving and paged catalogs, and per-turn output speed. It also upgrades Pi SDK to 1.5.1 and improves large-text reopening without truncating messages.

Breaking Changes

  • Prompt-cache warming now defaults to Including idle time when no preference is saved, following Pi SDK 1.5.1; the previous default was Active runs only. Valid saved preferences are retained. Warming can incur additional API charges—review Settings → General → Prompt cache warming for each execution environment and choose Off or Active runs only if preferred.
  • Update remote runtimes alongside the desktop. The remote event contract is now v8; SSH / LAN sessions require a matching runtime. (#169)
  • Pi extension authors should verify their extensions' compatibility with SDK 1.5.x. (#177)

New Features

  • Conversation minimap: one tick per user message, hover previews, click/drag scrubbing, Alt+↑/↓, and on-demand jumps into unloaded history. Long conversations use a bounded message window. Thanks @Feli999. (#161)
  • Safe session archiving and paged catalog: archive management, explicit restore, and protection for running, queued or approval-blocked sessions. Offline remote environments retain cached views but disable pagination and writes. Permanent deletion remains irreversible. (#169)
  • Open local project folders from their sidebar menu using Finder, File Explorer or the system file manager. The action is hidden for SSH projects and daily space. (#175)
  • Per-turn output speed: show average tokens/s after a turn completes, calculated from output tokens and model-request time, excluding tool execution. Omit the value when historical usage is unavailable. (#173)

Changed

  • Updated bundled Pi SDK to 1.5.1, including adapter and patch updates for lifecycle cleanup, historical costs and media references. (#177)
  • Improved large-text reopening by conservatively bypassing general parsing for unambiguous final plain paragraphs while retaining the renderer's DOM, full-text selection and native find. Original messages, exports and model data are not truncated. (#177)
  • Added isolated performance runs, durable checkpoints and explicit, compatible baselines. Missing legacy measurement fingerprints remain reference-only rather than being mixed into new trends. Local measurements are not a cross-platform performance guarantee. (#177)
  • The optional session rail and its appearance switch are temporarily hidden, with saved preferences retained. The conversation minimap remains available.

Fixed

  • Missing replies or stuck Thinking / Stop after session unload/reopen, and live replies being overwritten by history replay. (#166)
  • Context usage from the previous model appearing after a model switch. (#167)
  • Referenced user-message collapsing, mount-time expand/collapse flashes and unstable consecutive deletion animations. (#155, #173)
  • Streaming code fences degrading to plain text, hidden copy buttons on single-line blocks, and platform-specific file-manager labels. Thanks @Feli999. (#159, #162, #160)

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.7...v0.6.8

v0.6.7

New Features

  • Faster long conversations: recent history loads first, images load on demand, and folded tool and change details no longer stay fully mounted. Long-running tool output does less repeated rendering while the existing animations remain in place. (#153, #154)
  • Code Mode: enabled by default so the agent can compose tool calls in scripts. Settings → General offers a Code Mode switch and an optional Code Mode only setting, off by default and applied to new sessions or after restarting the app. Tool permission checks still apply inside scripts. (#152)
  • Development subagents: the built-in worker can read, edit, write and run commands, with the parent project's working directory and permission policy. Individual workers can be inspected or stopped without stopping the rest of a batch. (#145)

Breaking Changes

  • The ToolCallCard UI-plugin slot and its public API have been removed. A plugin that declares this slot is rejected as a whole, even if it also provides other slots or contributions. Remove the declaration to use its remaining supported capabilities; tool calls now always use the built-in cards. User plugin files are not rewritten automatically. SubagentCard, TodoPanel and other supported contributions remain available. (#154)
  • Display-only screenshots can now be stored in session-owned media files outside the session JSONL. For a complete backup, copy the whole agent data directory or use a self-contained JSONL/HTML export; copying a reference-bearing JSONL alone is not enough. Do not downgrade sessions using this format to a version that cannot read it. User attachments and read-tool images keep their existing model-input behavior. (#153)

Added

  • Added screenshot maintenance and recovery from the session menu. A read-only preview shows the projected active-file size, backup size and additional space required. Explicitly confirmed maintenance keeps a separate original backup; recovery refuses to overwrite a session that has since changed. Backups are retained, so a smaller active file does not mean the same reduction in total disk usage. (#153)
  • Added prompt cache warming controls and actual session status in Settings → General: Off, Active runs only, or Including idle time. Active runs only is the default, and changes synchronize to loaded main sessions in the selected environment. Refresh requests can incur additional costs. (#152)
  • Installed npm extension packages now show their installed version and an available-update badge when a newer registry version is found. This is informational; it does not automatically update packages. (#146 by @Feli999ovo)
  • Added permissionMode and deny rules to custom subagent definitions. A definition cannot elevate a parent running in default permission mode; child Git operations remain read-only even in full access. (#145)
  • Enabled grep, find and ls in the default tool selection while preserving explicitly configured tool lists. (#152)

Changed

  • History is loaded in complete-turn pages. Scrolling upward fetches older history without replacing active output, queues or pending interactions; UI paging does not shorten the model's context. (#153)
  • History images use on-demand thumbnails near the viewport and fetch original images when opened. Read-only subagent inspection shares the real running source instead of creating a second SDK instance. (#153)
  • Closing or folding heavy details releases their content after the existing exit animation. Filters, expanded cards, expanded-all state and source scroll anchors survive ordinary session switches, then clear when the session is closed or reclaimed; they are not saved across app restarts. (#154)
  • Subagent cards use compact Worker N labels and typing dots, with terminal status and click-to-inspect behavior preserved. Detailed child-session events are sent to the UI only while that session is being viewed; the worker keeps running in the background. (#148, #151)
  • Provider settings use a two-column card layout, shared dropdowns and compact help tooltips. Opening settings now lands on General. (#141, #152)

Fixed

  • Fixed pasting files from the system file manager inserting only a filename. File and folder references now use native paths, insert at the current caret or selection, and support undo and mixed file/image pastes. Remote sessions still reject local file references while accepting supported image attachments. (#123 by @worable233)
  • Fixed OpenAI subscription login losing its device ID across restarts. (#150)
  • Fixed custom OpenAI-compatible provider roots that require /v1, and corrected discovered model capabilities and provider-specific thinking-level mappings. Endpoint or protocol mismatches now have a clearer error. (#141)
  • Fixed the retry hint remaining visible after meaningful thinking or response output resumes, and simplified the reconnect presentation. (a97da74)
  • Fixed the composer briefly appearing idle between tool calls, during compaction continuations or automatic retries. Existing stop, queued-send and rejected-draft behavior is preserved. (#154)
  • Fixed selected tool output losing its selection when that same output is appended. Folding also clears selections that cross an entire detail region, and repeated file navigation no longer lets an old highlight clear a new one. (#154)
  • Fixed stale history, image and navigation responses interfering with newer session views. Paging, late image sizing, change navigation and restored browser state preserve their source ownership and scroll anchors. (#153, #154)
  • Fixed media ownership and durability around session forks, exports, deletion and recovery, including Windows file locks and interrupted maintenance transactions. Missing or inconsistent originals fail explicitly instead of producing a successful export with missing images. (#153)
  • Fixed sweep animations continuing to measure layout after an animating target had been removed. Static geometry is reused without replacing the existing visual effects. (#154)

Removed

  • Removed the built-in read-only scout role in favor of the development worker. Omit agent to use the default worker, or provide a custom definition for a specialized role. (#145)
  • Removed the context-evaporation on/off setting. Context evaporation is always enabled, and legacy disabled settings no longer turn it off. (#141)

Downloads: macOS Apple Silicon / Intel, Windows x64, Linux x64 AppImage, and Linux SSH runtimes for x64 / arm64 are available below, together with checksums and verification reports. macOS packages use ad-hoc signing and are not notarized; the update button opens this page for manual installation. On Linux, make the AppImage executable before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.6...v0.6.7

v0.6.6

Changes

Run projects on a server over SSH (experimental)

One window can now use local projects and a connected server side by side. Add a project as a local or remote project; sessions, drafts, settings, approvals, Git actions and exports stay bound to the environment they belong to, and a server icon marks where each project lives.

The full backend runs on the server: models, tools, extensions, MCP servers and subagents use that machine's configuration and resources. If the connection drops, work continues on the server instead of falling back to local execution, and pending questions are restored before you can answer them. Cached remote sessions stay readable while the connection is offline.

Connect through Settings → SSH connection by picking a local SSH alias or typing one. Percho downloads the matching Linux runtime, shows its version and target directory, and only installs after you confirm. Stopping is explicit: the service reports when it has actually exited, and a crashed or unreachable service is never silently re-run.

Worth knowing: this is a first, experimental version limited to one server. It requires non-interactive SSH authentication prepared in an external terminal (Percho does not handle passwords or first host fingerprints), and a Linux host with Node ≥ 22.19 and glibc 2.35+. There is no remote file browser, download or interactive terminal yet, and Windows/Linux SSH interaction still needs platform acceptance.

Percho data gets its own directory

Local agent data now lives in ~/.percho/agent (development and Beta builds use ~/.percho/agent-dev and ~/.percho/agent-beta), separate from the Pi CLI's ~/.pi/agent. On first launch Percho offers to copy existing data after verifying it, or to start empty. Copies are written next to the target and only published once checked; the source is left untouched, stored history keeps its exact bytes, and an existing target is never merged or overwritten without an explicit decision. Startup shows progress while it scans or copies, migrated installs go straight to the splash screen, and failed copies stay on disk for recovery.

A rebuilt composer

The message composer now keeps skill and file references where you insert them, shown as inline capsules in the text rather than collected at the end. Queued messages, drafts, restoration after a rejected send, images, forks, history replay and HTML export all follow the same document, and the skill snapshot sent to the model is stored with the original text.

The composer also has a native Cut / Copy / Paste / Select All menu that applies to what you have selected, and focus returns to the editor after inserting a selection reference. Subtle height and spacing adjustments make a single line of input sit better in the frame.

Composition with native Windows input methods in the rebuilt composer still needs manual verification on real hardware.

Desktop task notifications

Settings → General → Desktop task notifications (on by default) notifies you when a run finishes while the window is in the background. Only a final success or failure counts: cancellations, pauses, retries and stale events from an old connection are ignored. Clicking a notification returns to that session and its environment. A test button reports honestly that the request was submitted, since visibility still depends on system notification permissions and Do Not Disturb.

Models from your own provider

Custom providers can fetch their model list from the configured endpoint, using the stored credential when the key field is left empty. Context window, maximum output, reasoning and image support are filled in from the SDK's built-in catalog when the ID is recognized, so a picked model usually needs no manual numbers. Model IDs also offer a filtered dropdown that shows which capabilities each candidate will bring.

Settings selects — provider protocol, subagent model and reasoning depth — now use the same menu as the rest of the interface instead of the platform control.

Compaction before every request

Automatic compaction is now checked before each model request, including the first message, tool continuations and retries, and it takes the earlier of your percentage threshold and the SDK's effective margin. If a summary request fails it is retried a bounded number of times; if compaction cannot make progress, the run pauses with its queue intact and tells you, and your next message delivers the queued requests in order. Stopping, branching or switching models never resumes a paused run on its own.

Startup, appearance and chat polish

  • The sidebar starts collapsed on every launch; manual toggles, grouping and width are still remembered.
  • Restarting lands on a blank conversation, with history one click away.
  • A missing compatible Node version on the target of an SSH connection is explained in your language, with the raw error kept in expandable details.
  • The empty state, project picker and composer proportions are simpler, and the app icon has been redrawn as a square pyramid.
  • Appearance settings use icon tabs for themes and an animated dropdown for text sizes, and they respect reduced motion.
  • Markdown tables drop the outer border, the column rules and the header fill, keeping only horizontal dividers and comfortable row spacing.
  • Fenced code blocks no longer show an extra blank line at the end, while blank lines you wrote yourself are kept.
  • Percho Beta and Percho Dev are separate applications with their own identity, badge and data directory; Beta does not use the stable update channel.

Under the hood

  • Percho runs on Pi SDK 1.4.0, with manual retry of a failed response still preserving history and completed tool results.
  • Beta builds are versioned (0.6.6-beta.N) and desktop packages plus both Linux runtimes are built from one version and commit, verified as a complete bundle, and only then published.
  • Switching to a cached remote session while SSH is offline no longer shows a load error.
  • UI plugin builds on Windows resolve the correct unpacked esbuild binary. Thanks to @gezerui888 for the fix. (#130)
  • A fresh development install now downloads the Electron binary in postinstall. Thanks to @Dafeigy. (#115)

Thanks to @worable233 for upstream model fetching and the shared settings menus, and to our testers for checking remote, migration and notification behavior on real machines.


Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.5...v0.6.6

v0.6.5

Changes

More reliable context compaction

Percho now triggers automatic compaction based on a percentage of the model's context window, instead of a fixed token margin. This makes compaction work more consistently across models with different context sizes, including models with very large context windows.

The summary input is bounded to reduce the risk of compaction getting stuck on an oversized request. Compaction also backs off when it is not making progress, and records why a trigger was skipped to help diagnose behavior. (#106, #107)

Better cross-session workflows

  • See a session's active channel subscriptions at a glance, and return from a subagent to its parent session with a dedicated back button.
  • Session page transitions are smoother when switching between sessions.
  • The model catalog refreshes automatically when you open Settings → Models. The former LAN Observation settings section is now called Cross-device Connection.

Retry failed model requests

You can retry a failed model response without sending your user message again. Desktop sessions also retain discovered APPEND_SYSTEM.md prompts when loading project resources. (#111)

Windows update diagnostics

If an update fails to install on Windows, Percho now keeps a local diagnostic record and provides recovery guidance. The report is not uploaded automatically and excludes session contents and secrets. It may include local paths, so review it before sharing.

This improves visibility into update failures; it does not claim to identify or fix every underlying installer failure. (#104, #105)

Chat and usability improvements

  • Long user messages can be collapsed and expanded with an animation.
  • Project names display more consistently for Windows paths.
  • Thinking indicators and work animations no longer show during compaction.

Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.4...v0.6.5

v0.6.4

Changes

Resize the sidebar along its full edge

This patch fixes a noticeable regression in 0.6.3: when the session list needed to scroll, dragging the sidebar's right edge could work near the search box but fail throughout the list below it.

The resize handle now stays above the list's scroll-edge fade, so the full edge remains available for dragging. Its appearance, hit area and saved-width behavior are unchanged. (#100)

Hidden providers stay hidden when new models arrive

Hide all models in Settings → Models now remembers a provider-wide default, rather than only hiding the models known at that moment. Newly added models stay hidden too.

You can still hide everything and then enable a few individual models. Those choices are remembered across restarts without allowing other new models into the picker. Choosing Show all models clears the provider's hiding policy and model exceptions.

Rapid preference changes and failed saves no longer let older responses overwrite newer choices. Hiding a model does not change the model already selected in a conversation or interrupt running work. (#101)

After updating: existing per-model hidden lists keep their previous meaning. If you previously hid every model from a provider, choose Show all models, then Hide all models once to establish the new provider-wide default. macOS runtime checks and CI passed; Windows 11 runtime verification of the reported sidebar case is still pending.


Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.3...v0.6.4

v0.6.3

What's new

Manage MCP servers without leaving Percho

A new Settings → MCP panel lets you add, edit, remove and reconnect servers, including importing JSON configuration. Global and trusted-project configurations stay in their existing mcp.json files. Each server shows its connection state, available tools and tool-exposure setting; authorization links appear when supplied by the server.

Percho now runs on pi SDK 1.0.4, with the SDK's built-in MCP, tool-search and codemode extensions integrated. New server entries use deferred tool exposure by default. Under the default permission mode, third-party tools without a read-only annotation ask for confirmation unless an explicit rule says otherwise.

Reconnecting skips conversations with running work instead of interrupting them. The panel reports which conversations were refreshed and which were skipped.

Text sizes that suit the way you read

Settings → Appearance → Basic now has independent controls for interface and code text, with four presets for each. Interface text covers navigation, conversation prose, settings and menus; code text covers code blocks, inline code, diffs and Mermaid source views.

Changes apply immediately and are remembered across restarts. The default presets keep the previous appearance, while icons and layout dimensions stay at their existing sizes.

A sidebar and window that fit your workspace

Drag the sidebar's right edge to give session names more room or return more space to the conversation. Its width is remembered and adapts when the window gets smaller.

Percho also remembers the window's normal position and size. Restoring a window checks the available screens, so disconnecting a monitor does not leave it outside the visible desktop; maximizing does not overwrite the saved normal dimensions.

Screenshots without the same waiting

Sending an image now shows your message immediately instead of leaving a blank gap while the attachment is processed. Large attachments are prepared when you paste or select them, and the immediate message is reconciled with the saved one without adding a duplicate.

History uses small, asynchronously decoded thumbnails only around the visible part of the conversation. Images outside that range return to same-size placeholders, and clicking a placeholder or thumbnail opens the original. Preview keeps only the current original image loaded, with arrow-key navigation for multi-image messages.

This reduces display work in screenshot-heavy conversations without rewriting their stored images. Mac stress tests showed substantially shorter stalls; the reported Windows freeze/white-screen case still needs platform-specific verification.

Changes

Commands and history match what you see

  • Slash commands with the same name across sources now appear only once, using the entry that execution will actually reach. Mouse selection, Enter and Tab agree with the highlighted command.
  • Recalling a user message that has not received a reply also refreshes the model context, avoiding a message that disappears from the screen but remains in context.
  • Task lists survive context compaction and reopening a conversation.
  • Renaming a new conversation before its first message is saved no longer reports an error; existing conversations are located directly rather than by scanning every session directory.
  • Turn timing and file-change summaries stay before trailing system notices, so a compaction divider no longer obscures the timing row.

Thanks to @MrTangLuyao for the slash-command fixes and their Windows validation.

Quieter tool summaries and cleaner shutdown

  • MCP calls are grouped by server in completed-work summaries — for example, blender ×3 — while individual calls remain available in the expanded details.
  • Closing or unloading a session notifies its extensions before disposal, allowing MCP server processes to shut down instead of remaining alive until Percho exits.
  • Thumbnail requests, object URLs and observer registrations are cleaned up when images leave the loading range or conversations are switched.

A more consistent settings interface

Settings and related dialogs use softer, borderless layering and fading dividers. Login dialogs now cover the full window instead of being clipped by a settings panel's scroll mask.

Worth knowing: MCP server commands may need absolute executable paths when launched from a desktop app. Remote MCP OAuth has not yet been verified end to end. Historical originals remain in the conversation data, so thumbnail loading does not promise a fixed total memory footprint. A small, pre-existing one-row scroll backstep during history expansion remains under observation.


Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.2...v0.6.3

v0.6.2

What's new

A workspace for the conversations you're using now

The title bar is now a temporary session workspace rather than a pinboard. Opening, creating or forking a conversation adds it next to the session you were just using; drag the pills to arrange them, and use × to remove one from the workspace without closing the session or interrupting its work. Pinned conversations remain long-term favorites in the sidebar, independent of this working set.

The workspace remembers its order across restarts and restores only the active conversation on demand. Other members stay available without loading every session into memory. Rename and context-menu actions also work for members that have been unloaded.

An optional left-side session rail offers the same workspace in a compact vertical form. Hover or focus a marker to expand its conversation pill, use arrow keys to move between members, or remove one with Delete or Backspace. Enable it in Settings → Appearance; the rail and title-bar session display can be toggled independently.

Worth knowing after the update: pinning no longer adds a conversation to the title bar. Open it from the sidebar to add it to the workspace. Turning off both workspace displays clears that working set, but does not delete conversations or stop running tasks.

One sidebar scroll, with history revealed as you need it

The sidebar now has one continuous scroll instead of separate scroll areas inside each project. Each group starts with six sessions; Show more reveals another sixteen at a time, keeping large projects from overwhelming the navigation without trapping wheel input inside a group.

Search uses the full session catalog, not just the currently visible batch. Clearing a search restores your previous group and visibility state. Group headers, the new-conversation action and the settings entry keep their familiar positions.

Model and thinking depth, in one place

The model picker now includes a thinking-depth slider at the bottom. Choose a model and adjust its supported reasoning level in the same panel, without reopening two separate menus. The composer chip shows both choices, and models with only one supported level display a disabled single-level control.

Chinese labels where they belong

Built-in tool names now follow the interface language in tool cards, live activity previews and completed-work summaries. Built-in slash commands also have Chinese names, descriptions and argument hints, and can be searched by their Chinese names. The actual /compact, /name, /export and /settings commands are unchanged; skills, templates, MCP and extension names stay as supplied.

Image-display calls remain available in the folded tool details but no longer repeat show_image in the completed-work summary — the image itself already shows the result.

Changes

History and links stay where they belong

  • Relative file links in Markdown open through the system instead of navigating the app window away from the conversation. Web links open in the browser.
  • Restored channel subscriptions wait for the initial history to be ready before delivering wakeups. A startup wakeup can no longer replace the conversation's earlier messages with only its newest response.
  • Context-compaction dividers and their summaries remain visible after reopening a session. Manual compaction no longer adds a redundant notice above the composer.

A quieter, more consistent interface

  • Model and permission selectors share the title bar's pill-shaped interaction style.
  • Scroll-edge fades replace hard separators around the title bar and sidebar footer; the sidebar divider fades at both ends.
  • Clicking empty space inside the composer focuses the text field, and long input uses a slimmer scrollbar.
  • Workspace pills and rail markers animate smoothly as conversations are added or removed, while respecting reduced-motion preferences.

Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.1...v0.6.2

v0.6.1

What's new

Busy projects no longer take over the sidebar

Daily and project groups now keep their session lists to eight visible rows. Longer lists scroll inside their own group, with subtle edge fades showing when more history is available above or below. Group headers stay in the main sidebar flow, so scrolling on a header still moves the full navigation instead of getting trapped in an empty inner scroller.

Expanding and collapsing a group now uses a restrained height-and-opacity transition. Collapsed content is no longer reachable by keyboard or pointer input, and reopening a group starts its list from the top. A new-conversation action is also available directly from the sidebar, with the same behavior as the title-bar action.

Session names and history stay complete

Automatically generated session titles now remain in the sidebar catalog after an idle session is unloaded from memory. Opening and unloading a session can no longer make its row fall back to an older or generic title.

History replay now reads the complete session tree rather than the compacted model context. Compaction can still reduce what is sent back to the model, but it no longer hides earlier messages when you reopen the conversation in Percho.

Drop files straight into the composer

Files dragged from Finder, Explorer or a Linux file manager can now be dropped anywhere in the writable conversation window and attached through the existing @file flow. Percho resolves native paths through Electron's sandbox-safe preload bridge, ignores invalid entries and removes duplicates without changing the original path.

Thanks to @YIKUAIBANZI for reporting and implementing the native file-drop path.

Changes

Safer window and sidebar behavior

  • On Windows, closing the window now asks for confirmation when Percho has running work that would be terminated. macOS keeps its existing close-to-hide behavior.
  • Sessions remain present in the sidebar after automatic memory cleanup instead of disappearing until the next full history refresh.
  • Session rows no longer show a duplicated native title tooltip.
  • Nested sidebar scrolling, fade state and collapse behavior have dedicated automated coverage using real Chromium wheel input.

Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.6.0...v0.6.1

v0.6.0

What's new

A real home for every session

Percho's navigation has moved into a permanent, collapsible sidebar. Recent conversations, project sessions and drafts now live in one searchable place; projects and the Daily group can be folded independently, and the sidebar can collapse all the way to zero when you want the canvas back.

The title bar has a simpler job now: it is a pinboard. Only sessions you pin appear there, in the order you choose, whether or not they are currently loaded. Session rows share the same right-click actions for rename, pin, diagnostics and delete, while project rows can be pinned or removed without leaving the current conversation.

This also changes startup behavior: Percho now opens on a clean new-conversation screen instead of restoring every previously open tab. History is always in the sidebar and loads on demand. Behind that UI, Percho keeps the active session plus up to three recently used idle sessions warm; running work, approvals, queued follow-ups, unread completions, drafts and channel subscriptions are protected from unloading. Reopening an unloaded session restores its messages, todos, queue and permission mode.

New-session state is now one renderer-owned draft instead of a collection of special-case tabs. The draft appears in the sidebar, survives navigation inside the running app, and becomes the real session when the first message is sent. Rapid clicks, duplicate opens and a session being unloaded while you navigate are all resolved with latest-selection-wins semantics, so stale requests can no longer steal focus or leave a ghost active session behind.

Worth knowing after the update: the old tabs.json open-tab list is no longer restored. No conversation data is removed — select any previous session from the sidebar. Per-session permission modes are now persisted, while new and forked sessions still start in Default mode.

Mermaid diagrams and math, rendered in the conversation

Mermaid blocks are no longer source-only cards. Flowcharts, sequence diagrams, state diagrams and the rest of Mermaid 11 render inline, load lazily, and come with a restrained preview/source switch, copy action and full-screen view. Multi-line labels render correctly, and invalid syntax becomes a visible, expandable error card instead of an unexplained blank rectangle.

KaTeX is included explicitly as well, so math renders once, with the right fonts and styles, instead of falling back to source or appearing doubled. Regular code blocks are unchanged.

Session work is easier to control

Several small requests around sessions now have first-class UI:

  • Search models by model name, provider name or id; use arrow keys and Enter without leaving the picker.
  • Rename and pin sessions from their context menu, including historical sessions that are not currently loaded.
  • Open, reveal or copy changed-file paths from both the end-of-turn file row and the diff drawer. Relative paths, file:// URLs and line anchors are normalized against the session's project.
  • Close means hide on macOS: the red window button and Cmd+W keep the app and running sessions alive; clicking the Dock icon restores the same window.
  • Sidebar groups now remember an intentional “everything collapsed” state, new drafts appear where sessions live, and the model picker no longer pushes the whole window sideways on narrow layouts.

Channel collaboration survives unloading and restarts

Channel-watch subscriptions now have real lifecycle semantics. A subscribed session is protected from automatic memory cleanup, and its topics and per-file cursors are persisted. If another agent writes while Percho is closed or the session is not loaded, reopening reconciles the cursor and delivers the missed change exactly once.

The watcher also closes several race windows around startup, unsubscribe, shutdown and self-writes. User-requested close/delete still wins; the protection only prevents automatic cleanup from silently dropping a live subscription.

The diff drawer no longer reshapes a long conversation

Opening file changes used to animate the drawer's width inside the same flex row as the chat. Every frame changed the Markdown column width, reflowed long messages and triggered bottom-pinning work — the more content a session had, the worse the animation felt.

The drawer is now a fixed-width overlay animated only with transform and opacity. In a measured 25-file / 1269-line session, the chat width stayed fixed and the animation triggered zero follow-to-bottom scrolls (down from 42–50). Click the conversation to keep comparing it with the diff; close from the title bar, the drawer button or Escape.

A new Percho identity

The app and LAN observer now use the new monochrome, three-dimensional pyramid mark with golden-ratio construction lines. The empty conversation screen uses the same mark, and both READMEs have a newly designed banner plus a cleaned-up, matching set of product screenshots and demos. Old unused icon and capture assets are gone.

Changes

Faster, safer session plumbing

  • Session state, event forwarding and cleanup now converge on one registry entry instead of parallel maps.
  • The 87 invoke channels have one typed source of truth, from which shared types, preload bindings and main-process handlers are derived.
  • LAN projection runs the same transcript reducer as the desktop renderer, and plugin manifests are validated from one shared definition.
  • Opening a session now applies the same tool whitelist as creating it; optimistic model, thinking and permission changes share rollback behavior.

This is mostly invisible, but it removes several places where create/open paths, working directories, IPC signatures or projected transcript behavior could drift apart.

Smaller fixes and polish

  • Mermaid controls use the same quiet, monochrome interaction language as the rest of Percho.
  • Date-group tests are anchored to local midnight and no longer fail depending on the CI runner's hour or timezone.
  • README feature descriptions, screenshots and Chinese/English image order are synchronized with the current product.

Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead). On Linux, chmod +x the AppImage before first launch.

Full Changelog: https://github.com/Jaxton07/percho/compare/v0.5.8...v0.6.0

v0.5.8

What's new

Scrolling back through a long session — no more being pulled to the bottom

Fixes a regression introduced in 0.5.7. Open a session you've been running for a while and scroll up into its history, and the view kept dragging you back down to the newest messages. The mount window that made session switching instant had also taken scroll anchoring away from the browser and done the compensation by hand — and the hand-rolled version only knew the height that was inserted at the exact moment of the update. Markstream's rows arrive in two steps (a 600px placeholder first, their real height 100–300ms later — a real long session collapses by ~4400px while it settles), so every settle silently dragged the scroll position down; landing at the bottom then re-armed "follow", which pinned the view there.

Scroll anchoring belongs to the browser again: it compensates both the rows inserted above the viewport and the heights that settle afterwards. The hand-rolled path is down to one real gap — Chromium does not adjust the anchor when the scroll offset is exactly 0 (there is nothing above to adjust to), where a drift check fills in the difference and does nothing otherwise.

Measured with real wheel events (55 steps of scrolling up, asserting that the row at the top of the viewport only ever moves toward earlier messages): the 0.5.7 build violated that 11 times, this build 0 times. Switching between sessions is still instant (first frame 37–51ms on long real sessions), and a bottom-pinned view still stays pinned while new messages stream in.


Download: macOS (Apple Silicon / Intel) · Windows x64 · Linux x64 (AppImage) — see assets below. Existing installs will offer the update from the title bar or Settings → About (on adhoc-signed macOS builds the button opens this page instead).