Skip to content

What's new

Desktop updates from Help → Check for Updates. Local and self-hosted installs update from Settings → System or with worktable update. Worktable Cloud updates automatically.

  • Calmer Cloud setup: new hosted workspaces now show a branded transition with clearer progress and recovery actions while Worktable gets ready.
  • Simplified legal information: public sites now group legal links separately, with Worktable Cloud refund terms included in its terms of use.
  • OpenClaw plugin installation: ClawHub installs now include the compiled plugin files required by OpenClaw.
  • Native Worktable Cloud for Desktop: sign in through the system browser, keep the rotating credential in macOS Keychain, and open the same hosted workspace without exposing tokens to its WebView.
  • Public legal and security policies: review Worktable and Worktable Cloud terms, privacy, refunds, and vulnerability reporting from each site.
  • Reliable Desktop Cloud sign-in: Worktable Desktop no longer rejects valid WorkOS sign-in requests when the Mac and gateway clocks differ slightly.
  • Portable workspace packages: export a compressed .wtb with selectable history and an offline browser, then safely replace another workspace while preserving its identity.
  • Cloud checkout from Account: Subscribe now opens secure checkout directly when a signed-in workspace still needs payment.
  • Worktable Cloud subscriptions: start a $7.99 monthly workspace through secure hosted checkout, manage billing from Account settings, and retain full workspace export if billing access is suspended.
  • Cloud agent setup and management: connect coding agents without copying tokens, see and disconnect OAuth or OpenClaw connections, and register always-on OpenClaw participants with conversation-limited access.
  • Signed Desktop updates: Worktable Desktop checks for signed releases, asks before downloading and restarting, and keeps a signed manual recovery path if installation fails.
  • Reliable service restarts: updates and Desktop restarts now recover when an older runtime lease mislabels a manager-owned background service.
  • Worktable-level threads: general agent conversations now live in Worktable, shown alongside Space threads in one top-level Threads view.
  • OpenClaw connects to the whole Worktable: new pairings no longer require a Home Space.
  • Clearer agent setup: Settings groups OpenClaw with always-on agents, separates verified connections from access tokens, and shows last use without implying live presence.
  • Cloud document syncing: hosted documents reconnect and persist edits instead of remaining stuck on “Syncing.”
  • Distinct Cloud agents: separately authorized MCP apps now stay distinct in threads and agent-authored changes, even when they share your account.
  • Durable agent conversations: exchange messages in Space threads, continue follow-ups with the same agent context, follow delivery progress, and catch up after disconnects.
  • Accurate document authorship: version history no longer occasionally labels agent edits as external file changes.
  • Connect Worktable Desktop to your own server: save multiple self-hosted Worktable origins, sign in with the server’s owner page, and switch or forget connections without disturbing local workspaces.
  • Calmer update notices: release badges remain visible, each release is announced once while Worktable is in view, and Settings continues to open on General unless you explicitly choose Review update.
  • Agent setup reorganized into expandable panels: Quick connect, Desktop apps, and Manual install now live in separate disclosures, with a compact Connections summary that opens automatically when you have one.
  • Cloud sign-out feels native: confirm in-app before signing out, and land back on the Cloud homepage with a signed-out banner and a one-click way to sign in again.
  • Update checks recover consistently: concurrent checks are combined, failed checks retry on a bounded schedule, and Worktable never offers a blind update when release information is stale or unavailable.
  • Cloud sign-out works again: the sign-out button now completes through the gateway’s confirmation step instead of failing.
  • Cloud sign-out now syncs across tabs: signing out of Worktable Cloud in one tab signs you out of every other open tab too.
  • Install Worktable Desktop from a trusted Mac disk image: Apple Silicon releases now include a Developer ID signed and Apple-notarized DMG.
  • Connected agents favor Worktable for durable work: agents now default to keeping context and artifacts in your workspace, preferring HTML docs for visual or interactive results.
  • Consolidated the MCP API: replaced 37 operation tools with 13 capability focused tools (reconnect your MCP client to pick up the change).
  • Connect desktop AI apps without editing config files: a new Desktop apps panel in Settings → Agents lets you install a Claude Desktop extension or copy a direct endpoint for ChatGPT desktop.
  • Closing the desktop window no longer quits Worktable on macOS: your workspace and agent connections stay live; reopen from the Dock or use Quit to fully shut down.
  • Desktop setup feels at home on macOS: first run begins with connection selection, calmer workspace guidance, and persistent workspace controls in the native app menu.
  • Desktop and CLI share one local workspace: Desktop detects an existing CLI or background service install and offers to attach instead of starting a duplicate server.
  • Simpler Desktop connection-trouble screen: it now leads with one recommended action, with logs and other options tucked behind a “More options” disclosure.
  • Consistent brand icon everywhere: the sidebar, favicons, desktop app icon, and installable app icons now all use the same Worktable mark.
  • Fixed a false setup error: Desktop no longer showed a “couldn’t connect” screen while a new workspace was still finishing initial setup.
  • Codex connection respects a custom CODEX_HOME: connecting Codex now writes its config to the location Codex actually reads when CODEX_HOME is set.
  • Workspace folder picker opens where you’d expect: in Desktop, choosing a workspace folder now starts at your current or previously selected location instead of the OS default.
  • Sidebar toggle lines up with content: the header’s sidebar toggle now aligns with the content gutter instead of sitting slightly offset.
  • Settings adapt to your deployment: Worktable Cloud hides local-only controls like Workspace URL and update checks, showing only settings that apply to your install.
  • Darker desktop sidebar: the sidebar now sits visually recessed behind the main content, with clearer text hierarchy for space and navigation labels.
  • Codex connections repair reliably: connecting or repairing Codex could leave its config broken; setup now repairs and validates it every time.
  • Safer agent pairing: connecting a client now checks every selected client before writing any config, and rolls back all changes if a check fails.
  • Cloud sign-out: Account settings now shows your Cloud sign-in status with a clear Sign out action, landing you on a plain page to sign in again.
  • Toasts match the design system: notifications now use consistent styling, status colors and icons, and typography across the app.
  • Fixed docs stuck on “Syncing”: opening a doc right as its workspace comes online no longer leaves it stuck; it now syncs without a manual refresh.
  • Fixed Desktop setup hang: a fresh Desktop install could get stuck before reaching the Welcome space; it now completes reliably.
  • Cloud agent connections use OAuth: Worktable Cloud’s Agents settings now walk you through OAuth sign-in instead of local access tokens, which aren’t available there.
  • Smoother Cloud first run: setting up a new Worktable Cloud workspace now shows a live status page instead of reloading, and takes you in automatically once it’s ready.
  • Records get new capabilities: document links, index health checks with a one-click reconcile, and gentle schema advisories for oversized or duplicate fields.
  • Records get a fresh look: the detail view opens in a resizable panel or full page, and the table gained a compact toolbar and reorderable columns.
  • Portable workspace export and import: the CLI can now export your workspace to a single snapshot file and import it as a new workspace.
  • Flatter, more neutral controls: buttons, inputs, selects, checkboxes and switches shed their raised bevel for a cleaner flat look, with clearer shadows on menus and dialogs.
  • Version history ordering: docs and widgets with versions saved in the same millisecond now correctly show the latest one as current, not an older one.
  • Mobile navigation drawer polish: the mobile sidebar no longer shows overlapping translucent panels against the dimmed background.
  • Installed app launch scope: fixed an issue where the installed Worktable app could open outside its intended window scope.
  • More reliable restarts: the app now waits for in-progress edits to save before restarting, so changes are no longer lost.
  • Shareable links from agent replies: when an agent creates or edits a doc or widget, it can now share a clickable link back to you in chat.
  • Sharper HTML doc design guidance: agent-generated HTML docs and widgets now follow stronger visual design and comprehension standards for more polished, easier-to-scan results.
  • Editor hang on internal doc links: documents containing a link to another doc no longer freeze the editor.
  • Sidebar search polish: result rows now have clear spacing, pressing Enter opens the top result, and excerpts no longer show raw markdown or repeat the title.
  • Filter, group, and customize records: narrow and group the records table, show or reorder columns, and preserve the current filters and table arrangement in shareable links.
  • Edit records and schemas inline: edit any cell in place, manage a record fully from the peek panel, and add, rename, retype, or delete collection fields, right in the UI.
  • Search from any page: the sidebar now has a persistent search that finds docs and records across your workspace, with match excerpts and highlights.
  • Update notifications: a dot on the Settings button and a one-time toast let you know when a new version of Worktable is available.
  • Refreshed Settings navigation: the settings dialog now highlights the active section with a sliding indicator and shows a short description for each one.
  • Renaming a doc no longer breaks its links: old bookmarks and authored links to a renamed or moved document keep resolving to it instead of 404ing.
  • CLI agent pairing: worktable agent invite and worktable agent connect pair a remote agent straight from the command line, no client config to hand-translate.
  • No more raw tokens in setup output: worktable setup and mcp setup point you to agent pairing instead of printing a bearer token and connection snippet.
  • Records grid: browse a record collection as a sortable, searchable table with typed columns, and click into any row for full detail.
  • One-line agent connect: Settings → Agents now leads with a single command that installs and pairs a remote agent, with live status as each step completes.
  • Connections replace access tokens: the Agents settings list shows connected clients and machines with a last-seen status, instead of raw token records.
  • New Settings: a unified two-pane dialog (tabbed drawer on mobile) covering General, Appearance, Editor, Agents, History, and System, replacing scattered configuration screens.
  • Agent access tokens: mint, reveal once, and revoke tokens for connecting AI clients, with a paste-ready connection snippet.
  • Doc version-history retention: choose how long doc versions are kept: everything, 90 days, 30 days, or the last 50 per doc.
  • Automatic update checks: choose whether Worktable checks for updates in the background.
  • Resizable sidebar: drag the sidebar’s edge to resize it; your preferred width is remembered.
  • worktable mcp print-config: shows token guidance for every client when a reachable install has no token yet, instead of a snippet that would fail.

