Skip to content

Releases

Patterm 0.5.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 10:45
0a46f73

Patterm 0.5.0

  • Organise agents and processes into folders shared across your desktop and
    browsers. Folders replace pinned tabs and fit into the sidebar's sort order.
  • Integrated agents can set and track native goals from the composer.
  • Agents can publish reusable HTML figure templates and show local videos in
    figures. Figure-only replies now fill the conversation column correctly.
  • The notifications tray has an Unread tab, and its bell is available on phones.
    You can also disable user-facing subagent notifications.
  • OpenCode agents keep Patterm's tools when a session moves, and undelivered
    steering messages can be sent again or dismissed.
  • Secrets expire after 24 hours by default, with longer lifetimes available.
    Existing secrets expire on upgrade because their creation time was not
    recorded; agents can ask for them again.

See CHANGELOG.md for the full list of changes since 0.4.0.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Remove the sidebar's New bot button by @hjbdev in #189
  • Name OpenCode model providers in every model selector by @hjbdev in #191
  • Bring bot pages in line with agent pages by @hjbdev in #192
  • Tidy a phone's Library: close the gap and drop detail lines by @hjbdev in #190
  • Guide all bots to delegate substantial work by @hjbdev in #193
  • Fix reliable bot child notifications by @hjbdev in #194
  • Let bots handle routine notifications without acknowledgement by @hjbdev in #195
  • Keep OpenCode subagent stream rows nested across mid-run snapshots (ENT-207) by @hjbdev in #197
  • Play local videos in HTML figures (ENT-206) by @hjbdev in #196
  • Flag OpenCode messages that never reach the agent (ENT-208) by @hjbdev in #199
  • Restart and resume moved OpenCode sessions where they are by @hjbdev in #200
  • Draw the installed app's top bar in the title bar by @hjbdev in #198
  • Slide sidebar agents when recent activity reorders them by @hjbdev in #201
  • Expire Patterm secrets after 24 hours by @hjbdev in #202
  • Let secrets last longer than a day when the user chooses by @hjbdev in #203
  • Redesign the secret form around how the agent can use it by @hjbdev in #204
  • Native goals in Integrated conversations by @hjbdev in #205
  • Restore Patterm's OpenCode tools where a moved session is now by @hjbdev in #206
  • Add setting to mute subagent notifications and unread dots by @hjbdev in #207
  • Show agent and subagent work with one spinner by @hjbdev in #208
  • Reuse successful code-block highlighting during streaming by @hjbdev in #209
  • Idle compaction for OpenCode's Claude Agent provider by @hjbdev in #210
  • Notifications tray: Unread tab, and the bell on a phone's top bar by @hjbdev in #211
  • Clean up Codex hosts even when shutdown interruption fails by @hjbdev in #212
  • Folders for agents, replacing pinned tabs by @hjbdev in #213
  • Keep folders among the agents when the list is sorted or grouped by @hjbdev in #214
  • Only file a dragged agent in a folder when it's dropped on it by @hjbdev in #215
  • Let text be selected in scrolling dialogs by @hjbdev in #216
  • Keep the notification tray on the tab you left it on by @hjbdev in #217
  • Leave snoozed projects out of the notification tray's count by @hjbdev in #218
  • Saved, schema-checked templates for html_render by @hjbdev in #219
  • Fix inconsistent widths for inline HTML figures by @hjbdev in #220
  • Prepare Patterm 0.5.0 release by @hjbdev in #221

Full Changelog: v0.4.0...v0.5.0

Patterm 0.4.0

Choose a tag to compare

@github-actions github-actions released this 02 Nov 18:45
e9e6de0

