v0.12.0-beta

FocusRelay 0.12.0-beta

This release makes it easier for an AI assistant to help you reach inbox zero
without losing control of what changes.

What’s new

• Process your inbox in manageable batches with a guided workflow that starts
  with unresolved captures, asks before changing anything, and verifies
  approved updates.
• Keep ordinary inbox cleanup focused on unfinished captures instead of
  unexpectedly mixing in completed or dropped history.
• Resolve nested tags more confidently by seeing the parent path for matching
  tags.
• Trust compact and multi-page results: unsupported fields and mismatched page
  cursors now fail clearly instead of returning misleading data.
• Keep OmniFocus updates reliable during busy conversations and client
  restarts—work is handled in order, overload is reported clearly, and
  disconnected FocusRelay processes exit cleanly.

In OpenCode, run /focusrelay:process_inbox to start the guided workflow.

Before upgrading

FocusRelay now requires macOS 26 or later.

After upgrading, reinstall the packaged OmniFocus plugin and restart OmniFocus
so the plugin and FocusRelay binary stay in sync.

v0.11.0-beta

This release makes everyday OmniFocus cleanup and review work safer and easier.

What’s new

• Clean up your task list without losing history by dropping and restoring
  tasks instead of marking them completed.
• Finish weekly reviews faster or declare review bankruptcy by letting
  FocusRelay mark active or on-hold projects as reviewed using OmniFocus’s
  normal review schedule.
• Find the right project by name before changing it, even when it is on hold,
  completed, or dropped.
• Make bulk changes with confidence: if any requested task or project cannot be
  updated, nothing in that batch is changed.
• Get more trustworthy results from searches, Review queries, and multi-page
  lists—invalid requests now fail clearly instead of returning misleading data.
• Leave more context for your actual work: seven editing tools are now combined
  into two, reducing the full tool catalog from 14 tools to 9 and cutting
  context usage by 7–13% in controlled model tests.

Before upgrading

Task and project editing is now handled through the two clearer edit_tasks and
edit_projects tools. If you have saved automations using older editing tools,
use the
migration table.

After upgrading, reinstall the packaged OmniFocus plugin and restart OmniFocus
so the plugin and FocusRelay binary stay in sync.

Install

brew tap deverman/focus-relay
brew install focusrelay

For manual installation, download the archive below. Its SHA-256 checksum is:

ebb5a70fd10a52c6ac0e493577799e813b43046e1d3c669ece78ecc2a3973c51

v0.10.1-beta

FocusRelay 0.10.1-beta

FocusRelay 0.10.1-beta is a maintenance release focused on truthful queries,
reliable MCP pagination, concurrent Bridge requests, and one supported
OmniFocus automation architecture.

Highlights

• Follow list pagination cursors without repeating the page limit. FocusRelay
  now applies the documented default for each list tool.
• Retrieve completed projects in date windows without the default active status
  filter hiding them.
• Treat completed=false consistently as remaining work, excluding dropped
  tasks and work beneath completed or dropped parents.
• Send fractional-second ISO8601 timestamps from MCP clients.
• Receive Bridge warnings in list responses and server logs.
• Handle concurrent requests without blocking Swift's cooperative executor on
  file-response polling.

One Bridge Architecture

FocusRelay now develops, validates, benchmarks, and ships one OmniFocus path:
the installed FocusRelay Bridge plugin invoked through Omni Automation URL
dispatch. The incomplete direct-JXA engine, OSAKit linkage, alternate dispatch,
and dual-transport benchmark code have been removed.

This does not change the MCP configuration or supported tool names. It removes
unused internal paths that duplicated query semantics and complicated release
validation.

Query And Safety Corrections

• Completed-project filters imply completed projects and compose with inclusive
  date bounds.
• Project completion-window task counts include actions exactly on the
  completedBefore boundary.
• Non-positive page limits fail at the MCP argument boundary and are also
  defensively clamped in the Bridge.
• Project fields that are not implemented no longer produce successful-looking
  no-op updates.
• Default tag catalog reads skip expensive task-count properties unless counts
  are explicitly requested.

Upgrade Notes

The plugin JavaScript and binary must stay in sync. After upgrading:

1. Reinstall FocusRelayBridge.omnijs using the packaged installer.
2. Quit OmniFocus completely and reopen it.
3. Run focusrelay --version and focusrelay bridge-health-check.
4. Run a small query and approve the Omni Automation script if OmniFocus asks.

No MCP tool names or configuration paths changed in this release.

Validation

The release candidate is certified through Swift tests, direct MCP wire probes,
Bridge semantic contracts, release builds, Bridge-only architecture checks, a
real MCP cursor-pagination journey, and the frozen 1.5-hour realistic benchmark
profile. Final measured counts and artifact verification are recorded in the
GitHub release and release tracker #131.

