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.