Patterm 0.4.0

  • The assistant joins the other bots in the sidebar. Bots can use voice, Focus
    mode and notification digests, and keep their own harness and model settings.
  • Agents and bots share saved memory across projects, with an optional nightly
    review of new conversation activity.
  • Bots and their helpers are easier to find and message, including bots on
    paired hosts. Bot notifications show their reply and their picture.
  • Agents can pin a configurable status label, such as "Waiting for review".
  • Optional usage telemetry helps you find features you use and those you don't.
    It is off until you enable it with your own PostHog project key.
  • The command palette can launch presets, and the sidebar can sort agents by
    recent activity.
  • OpenCode fixes keep tools available after idle eviction, preserve streamed
    replies, and keep the model and speed pickers in sync. Codex conversation
    history and model selection are more reliable too.

See CHANGELOG.md for the full list of changes since 0.3.0, including upgrade
notes for shared memory and OpenCode speed variants.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Show each model's provider in the OpenCode model picker by @hjbdev in #153
  • Spawn presets from the command palette by @hjbdev in #154
  • Sort the sidebar by recent activity by @hjbdev in #155
  • Fix Codex history paging and keep model picks across restarts by @hjbdev in #157
  • Keep synthetic OpenCode inbox items out of the live transcript by @hjbdev in #156
  • Mark timer_set callbacks as Patterm's, not the user's by @hjbdev in #158
  • Show early Codex command output as a command row by @hjbdev in #159
  • Make report timers reliable and wake parents once by @hjbdev in #160
  • Make the assistant the built-in bot, with voice, digests and Focus for every bot by @hjbdev in #162
  • Share the Agents menu's view options across projects, add icons by @hjbdev in #164
  • Insert a period in agent and bot browsers instead of Delete by @hjbdev in #165
  • Share saved memory across every agent, and add a nightly memory review by @hjbdev in #163
  • Show the assistant as a regular bot and remove its panel by @hjbdev in #166
  • Let bots keep their own harness and model settings by @hjbdev in #167
  • Show a bot's face on agent tabs it started by @hjbdev in #168
  • Show bot push notifications as texts from the bot by @hjbdev in #171
  • Add an Attach files button to bot chats by @hjbdev in #174
  • Push memory to bots instead of reading it every turn (ENT-186) by @hjbdev in #172
  • Opt-in usage telemetry to find unused features by @hjbdev in #173
  • Let agents pin status labels on themselves by @hjbdev in #175
  • Restore OpenCode MCP servers after idle location eviction (ENT-192) by @hjbdev in #178
  • Show bot reply previews in turn-finished notifications (ENT-191) by @hjbdev in #176
  • Let agents mention and message bots; remove file @mentions (ENT-190) by @hjbdev in #177
  • Offer agents, processes, and launchers in a bot's @ menu (ENT-187) by @hjbdev in #169
  • Tell bots to close helpers once their work is finished (ENT-194) by @hjbdev in #179
  • Use app tooltips for status labels and show them in the sidebar agent card by @hjbdev in #180
  • Show notification receipts in bot conversations (ENT-188) by @hjbdev in #170
  • List paired hosts' bots beside this host's by @hjbdev in #181
  • Tighten smoke tests and share check preparation by @hjbdev in #182
  • Show agents bots start in their project's sidebar (ENT-193) by @hjbdev in #183
  • Count OpenCode's Claude usage once, as OpenCode by @hjbdev in #184
  • Read OpenCode's model picker from the live session (ENT-196) by @hjbdev in #185
  • Keep OpenCode speed variants as distinct catalog models by @hjbdev in #186
  • Keep streamed OpenCode text across conversation refreshes (ENT-199) by @hjbdev in #187
  • Prepare Patterm 0.4.0 release by @hjbdev in #188

Full Changelog: v0.3.0...v0.4.0

Patterm 0.3.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 02:23
58ec155