Maintenance release.

  • Widgets are now HTML docs: one kind of doc alongside markdown and rich text, living in the same sidebar tree, folders, and space overview.
  • Version history for HTML docs: every change (yours, an agent’s, or on disk) becomes a restorable version you can browse, compare, and restore.
  • Annotations and freshness on HTML docs: the same comments, review state, and stale markers your other docs already have.
  • HTML docs open in place: full-bleed in the main pane with a fullscreen toggle, instead of a framed preview that launched a browser tab.
  • Folders for agents: agents can file HTML docs into folders by creating them with slash-style ids (for example plans/q3-redesign).
  • Mermaid editor: diagram blocks open with the source collapsed, and the editor follows your light or dark theme.
  • Copy HTML: copies an HTML doc’s full source from the header or its menus, ready to paste into a conversation or another tool.
  • Archived banner: archived HTML docs show a banner with one-click Restore, matching docs.
  • Live sidebar updates: agent changes to HTML docs (create, rename, archive, delete) appear in the sidebar immediately.
  • Mermaid in exports: copying, exporting, or reading a doc no longer drops its Mermaid diagrams; they come through as code blocks.
  • Table colors: cells with custom text or background colors keep that formatting when saved.
  • Block selection outline: selecting a Mermaid, image, or file block no longer shows a misaligned double outline.
  • Doc export: download any doc as a .md file, or print and save it as a clean PDF, from the header’s export menu.
  • Mobile topbar icon: shows the Worktable app icon instead of a generic lightning bolt.
  • Nameless doc creation: leave the name blank and Worktable names the doc untitled, then adopts its first heading as the title.
  • Copy as Markdown: copies the current doc as clean markdown, even when it started as a rich document.
  • Sidebar drag-and-drop: reorder documents and folders; your custom order is saved and syncs across clients.
  • Docs site redesign: a cleaner, flatter look with Worktable branding and tabbed navigation (Documentation, Agents, Reference, Changelog).
  • Select-all scope: Cmd/Ctrl+A selects only document content, not the sidebar or header.
  • Live sidebar titles: titles and freshness indicators update as you type instead of lagging behind.
  • Breadcrumb alignment: the title no longer appears indented relative to its siblings when not hovered.
  • Breadcrumb popover: removed a redundant “reviewed” sentence.