Contributors

The release includes the ISO8601 bridge-decoding foundation previously
contributed by @Lumenbeing, now reused at the
MCP argument boundary. Thanks also to
@osamu2001 for earlier status and cache work that
continues to underpin the corrected query contracts.

v0.10.0-beta

Installation

Homebrew (Recommended)

brew tap deverman/focus-relay
brew install focusrelay

Manual Installation

1. Download focusrelay-X.X.X.tar.gz from this release
2. Extract: tar -xzf focusrelay-X.X.X.tar.gz
3. Install the MCP server binary:

   sudo cp focusrelay-X.X.X/focusrelay /usr/local/bin/

4. Install the OmniFocus plugin:
   • Open OmniFocus
   • Go to Automation > Plug-Ins > Show Plug-In Folder in Finder
   • Copy the plugin to that folder:

     cp -r focusrelay-X.X.X/FocusRelayBridge.omnijs ~/Library/Containers/com.omnigroup.OmniFocus4/Data/Library/Application\ Support/Plug-Ins/

   • Or if using iCloud: ~/Library/Mobile Documents/iCloud~com~omnigroup~OmniFocus/Documents/Plug-Ins/
5. Restart OmniFocus completely (Cmd+Q, then reopen)
6. Configure your MCP client (see README.md in the package)

First Time Setup

⚠️ When you run your first query, OmniFocus will show a security dialog.
You MUST click "Run Script" to allow the automation to work.

SHA256 Checksum

2a124478d9c4cce6ea85b4eec2c98a63e4af2a78846cca808970d521f3ef0b06

Changes

See CHANGELOG.md for details.

v0.9.4beta

Highlights

This release focuses on finishing the performance and reliability hardening work for FocusRelayMCP's core read path.

What improved

• Reduced list_tasks timeout rate from 7.41% to 0% in clean 1-hour validation
• Made the slower end of normal list_tasks requests about 67% faster
• Improved get_task_counts median response time by 19%
• Improved slower get_task_counts requests by 14%
• Improved slower get_project_counts requests by about 36%
• Final clean validation across get_task_counts, list_tasks, and get_project_counts completed with 0 errors and 0 timeouts

Architecture decision

• Kept plugin-url as the default production architecture
• Did not switch to pure JXA
• Did not switch to plugin-jxa-dispatch

The result is a simpler decision going forward: the production path stays on the plugin query engine with URL dispatch, and future work can focus on realistic usage, caching, or runtime-pressure recovery as separate phases.

Included work

• documented Omni Automation contract for query engines
• benchmark gates and repeatable benchmark drivers
• get_task_counts fast-path and diagnostics work
• list_tasks reliability hardening, streamed paging, no-total-count fast path, and completion top-K optimization
• get_project_counts correction, diagnostics, and long-run validation

Issue

• Closes #19

Installation

Homebrew

brew tap deverman/focus-relay
brew install focusrelay

Manual installation

1. Download focusrelay-0.9.4beta.tar.gz from this release
2. Extract it:

   tar -xzf focusrelay-0.9.4beta.tar.gz

3. Install the binary:

   sudo cp focusrelay-0.9.4beta/focusrelay /usr/local/bin/

4. Install the OmniFocus plugin:

   cp -r focusrelay-0.9.4beta/FocusRelayBridge.omnijs ~/Library/Containers/com.omnigroup.OmniFocus4/Data/Library/Application\ Support/Plug-Ins/

5. Restart OmniFocus completely

First-time setup

When you run the first query, OmniFocus will ask you to approve the automation script. Click Run Script.

v0.9.3-beta

Installation

Homebrew (Recommended)

brew tap deverman/focus-relay
brew install focusrelay

Manual Installation

1. Download focusrelay-X.X.X.tar.gz from this release
2. Extract: tar -xzf focusrelay-X.X.X.tar.gz
3. Install the MCP server binary:

   sudo cp focusrelay-X.X.X/focusrelay /usr/local/bin/

4. Install the OmniFocus plugin:
   • Open OmniFocus
   • Go to Automation > Plug-Ins > Show Plug-In Folder in Finder
   • Copy the plugin to that folder:

     cp -r focusrelay-X.X.X/FocusRelayBridge.omnijs ~/Library/Containers/com.omnigroup.OmniFocus4/Data/Library/Application\ Support/Plug-Ins/

   • Or if using iCloud: ~/Library/Mobile Documents/iCloud~com~omnigroup~OmniFocus/Documents/Plug-Ins/
5. Restart OmniFocus completely (Cmd+Q, then reopen)
6. Configure your MCP client (see README.md in the package)