Patterm 0.3.0

  • Bots are persistent companions with their own conversations, project access
    and saved memory.
  • Agents can use a session browser, show it beside their conversation and ask
    for help with sign-ins or CAPTCHAs.
  • Session secrets support browser sign-ins, commands and a proxy that adds
    credentials without exposing them to the agent's processes.
  • A new agent header brings worktrees, links, servers and other context into
    chips, with a peek pane for browsers, images and changed files.
  • Phones and tablets get an agent list, page transitions, context sheets and
    controls for moving between agents waiting for an answer.
  • Agent and project snoozing, a canvas of agent families, a simpler launch menu
    and optional local semantic conversation-history search.
  • Faster OpenCode startup and fixes for queued messages, subagent prompts,
    conversation history, browser rendering and service survival under memory
    pressure.

See CHANGELOG.md for the full list of changes since 0.2.9.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Keep agent launch screens loading until navigation by @hjbdev in #110
  • Offer live processes in the composer's @ menu by @hjbdev in #111
  • Add optional local semantic conversation-history search by @hjbdev in #112
  • Explain the semantic search history upgrade in plain words by @hjbdev in #113
  • Replace the board with an agent canvas by @hjbdev in #114
  • Snooze agents and projects by @hjbdev in #115
  • Project logos and working motion on the agent canvas by @hjbdev in #116
  • Remove conversation focus border by @hjbdev in #118
  • Lead canvas cards with the full title and circle working cards with the comet by @hjbdev in #117
  • Show a child's close request as a message from that agent by @hjbdev in #119
  • Fix HTML figure flicker during streamed replies by @hjbdev in #121
  • Fix assistant memory activation and durable recording by @hjbdev in #120
  • Build Integrated history as turns end and keep session titles by @hjbdev in #122
  • Hide internal image hints in Claude subagent conversations by @hjbdev in #123
  • Keep hosts running when the kernel kills a child for memory by @hjbdev in #125
  • Tell agents to link dev server previews to their session by @hjbdev in #126
  • Move agent context into a header, add the peek pane, and make phones list-first by @hjbdev in #127
  • Keep the agent's status line while its summary catches up by @hjbdev in #128
  • Start agents from one list of profiles with faces by @hjbdev in #129
  • Slide phone pages in and out like a native app by @hjbdev in #130
  • Put the notifications bell back in the top bar by @hjbdev in #131
  • Add bots: persistent companions with faces, and show harness icons for profiles by @hjbdev in #132
  • Space stacked dialog buttons on phones by @hjbdev in #133
  • Give each agent its own Chrome, with the user taking over in the peek by @hjbdev in #134
  • Let agents ask for secrets without seeing them by @hjbdev in #135
  • Keep Claude's recorded API requests out of conversation history by @hjbdev in #136
  • Give each bot its own saved memory by @hjbdev in #137
  • Show a bot's browser and session context on its page by @hjbdev in #138
  • Give agent browsers WebGL without a GPU by @hjbdev in #139
  • Centre text in a bot's one-row composer by @hjbdev in #141
  • Surface secret requests in the agent header by @hjbdev in #140
  • Centre the text in session context chips by @hjbdev in #142
  • Fade the transcript out at the composer's edge by @hjbdev in #143
  • Hide OpenCode synthetic instruction rows from live transcripts by @hjbdev in #145
  • Show queued OpenCode messages as greyed chat messages by @hjbdev in #144
  • Install OpenCode's global MCP servers concurrently by @hjbdev in #146
  • Restart a stale OpenCode server on launch while no turn is running by @hjbdev in #147
  • Fix flaky Windows Claude cleanup and host-pairing smoke tests by @hjbdev in #148
  • Keep OpenCode subagent prompts out of the user's messages by @hjbdev in #149
  • Avoid serial OpenCode MCP handshakes on first project launch by @hjbdev in #150
  • Prepare Patterm 0.3.0 release by @hjbdev in #151
  • Keep Claude hosts alive when a viewer disconnects by @hjbdev in #152

Full Changelog: v0.2.9...v0.3.0

Patterm 0.2.9

Choose a tag to compare

@github-actions github-actions released this 16 Oct 23:47
942c409