Maintenance release.

  • Doc freshness in the app: every open doc shows who last touched it and how long ago, stale docs get a sidebar marker, and Mark Reviewed clears it.
  • Richer records: new field types, typed relations between collections, and a far more capable query language, with existing collections and queries unchanged.
  • Reachable mode stays put: a network-reachable Worktable now remains reachable across restarts, reboots, and updates instead of quietly falling back to local-only.
  • Record field types: text, url, email, person, select and multi-select, typed relations (single or list), and numbers with units.
  • Record queries: and/or/not filters, filtering through relations, multi-field sort, cursor pagination, expanded references, backlinks, and grouped counts, sums, and averages.
  • Relation integrity: per-field delete policies block or clear references to a deleted record, and dangling references surface as collection warnings.
  • Widget query permissions: widgets following relations or expanding references need read permission on those collections too.
  • Collection descriptions: collections and fields carry descriptions agents can see, plus an optional well-known type hint (like schema:Person).
  • Update visibility: worktable status, update --check, Settings, and a one-line post-command nudge all report when a newer release is available.
  • Read-only commands: status, doctor, paths, and mcp status never rewrite your configuration.
  • Durable configuration: the config file is written durably and backed up; if it is ever unreadable, Worktable restores the last good copy instead of resetting to defaults.
  • Linux service startup: the background service starts after a reboot on headless machines, and leftover competing service definitions are cleaned up with a warning.
  • Review accuracy: simply opening an agent-written doc no longer marks it reviewed; only actually editing or interacting with the content does.
  • Unreadable record reporting: collections report which record files could not be read (and why) to the app, to agents, and once to the server log.
  • worktable completion install: sets up shell tab completion for bash, zsh, or fish; the shell is auto-detected from $SHELL.
  • Automatic completions: shell tab completion is installed with Worktable by default; skip with --no-completions.
  • Record index: queries and record search are served from a background index (machine-local, auto-rebuilding, safe to delete); records stay plain YAML files.
  • Widget query validation: malformed widget queries are rejected with a clear error, and the 1000-result limit applies to widgets too.
  • Forward compatibility: workspaces written by a newer Worktable stay readable and writable, and edits no longer strip fields this version doesn’t understand.
  • Space Home: opening a space shows a generated overview (docs by folder, backlinks, stale markers, a needs-attention strip); agents get the same index read-only.
  • Doc freshness signals: doc reads and search results carry how recently a human touched a doc and whether it has gone stale; reviews record a human checkpoint.
  • Wiki lint: broken links, orphaned docs, and over-long docs are flagged as annotations that update and resolve themselves.
  • Write guidance for agents: agent doc writes return convention warnings (broken links, missing title, deep folders) without blocking anything.
  • Documentation site: docs.worktable.dev, with install guides, concepts, and reference material.
  • Software update flow: Settings shows the running version and updates Worktable in place (downloads in the background, then restarts into the new release).
  • Records in search: records now appear in workspace search results.
  • Record query types: numeric and date fields sort and filter by value, and combined filters (like a date range) apply all their conditions.
  • Concurrent record writes: simultaneous edits no longer overwrite each other, and same-title creates no longer collide.
  • Widget network permission: widgets reach the network only when their network permission is enabled.
  • Brand refresh: new Worktable brand mark and app icons.
  • Clean doc file names: file names are slugs derived from the title (Planning Onsite becomes planning-onsite); lists show the doc’s first heading as its title.
  • History survives rename: renaming a doc no longer detaches its version history.
  • Docs with spaces: names with spaces no longer produce duplicate copies during live editing.
  • Annotation anchors: badges re-anchor to their quoted text when a doc is rewritten, and each annotation shows the text it refers to.
  • Uninstall preview: worktable uninstall shows exactly what it will remove, accepts --yes, and offers --purge to also delete the workspace folder.
  • Default port 7480: setup checks the port before writing configuration and asks for (or picks) a free one when it is taken; existing installs keep theirs.
  • Claude Code connect: connecting during setup no longer fails with a “missing required argument” error.
  • wtb alias: a short alias for the worktable command, installed alongside it.
  • Clearer setup and status: setup explains each choice before asking, and worktable status says why an agent client isn’t connected.
  • Simpler exposure gating: reaching Worktable beyond your machine is gated by the owner password alone; the redundant --insecure flag is gone.
  • Optional network access: setup can make Worktable reachable beyond your machine (off by default), protected by an owner password and an agent token.
  • Workspace adoption: setup names the workspace it adopts, and refuses (with a clear message) folders that already hold unrelated files.
  • Workspace identity: an unfamiliar or unreadable identity file is never overwritten, so an existing workspace keeps its identity across upgrades.

Maintenance release.

  • One-liner install: the curl | sh installer’s prompts now read from your terminal, and no longer crash partway through on macOS.
  • Setup restart: re-running worktable setup while the service is running restarts it, so updated settings take effect right away.
  • Linux arm64 support: the installer detects arm64 machines and installs the matching build (Raspberry Pi, Ampere, Graviton).
  • Shell completions: for bash, zsh, and fish, with an installer option to set them up for your current shell.
  • CLI subcommands: the worktable CLI is organized into clearer subcommands, easier to discover from --help.
  • Explicit update version: worktable update <version> accepts an explicit version correctly.
  • Startup reliability: a more dependable health check before treating a local server as running, and clearer errors when launch or service start fails.
  • Service without systemd: a portable fallback keeps Worktable running in the background on Linux hosts without a system service manager.
  • Setup default: press Enter to accept the suggested workspace location.
  • Service status: the background service reports accurate running status and keeps running after you close the terminal that started it.
  • Early releases predate this changelog; see the GitHub releases page for history.