Published releases, newest first. Check what changed before updating your server and app. See the update guide for automatic and manual installations.
v0.57.0
current
Sessions can schedule future runs: switch on the Schedule tool and the agent can plan and manage them, with schedule controls in the chat.
A usage panel shows token usage history.
Recordings pace the agent's pointer and typing naturally, settle after each action, trim idle time, and offer pace presets, a configurable clock and viewport size.
Built-in skills have clearer names: koyd-app-builder, koyd-website-builder, koyd-workflow-builder and koyd-fix-compile-errors. References to the old names keep working.
v0.56.0
Older setups that saved the local address on port 443 move to the default port 4319 on their next start when it is free; pair the browser once at the new address.
Server output reports its HTTPS and server ports.
Images can be pasted into written answers in the Ask user card.
The live turn card keeps the file being edited in view and, when opened mid-turn, shows only the latest edit.
The Changes button sits after Project settings in the workspace.
v0.55.0
Project rules: write instructions in Project settings → Rules that reach the agent on every turn, for matching files, or when relevant. Koyd stores them in its data folder, can import them from the repository, and can undo a deletion.
A switch controls whether the repository's AGENTS.md and CLAUDE.md reach the agent.
Project rules and the AGENTS.md switch carry over to workflow runs and can be managed through the Platform API and SDK.
A new Project settings panel gathers the project's details, commands, Always-On items and memory; open it with Ctrl+Alt+P or the workspace tool button.
Session tools, skills, MCP servers and the active prompt template can be removed right from the composer.
Toasts can show action buttons and info notices, and pressing them no longer closes open dialogs.
Written answers can be picked like options in the Ask user card.
The server file listing stays visible while the next folder loads, and Windows folder actions start faster.
v0.54.0
PDF and DOCX attachments are read as text.
A new built-in `koyd-workflows` skill lets agents in other tools work with Koyd workflows, and `koyd skills export` exports skills.
Workflows can be checked before saving with `koyd workflows check`, the API and the SDK, including repository placeholders in runs.
Stopping a workflow run closes its terminals, and deleting a run whose folder is in use reports a conflict.
Commit-split steps accept approvers only when they wait for a review, and say which model to set when none is chosen.
The live turn card keeps the current edit in view, folds finished files closed, and keeps earlier edits as past edits.
v0.53.0
Knowledge bases can be governed: changes wait for approval, agents get the approved version, and an included workflow reviews knowledge against the code.
Workflow review and commit steps can name the roles allowed to decide them.
Workflows can run across several repositories at once.
`koyd sdk add` sets up the `@koyd/workflows` SDK in a project, and the SDK now ships with Koyd.
A new skill helps agents build your own website on top of Koyd, and Koyd Manager can guide you through setting up an AI development process.
Exported agents include the personal apps they use.
The live turn card folds finished edits when the agent moves on to other work.
Custom provider keys no longer appear in listings or logs.
v0.52.0
Workflow agent steps can use saved apps and their tools; the workflow editor lists them and marks apps that can't run.
The Resources API lists saved apps and their MCP servers, with matching types in the `@koyd/workflows` SDK.
Saved apps run without a separate approval step.
The embedded browser has Back, Forward and zoom controls.
v0.51.0
Git merge conflicts can be resolved in the app, choosing a side or an AI-proposed resolution, and a Pull button brings in remote changes.
Repository status shows when a merge, rebase or other git operation is in progress.
New built-in agents: Explorer, Planner, Code Reviewer, Security Reviewer, Build Fixer, Simplifier, Docs Updater and Performance Optimizer, with built-in review and build-fix skills.
The Forge swarm includes the specialist agents.
Opening an app trusts its backend automatically, with no separate enable step.
The live turn card lists only the files the agent is editing.
v0.50.0
Removing a queued prompt puts its text back in the composer.
File locks no longer claim files from shell commands that only read them, such as a quoted `>` in a search or comparisons in `(( ))` and `[[ ]]`.
File locks resolve relative paths after `cd /c/...` to the right Windows file.
File locks no longer claim files changed by other agents or sessions in earlier turns.
A chained handoff continues once its failed dependency is rerun and completes.
Swarm dispatch picks the default AI tool when the server starts.
v0.49.0
New main sessions have Ask user turned on by default.
Workflow runs are labeled by workflow name.
Koyd Manager can list knowledge bases when building workflows.
The message composer is taller.
Inline diffs no longer show a header and legend bar.
Code maps can no longer be opened in a separate window.
v0.48.0
Included workflows and templates run directly in the project folder and commit locally, instead of creating a separate worktree.
The workflow editor recommends the project folder as the workspace.
The tools popup can be filtered by search and keeps the active item in view.
v0.47.1
Unsent input is restored, along with several smaller UI fixes.
PostgreSQL connections follow the chosen SSL mode, including certificate verification.
Project-limited API keys only reach their own knowledge bases and spend limits.
Workflow files are matched regardless of letter case, and run controls work reliably.
Session and resource imports and backup restores reject invalid IDs.
Deleting sessions and projects cleans up fully.
Saved data that cannot be loaded is reported instead of silently ignored.
The server browser, terminals, API keys, updater, git checkout, shell parsing, sign-in and team spending records are more robust, and text parsers handle Unicode and malformed input.
v0.47.0
Koyd includes ready-made workflows for features, refactors, bug fixes, performance, prototypes and investigations, shown in every project under Included with Koyd.
Agents can propose workflow runs from a session for you to approve.
The turn changes card follows the agent's edits live and briefly keeps each recently edited file open.
On a fresh session, the composer is centered under the greeting.
Agents can wait for their running agent sessions to finish.
v0.46.0
A first-run setup guide walks new users through getting started, from a dialog or a workspace screen.
Faster chat, session lists, streaming, workflow views, code maps, file search and file locks, with fewer re-renders and less repeated work.
Updating a session no longer risks overwriting its transcript.
Context usage keeps the larger turn total when reports are merged.
Form dialogs stay open when you click outside them.
v0.45.0
Platform API v1: run Koyd fully headless over HTTP, covering projects, AI providers and defaults, chat sessions, modes, prompt templates, swarm presets, API keys, and limits and budgets.
Resources and Teams APIs, with matching clients in the `@koyd/workflows` SDK.
Workflows can have budgets and run limits, track their token usage, and use new built-in steps for usage reports and pull requests.
Teams cost limits and team resources apply to workflow steps, with improved team approvals and unlocking.
Knowledge imports from the web only fetch public addresses.
The Pi engine is updated to 1.1.0, along with its bundled extensions and other dependencies.
Agents no longer have file attachments.
Repeated connection drops are announced right away after a recovery.
Personal skill and agent IDs are checked to be plain names.
v0.44.0
Projects can keep chosen skills and MCP servers always on, set in a new Always-On dialog and merged with your defaults.
Commands resumed after a reconnect run safely, without repeating ones the server already started or running them on a restarted server.
The connection-lost banner waits out short drops.
The remote browser shows the page's cursor, and page captures are clipped correctly.
Explorer windows opened from Koyd come to the front on Windows.
Usage rows show MCP server names instead of raw IDs.
Session row actions and tooltips no longer overlap neighboring rows or screen edges, and the file locks tooltip is wider.
v0.43.0
Code maps check their code links against the current files, mark outdated ones, and offer to fix their locations or refresh the affected sections with AI.
Koyd Manager can create and change workflows from chat, checking them with the same rules as the editor.
v0.42.0
Workflow API v1: build your own app on Koyd workflows over HTTP, with scoped API keys, live event streams and webhooks, plus an `@koyd/workflows` SDK and an example dashboard.
Built-in workflow steps can map a set of changes and split them into reviewable commits, with plans and artifacts shown in the app and the command line.
The code map explorer shows which files and parts of the code changed.
Commit plans accept extra guidance.
Forge adds a Tester agent that tries to break the reviewed result and fixes confirmed bugs.
Browser screenshots mask private fields in every frame of the page.
Workflows run more reliably and handle their processes more safely.
Shell commands are split only at separators outside quotes, file locks ignore filesystem roots, and delegated lock waits apply only to exact clashes on named files.
v0.41.0
The embedded browser behaves like a regular browser: sites that refuse automated browsers work, and the live view updates as soon as the page changes.
Links that open a new window open a new tab that keeps your sign-in.
Page dialogs (alert, confirm, prompt and leave-page prompts) appear above the page with OK and Cancel.
Link clicks show loading, single-page apps update the tab title, failed navigations explain what went wrong, and downloads are cancelled with a notice.
On phones, drag scrolls the page and tap clicks; on a Mac, Command shortcuts work in the page; copy and cut go to this device's clipboard.
Pointer movement, scrolling and clipboard reads are no longer written to the audit log.
Skill recommendations take failed tool calls into account.
v0.40.0
Local knowledge bases: create and manage them, choose which ones a session uses, and let chats recall from them with dedicated tools.
Knowledge documents can be imported from URLs, with bounded crawling of linked pages.
Imported documents are split along their headings and structure, and web pages are converted to clean Markdown.
Knowledge search results can optionally be ranked by AI.
Agents can add documents to a knowledge base after you approve the import.
Workflow steps can choose which knowledge bases they use.
Agents can list and resume their earlier agent sessions.
Local memory uses Granite multilingual embeddings, improving recall for languages other than English.
Turn changesets no longer mark files as written by a sub-agent.
v0.39.0
Workflow reviews have an approval inbox and review panel, with alerts when an approval is waiting.
Devices can turn on notifications for workflow reviews, and tapping one opens the review.
Workflow steps can be inserted between existing steps in the editor.
Imported CLI sessions are nested under their folder with a guide line.
MCP servers are shown with their app names.
v0.38.0
Workflows arrive: define multi-step runs with approvals, build them in a visual editor, and save them in Koyd settings or alongside project files.
Workflow steps can set their own reasoning level, fall back to the default model, and appear as nested sessions in the sidebar.
Workflows open as a full-width view that replaces open workspace panels, with a full-page editor and friendly validation messages.
Workflow runs and approvals can be managed from the command line.
Empty agent replies fail a workflow step, and verdicts at the end of a sentence are accepted.
Teams can store data in Azure Blob Storage or Amazon S3.
CLI import has a redesigned settings page with a status filter, run summary, and warnings for missing working folders or unreadable stores.
Continued CLI imports get the default tool switches.
Trusted app tools are available in sessions automatically.
The Apps panel stays mounted and shows cached apps while refreshing.
Recordings show natural agent motion and skip idle time on the clock.
v0.37.0
Teams budgets can set the billing time zone, so spend periods line up with the team's own calendar.
Team audit events show plain-language labels instead of raw event names.
A Teams runtime that fails to start is reported and retried on the next sync instead of failing silently.
Teams fails closed and recovers its runtimes after local failures, drops redundant details from the spending and provider views, and hides model switches that cannot lift a blocked model.
An own-snapshot alias write is accepted after a lost-response retry.
Task model pickers select the default model again.
Team accounts are called team providers in status copy, and group creation is shared with the rest of the app.
v0.36.0
Teams (Beta) arrives in Settings → Teams: an owner creates a team on a private S3-compatible bucket they control, invites members and shares AI access with no Koyd servers in the path.
Team admins choose team providers with a cost mode (API pricing, subscription or premium requests) plus a policy of budgets, money and request caps, per-model limits and allowed models; new teams start at a $0 budget with nothing allowed.
Members keep using their own provider connections: the model picker marks team models as Team: <name>, every request through a team provider counts as team usage, and requests are checked on the member's machine before they are sent.
Agents are notified of foreign file locks during their turns, so concurrent sessions stop stepping on each other's files.
The default local address uses port 4319.
Drafts are scoped to the pinned instance, and draft key lookup no longer slows down as drafts accumulate.
The link watch window arms as soon as a server starts and ignores traffic while the link is suspended.
v0.35.1
Browser views refresh promptly without overlapping requests, slow down while idle, and pause entirely while the tab is hidden.
Hidden browser panels stop observing layout, cutting background work during sessions.
Visibility gates share a single intersection observer instead of one per panel.
Code maps stay usable while revalidating after you reopen them.
Code mode asks for short, plain-language responses.
v0.35.0
Pair a phone or another device with a one-time 8-character code instead of a long secret, shown per server for public deployments.
Pairing and socket requests are rate limited per client, protecting public servers from brute-force and flooding.
Local versus public server addresses are handled consistently across pairing and sharing.
New VPS deployment guide with example Caddy and systemd files, plus pairing-code and proxy-hardening documentation.
v0.34.0
Suggests skills from your past sessions: analyze a project's sessions, review drafted skills in the Skills tab and save the ones you want.
CLI import is reworked for review and batching: select many transcripts at once, edit titles and import them together.
Apps list only Koyd-enabled models and reasoning levels, with compact runtime chrome replacing the backend controls.
Browser recording keeps the last frame while a page has not painted yet, so recordings no longer flash blank during navigation.
Swarm sessions report locally rejected actions instead of parking the whole batch, stop folding a direct message across later actions on the same task, and treat a directory footprint as owning the files inside it.
Persistence writes are ordered with per-file locks, and a navigating click's element handle stays alive until the page settles.
v0.33.0
Import past AI CLI sessions into Koyd: scans Claude Code, Codex and Copilot CLI transcripts on your machine, previews them and imports the ones you pick with project matching, configurable in Settings.
Browser clips are recorded as finalized, seekable WebM files instead of raw live streams.
Upgrades the Pi engine and bundled extensions, adapting browser handoff to the new finishTurn hook and hiding stray Windows consoles from pi-web-access.
Loads plain-JavaScript extension entries as-is without forcing a TypeScript rebuild.
Stops the select popup viewport from clipping long option text.
v0.32.0
Browsing for files or folders prefers the native desktop picker when available, falling back to the in-app browser.
Desktop pickers show the proper dialog title and file-type filters for each action.
File selections validate in a single request, speeding up multi-file uploads.
v0.31.0
Commands sent while the connection is down are queued and resumed automatically when the server returns.
Re-sent requests are answered from a retained reply ledger, so reconnect retries never repeat work.
Broken instance links recover with guidance instead of failing silently.
v0.30.0
Usage badges break token counts into input, output, cache-read and cache-write categories, for both sessions and individual turns.
Refresh project file capabilities without reloading the project.
Native folder pickers on Windows use a precompiled helper, avoiding a build step at first use.
The project form is split into focused picker and submit steps.
v0.29.0
Agent runs queue instead of being cut off by deadlines, with configurable runtime limits and queued runs shown in chat.
Swarm orchestrators gain durable admission control, action journaling, recovery controls, and server-owned termination.
Goal verification requires evidence and scope claims, and fails closed on external project activity.
Choose provider reasoning levels when picking app models.
The device setup page can connect from an app that already uses Koyd.
Wide ASCII diagrams stay above a readable scale floor, and phrase pipes in diagrams read as prose.
Instance sharing and pairing settings are reorganized, long project names stay readable in search filters, and supervisors stay awake for direct messages on settled tasks.
Headless launches no longer inherit the Ctrl+C handler.
v0.28.2
Browser use cannot be enabled from the tools picker until the browser is set up, removing a confusing failure.
v0.28.1
File locking now resolves Pi tool path aliases and overlapping directories, so locked files are tracked correctly across tools.
The sidebar folder menu no longer flashes the wrong project action while loading.
The app launch dialog header is restyled.
Project file capabilities are cached per backend, reducing repeated capability lookups.
v0.28.0
Configure multiple OpenCode Go keys with automatic rotation and a local gateway, managed from provider settings.
Filter global session search by project, including pinned and recent sessions.
See per-turn token usage on assistant messages, with totals retained across sessions.
App iframes use a stable theme-independent backdrop and own their styling instead of inheriting host theme variables.
Update commits are supervised in a separate runner process with automatic recovery, and client update requests time out instead of hanging.
Loopback requests bypass environment proxies.
Session lists, global search, state patches and tool file grouping do less repeated work on busy workspaces.
v0.27.0
Optionally keep network sharing enabled across server restarts and updates, restoring it only when the saved interface configuration is available.
Turning sharing off clears the saved preference while preserving existing device pairings and certificate trust.
Active device credentials renew automatically; expired and revoked credentials remain invalid.
Stalled connection handshakes retry with saved credentials instead of unnecessarily requiring a new pairing, without replaying operations that may already have run.
v0.26.2
Clearly distinguish the hosting server, the current browser or app, and other paired devices in access settings.
Use clearer device labels and instructions for connecting, pairing, and removing access.
Reduce repeated sidebar calculations when unrelated workspace state changes.
v0.26.1
Retry failed server and app updates without getting stuck in a busy state.
Stalled update downloads time out with a clear, retryable error.
Background servers use system certificates and configured proxies by default while preserving explicit network settings.
Update status and errors show the update log location for troubleshooting.
Client update activation recovers more reliably after restarts, and already-installed versions no longer leave stale update errors active.
v0.26.0
Review release notes and confirm the server restart before applying an update.
Installed apps use a dedicated title bar when window-controls overlay is available.
Dismiss the installation notice when it is not needed.
Error and warning notifications appear as dismissible notices; routine updates remain silent.
Completion sounds announce each finished run once, with five cues and a fallback for retired sound choices.
Session token totals include delegated subagent usage across sessions.
Close the media viewer by clicking the backdrop around the media.
The classic session list animates changes while respecting reduced-motion preferences.
App builds use the same file-count limit as the runtime.
v0.25.0
Use a mobile workspace with labeled bottom navigation, a tools sheet, and a visible project and conversation title.
Mobile tool panels use the available screen width, with improved database and codemap navigation.
Keep the composer accessible when the on-screen keyboard opens, while preserving drafts through panel changes and rotation.
Open each instance in its own pinned window.
Accept device-setup links during pairing and show clearer pairing errors.
Browser zoom now scales the interface without the root font size counteracting it.
Opening the new-session picker avoids rerendering the workspace, and message resizing and unchanged state updates do less repeated work.
v0.24.0
Switch between recently visited sessions with Ctrl+Tab.
Search changed files in change-review dialogs without altering the change totals.
Close command popups with Escape even after keyboard focus moves outside them.
Browser recordings run at 25 fps and preserve elapsed timing when captured frames are delayed.
Recordings show the pointer cursor and fading click highlights while keeping private fields masked.
Single-capture galleries hide redundant tabs and captions.
v0.23.0
Navigate between screenshots and recordings without closing the media viewer.
Video playback supports speed controls and detects duration for WebM recordings that lack duration metadata.
Recording expansion is available directly from the playback controls.
The session Tools pill shows a read-only list of enabled tools.
Locally received messages are preserved when agent streams hydrate.
Chat and diff views use consistent, borderless surfaces.
Windows runtime child processes no longer open unwanted console windows.
v0.22.0
Search projects by name or path directly in the sidebar, while preserving project selection and context actions.
Thinking blocks stay collapsed by default during streaming and can still be expanded manually.
The workspace header uses flatter toolbar styling while keeping navigation and workspace actions available.
v0.21.0
Zen mode provides a focused workspace with a pared-down composer and a keyboard shortcut.
Browse saved browser-session screenshots and recordings, with video playback controls.
Browser recordings capture at 10 frames per second without waiting on the visual interaction queue.
A single Tools pill replaces separate session-tool pills, with improved dialog keyboard focus.
Navigation columns stack correctly on phones, and active-session status remains visible in the sidebar.
Global session search exposes refresh and error states.
Legacy toast overlays have been removed.
Web research tooling is updated to pi-web-access 0.29.0, including source_check support; the terminal UI dependency is pinned to match the agent SDK.
v0.20.0
Abandoned server updates can recover after a restart instead of leaving the installation stuck in an updating state.
The client explains server restarts during updates and reports interrupted update helpers as failures rather than waiting indefinitely.
Project and session selection are remembered per device, and focused working sessions stay above idle sessions in the sidebar.
Diff lines use syntax-aware token highlighting.
The cross-project header is simpler, and full-size overlay sheets use opaque backgrounds for readability.
Windows PowerShell execution is centralized, with checks for command size, quoting, Unicode, approval cancellation, and setup failures.
v0.19.0
Chat file attachments are stored by reference, with attachment-aware Read tools for agents and cleanup when sessions or projects are deleted.
Agents and users share a browser workspace with explicit ownership controls, browser handoff, and zoomable screenshot and recording previews.
Ask user lets agents pause for structured answers inside the conversation, with pending-question indicators in the sidebar.
The /tools picker controls per-session tool permissions; new sessions inherit configurable defaults, and chat summarizes tool usage.
Large session histories scroll and update more efficiently through sidebar virtualization and reduced repeated work.
Notifications use a queue and no longer dismiss unrelated dialogs; terminal and visualizer colors follow the selected theme.
Windows tool processes avoid unnecessary console windows.
CLI help is organized by command, installer output is clearer, and koyd uninstall offers an explicit choice about keeping data.