Patterm 0.2.9

Windows Start menu branding fix:

  • The Windows executable embeds Patterm’s product name, version and icon, so
    Windows lists the app as Patterm instead of Electron.
  • Upgrades remove the old Electron shortcut when its app identity and target
    both identify it as Patterm. The new app also repairs this on launch when
    upgrading through an older in-app updater. Other applications’ Electron
    shortcuts are kept.
  • Start menu and notification shortcuts can launch Patterm.exe directly with
    the installed resources and production data directory.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Fix Patterm appearing as Electron in Windows Start by @hjbdev in #109

Full Changelog: v0.2.8...v0.2.9

Patterm 0.2.8

Choose a tag to compare

@github-actions github-actions released this 16 Oct 23:15
5138795

Patterm 0.2.8

Windows fixes for quitting and updating:

  • Quit exits after managed processes stop even if final resource cleanup reports
    an error. Shutdown dialogs and the debug log include the underlying exception.
  • The desktop launcher runs Patterm.exe. An electron.exe compatibility copy
    remains in the package so older installed updaters can install this release.
  • The installer prepares Start menu shortcuts separately and replaces them
    atomically, preserving the existing entry if setup fails. Running-app errors
    identify the blocking process by PID and executable path.
  • In-app update checks no longer fail with “Digest method not supported” when
    verifying signed release manifests in Electron on Windows.
  • Quit warnings count only agents and commands on the local machine, excluding
    paired hosts.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Fix quit warnings counting paired-host processes by @hjbdev in #105
  • Fix Windows update-check digest failure by @hjbdev in #106
  • Fix Windows shutdown exit, executable name and Start menu updates by @hjbdev in #107
  • Prepare Patterm 0.2.8 release by @hjbdev in #108

Full Changelog: v0.2.7...v0.2.8

Patterm 0.2.7

Choose a tag to compare

@github-actions github-actions released this 16 Oct 22:35
5ae919c

Patterm 0.2.7

Codex now explicitly uses auto-review for eligible approval requests in terminal
and Integrated sessions, including on Windows. The setting applies when launching
or resuming an agent; existing running agents need to be restarted or resumed.

This uses Codex's native auto-review while preserving its configured sandbox.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Enable Codex auto-review and release 0.2.7 by @hjbdev in #104

Full Changelog: v0.2.6...v0.2.7

Patterm 0.2.6

Choose a tag to compare

@github-actions github-actions released this 16 Oct 22:02
a0bcb60

Patterm 0.2.6

This release adds an All agents view across projects and quota forecasts,
and improves agent recovery, activity indicators, and compaction.

Added

  • All agents shows open agents across projects, grouped by project or in your
    own order. Choose which projects appear and launch agents locally or on a
    paired host, with a + button beside each project for quick launches.
  • Usage estimates how much quota will remain at reset, or when it may run out,
    based on your recent pace.

Changed

  • One Show subtitles toggle controls sidebar subtitles.
  • Integrated Claude batches streamed text to the browser every 50 ms.
  • Browser tabs load updated page code after a server update.

Fixed

  • Failed Integrated agents retain their subagent families and can be opened
    for recovery. Restart carries subagents, timers, and session context across.
  • Context usage refreshes after compaction, and idle compaction preserves
    questions and notifications, recovers saved deadlines after restart, and
    handles failures without misleading activity or completion notifications.
  • Agents with background tasks show that they are still working, while
    questions show Has a question and approvals show Needs permission.
  • Auto-summary tokens count in Usage with a separate breakdown.
  • Claude's /model command updates the model shown in its controls.
  • History reads tolerate database initialization by the import worker.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • fix: count auto-summary calls in Usage by @hjbdev in #89
  • Replace sidebar Expand/Collapse all with Show subtitles by @hjbdev in #93
  • Estimate quota pace on the usage page by @hjbdev in #91
  • Show agents waiting on background tasks as working by @hjbdev in #92
  • Show agent questions as questions, not permission requests by @hjbdev in #94
  • Batch Claude's streamed text, follow its /model, reload stale tabs by @hjbdev in #90
  • Keep idle compaction from dismissing requests or losing deadlines by @hjbdev in #95
  • Fix history database initialization lock flake by @hjbdev in #96
  • Reset context usage after compaction by @hjbdev in #97
  • Keep failed agent families visible and recover them with /restart by @hjbdev in #98
  • Fix failed-agent sidebar clicks and historical recovery tabs by @hjbdev in #99
  • Add All agents: every project's open agents in one list by @hjbdev in #100
  • All agents: pick the agent before the project by @hjbdev in #101
  • Keep All agents project launch buttons visible by @hjbdev in #102
  • Prepare 0.2.6 release by @hjbdev in #103