First Time Setup

⚠️ When you run your first query, OmniFocus will show a security dialog.
You MUST click "Run Script" to allow the automation to work.

SHA256 Checksum

b861c038aa9b7e8e06d71b0686eb589bf18b99efc7a9b1e23497998bf96df2d5  focusrelay-0.9.3-beta.tar.gz

Changes

See CHANGELOG.md for details.

v0.9.2-beta

Installation

Homebrew (Recommended)

brew tap deverman/focus-relay
brew install focusrelay

Manual Installation

1. Download focusrelay-X.X.X.tar.gz from this release
2. Extract: tar -xzf focusrelay-X.X.X.tar.gz
3. Install the MCP server binary:

   sudo cp focusrelay-X.X.X/focusrelay /usr/local/bin/

4. Install the OmniFocus plugin:
   • Open OmniFocus
   • Go to Automation > Plug-Ins > Show Plug-In Folder in Finder
   • Copy the plugin to that folder:

     cp -r focusrelay-X.X.X/FocusRelayBridge.omnijs ~/Library/Containers/com.omnigroup.OmniFocus4/Data/Library/Application\ Support/Plug-Ins/

   • Or if using iCloud: ~/Library/Mobile Documents/iCloud~com~omnigroup~OmniFocus/Documents/Plug-Ins/
5. Restart OmniFocus completely (Cmd+Q, then reopen)
6. Configure your MCP client (see README.md in the package)

First Time Setup

⚠️ When you run your first query, OmniFocus will show a security dialog.
You MUST click "Run Script" to allow the automation to work.

SHA256 Checksum

df1931a28752430fed526495dbd5a61bc9bd5cb3cb14c8492c3b8dd1e2685d05  focusrelay-0.9.2-beta.tar.gz

Changes

See CHANGELOG.md for details.

v0.9.1-beta

Installation

Homebrew (Recommended)

brew tap deverman/focus-relay
brew install focusrelay

Manual Installation

1. Download focusrelay-X.X.X.tar.gz from this release
2. Extract: tar -xzf focusrelay-X.X.X.tar.gz
3. Install the MCP server binary:

   sudo cp focusrelay-X.X.X/focusrelay /usr/local/bin/

4. Install the OmniFocus plugin:
   • Open OmniFocus
   • Go to Automation > Plug-Ins > Show Plug-In Folder in Finder
   • Copy the plugin to that folder:

     cp -r focusrelay-X.X.X/FocusRelayBridge.omnijs ~/Library/Containers/com.omnigroup.OmniFocus4/Data/Library/Application\ Support/Plug-Ins/

   • Or if using iCloud: ~/Library/Mobile Documents/iCloud~com~omnigroup~OmniFocus/Documents/Plug-Ins/
5. Restart OmniFocus completely (Cmd+Q, then reopen)
6. Configure your MCP client (see README.md in the package)

First Time Setup

⚠️ When you run your first query, OmniFocus will show a security dialog.
You MUST click "Run Script" to allow the automation to work.

SHA256 Checksum

aea8b3345d00bbd067bc9473c1aa6166216248384bdd4b5603dfc3252435dc3c  focusrelay-0.9.1-beta.tar.gz

Changes

See CHANGELOG.md for details.

v0.9.0-beta

Installation

Homebrew (Recommended)

brew tap deverman/focus-relay
brew install focus-relay-mcp

Manual Installation

1. Download focus-relay-mcp-X.X.X.tar.gz from this release
2. Extract: tar -xzf focus-relay-mcp-X.X.X.tar.gz
3. Install the MCP server binary:

   sudo cp focus-relay-mcp-X.X.X/focus-relay-mcp /usr/local/bin/

4. Install the OmniFocus plugin:
   • Open OmniFocus
   • Go to Automation > Plug-Ins > Show Plug-In Folder in Finder
   • Copy the plugin to that folder:

     cp -r focus-relay-mcp-X.X.X/FocusRelayBridge.omnijs ~/Library/Containers/com.omnigroup.OmniFocus4/Data/Library/Application\ Support/Plug-Ins/

   • Or if using iCloud: ~/Library/Mobile Documents/iCloud~com~omnigroup~OmniFocus/Documents/Plug-Ins/
5. Restart OmniFocus completely (Cmd+Q, then reopen)
6. Configure your MCP client (see README.md in the package)

First Time Setup

⚠️ When you run your first query, OmniFocus will show a security dialog.
You MUST click "Run Script" to allow the automation to work.

SHA256 Checksum

ea399a7e282f9d799038f55ee9870de62aacf7ea409b81a22b817cb2b887803e  focus-relay-mcp-0.9.0-beta.tar.gz

Changes

See CHANGELOG.md for details.