Full Changelog: v0.2.5...v0.2.6

Patterm 0.2.5

Choose a tag to compare

@github-actions github-actions released this 16 Oct 00:27
5de2f37

Patterm 0.2.5

This release improves conversation switching and repeat visits, fixes startup
and terminal exit issues, and moves the assistant button into the bar.

Changed

  • Integrated Claude reuses its model, effort, mode and slash-command controls
    until they change. Conversation snapshots omit the full model and command
    lists, saving tens of kilobytes per snapshot.
  • Opening an Integrated conversation no longer holds up terminal typing in
    the same browser. Returning to an agent within a few seconds reuses its
    worktree diff totals instead of running git again.
  • Conversation history caches up to 24 pages within about 4 MB, evicting the
    least recently read pages first. Long scratchpads reopen from cache too.
  • Paired hosts announce history changes, so linked projects can reuse cached
    remote history. Older hosts continue to be read each time.
  • The browser avoids duplicate update and settings reads when connecting.
  • The assistant button sits in the top bar, or bottom bar on phones, so it
    no longer covers composers, send buttons or terminal text.

Fixed

  • The first browser load after server startup no longer gets script-file
    503 errors that leave the page blank until reloaded.
  • Launching an agent from a browser tab opened before a server update now
    opens the agent instead of leaving the tab on its previous page.
  • Linux terminals retain output read as a process exits, including when
    the terminal is busy drawing a frame. This uses a patched vendored copy
    of alacritty_terminal 0.26.0.

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Open a launched agent even when the launch view can't load by @hjbdev in #82
  • Keep a process's last output when it exits while the terminal is busy by @hjbdev in #83
  • Keep terminal input moving while snapshots load, and stop cold-load 503s by @hjbdev in #81
  • Share history changes between paired hosts and cache their history reads by @hjbdev in #85
  • Bound cached history pages and cache long scratchpads' chunks by @hjbdev in #84
  • Read Claude controls only when their revision changes by @hjbdev in #86
  • Move the assistant button into the bar by @hjbdev in #87
  • Prepare 0.2.5 release by @hjbdev in #88

Full Changelog: v0.2.4...v0.2.5

Patterm 0.2.4

Choose a tag to compare

@github-actions github-actions released this 15 Oct 19:17
13f09e8

Patterm 0.2.4

This release makes agent switching and repeat visits faster by removing serial
requests, caching reads until their data changes, and reading likely destinations
ahead. It also improves Integrated agent activity reporting and MCP connections.

Performance: what changed

1. Show cached context immediately and remove unnecessary requests (#72).
The session context panel stays mounted across agent switches and immediately
shows that agent's previous context while refreshing. Diff totals start from
cached worktrees, allowing the diff read to run without waiting for context.
Todo and scratchpad pickers load only when opened; harness presets load once per
terminal page mount. Project navigation chooses its first tab before mounting a
terminal, and served pages carry their sign-in state, saving a startup round trip.
Terminal frames from the previous agent can no longer displace the new agent's
frames, and the shared-terminal banner waits for control ownership to be known.

2. Read context again only when its project changes (#75).
SQLite triggers advance a project's context revision in the same transaction as
writes to its todos, scratchpads, links, worktrees or attachments. A shared query
cache keys context reads by project, arguments and revision. Revisits reuse the
result; changes in another project and unrelated agent starts or stops no longer
reload it. Unknown revisions on older paired hosts use change announcements,
and reconnect refreshes the fallback signal. Presets refresh when settings change.

3. Extend the cache to records and announced data (#77).
Todo and scratchpad details use project revisions. History, media, routines, MCP
servers, updates and harness models use change generations that also advance on
reconnect. Replies from older reads cannot replace newer data. Editors keep their
own draft copies, preserving autosave and conflict handling. Paired-host history
and media remain uncached because those peers do not announce changes locally;
MCP lists with a pending sign-in are refreshed because sign-ins can expire.

4. Read likely destinations ahead (#79).
After the page settles, a two-read scheduler warms running agents' context and,
where allowed, Integrated transcripts. Hovering or focusing a tab and opening the
project switcher prioritise likely destinations. Hidden tabs read nothing.
Automatic mode allows broader transcript prefetch on fast links, limits mobile
reads, and skips transcripts on slow links or data saver. Settings → Appearance
→ Prefetch conversations offers Automatic, Always and Never per device.

Transcript prefetch uses a read-only path: it cannot change agent activity,
deliver held messages or record limits. It omits command and model lists (about
38 KB of a 39 KB empty Claude snapshot). Every queued read rechecks eligibility
and budget before running, with in-flight transcripts counted against the budget.
It fills only free conversation cache slots. Paired-host transcripts load only
when opened, avoiding side effects on older hosts; their context can be prefetched.

Measured figures

These are medians from browser before/after runs against isolated servers behind
a latency proxy, with the context panel open. RTT is network round-trip time.
Each phase compares against its own preceding main revision; the figures are
not a single 0.2.3 → 0.2.4 benchmark and must not be added together.
They describe
navigation/content readiness, not agent inference speed or terminal throughput.

Phase 1 — main versus #72:

Navigation, content ready 31 ms RTT 150 ms RTT
TUI agent revisit 196 → 78 ms 457 → 204 ms
TUI agent first visit 196 → 80 ms 488 → 200 ms
Project revisit (TUI run) 280 → 106 ms 523 → 234 ms
Integrated agent revisit 121 → 57 ms 468 → 201 ms
Integrated agent first visit 204 → 158 ms 477 → 349 ms
Project switch onto an Integrated agent 192 → 85 ms 399 → 238 ms

Integrated switches dropped from 8 to 4.5 RPCs per switch. The Integrated run's
shared-terminal banner appeared in 18 of 75 navigations on main and none on the
branch. Real Claude Haiku, Codex gpt-6-luna and OpenCode glm-5.3-flash agents were
exercised over seven tiny turns; launch, composition, streaming, tool calls and
transcript retention passed, with no wrong-session context in 300 navigations.

Phase 2 — main 305ba9e versus #75:

Navigation, content ready 31 ms RTT 150 ms RTT
Todos page revisit 51 → 33 ms 167 → 25 ms
Scratchpads page revisit 40 → 24 ms 160 → 20 ms
Agent revisit 72 → 72 ms 189 → 209 ms
Project revisit 89 → 88 ms 205 → 234 ms

All four eliminated their context RPC (1 → 0). Agent/project switching did not
improve in this phase: phase 1 already painted cached context, while terminal
snapshots and git remained. Panel/list writes dropped from two RPCs to one;
at 31 ms they appeared about 20–40 ms later while awaiting the revision patch,
and at 150 ms were slightly faster. Cross-project isolation, two-browser updates,
reconnect and restart checks passed.

Phase 3 — main 688a932 versus #77, 150 ms RTT:

Navigation Before → after
History page revisit 388 → 32 ms
Conversation first visit 388 → 186 ms
Todo reopen 188 → 34 ms
Scratchpad reopen 187 → 22 ms
Routines page revisit 183 → 13 ms

Revisits across all six tested pages made none of the cached reads. Agent/project
switching and page-load differences were within noise. Checks covered autosave,
two-browser edits, relations, a 2,500-line scratchpad, imports and reconnects.

Phase 4 — main 57fdbac versus #79:

Navigation 31 ms RTT 150 ms RTT
Integrated first visit, transcript visible 74 → 30 ms 200 → 28 ms
Project first visit, content ready 287 → 203 ms 487 → 326 ms

A TUI first visit made zero session-context calls instead of one. Prefetch moved
34.7 KB on the wire in the first 30 seconds, then went quiet. That measurement
predates the transcript-only payload trim; no post-trim byte figure was measured.
A write in another project refreshed only that project, once, about three seconds
later. Connection/preference gates and no unrequested terminal subscription or
control changes were checked in-browser. Non-eviction was covered by unit tests;
the browser fixture had fewer Integrated agents than cache slots.

Remaining limits: a prefetched Integrated transcript can paint while its loader
still awaits a live snapshot. diff_current still invokes git on switches, and
normal Claude snapshot reads still carry the model/command lists. Terminal observer
subscriptions, Claude token batching and removing conversation snapshots from the
socket's serial queue remain future work; this release does not claim those gains.

Other changes

  • Integrated Claude, Codex and OpenCode activity follows active turns, background
    agents and permission waits more reliably, including reconnects and tool calls
    (#71, #78).
  • Claude and Codex use Patterm-managed remote MCP authentication. Codex's header
    helper no longer waits on a slow OAuth refresh
    (#68, #70).
  • The assistant can list, create and rename projects through its own MCP tools
    (#73).
  • wait_for_pattern returns immediately and delivers a durable callback for a
    literal match, process exit or timeout, keeping the agent responsive
    (#74).
  • Removed the subagent panel shadow and the white flash while html_render
    pages load (#69, #76).

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Keep Claude and Codex MCP authentication managed by Patterm by @hjbdev in #68
  • Remove the subagent view's side shadow by @hjbdev in #69
  • Stop Codex MCP header helpers waiting on OAuth refreshes by @hjbdev in #70
  • Make Integrated agent activity follow what the agent is doing by @hjbdev in #71
  • Let the assistant list, add, and rename projects over MCP by @hjbdev in #73
  • Make agent and project switching quicker in the browser by @hjbdev in #72
  • Make wait_for_pattern a non-blocking output watch by @hjbdev in #74
  • Cache context reads until their project's records change by @hjbdev in #75
  • Keep html_render frames dark while their page loads by @hjbdev in https://github.com/hjbdev/patterm/pul...
Read more

Patterm 0.2.3

Choose a tag to compare

@github-actions github-actions released this 15 Oct 00:01
1cb8ab0

Platform support

Linux x64 and arm64 are the supported release platforms.

macOS and Windows desktop builds are experimental, including when attached
to a stable release. They pass automated build checks but still need hands-on
testing with agent CLIs; bugs and platform differences may remain.

  • macOS: Apple Silicon (macos-arm64) and Intel (macos-x64) app zips.
    These builds are ad-hoc signed, not Apple Developer ID signed or notarized,
    so macOS may block opening them. Install or update with install-macos.sh.
  • Windows: a portable x64 zip (windows-x64) and the per-user PowerShell
    installer (install.ps1).
  • The background service installer and Tailscale setup are Linux-only.

Each app archive has a matching .sha256 file. Install and sign into your agent
CLIs separately. See the repository README for platform installation details.

What's Changed

  • Move the phone bar to the bottom and smooth mobile sheets by @hjbdev in #66
  • Release 0.2.3 by @hjbdev in #67

Full Changelog: v0.2.2...v0.2.3