Omni-Stacks is an Alfred task center for Stacks 2. Alfred handles interaction and lightweight parameter preprocessing, while a single-binary C++ core handles projects, lists, tasks, time tracking, reminder synchronization, and persistence.

Download Omni-Stacks.alfredworkflow

Source Code Doc
More detailed release notes

Installation

Download Omni-Stacks.alfredworkflow from this Release.
Double-click the file and confirm the import in Alfred.
Open Alfred Workflow Configuration and configure command aliases, logging, notifications, sounds, and Large Type as needed.
Enter s in Alfred. On the first run, execute s ap and select the Stacks 2 workspace directory.
If you use reminder synchronization, allow macOS/Alfred to access Reminders and to automate OmniFocus.
The release package does not include data/ or log/. On first launch, an empty index and log directory are created automatically alongside the binary. When upgrading an existing installation, the user's existing data is preserved and migrated.

Initial Configuration

The default keyword is s. Workflow Configuration provides the following settings:

STACKS_LOGGING: Enables bqlog API logging and Debug tracing, retaining the most recent 3 months. <br/>
STACKS_DEBUG: Outputs the full call chain to the Alfred Debugger.
STACKS_NOTIFICATION: Shows operation notifications.
STACKS_SOUND: Plays Glass on success and Basso on failure.
STACKS_LARGE_TYPE: Displays results using Alfred Large Type.
STACKS_DELIMITER: The task field delimiter. The default is |.
STACKS_ALIAS_*: The eight command aliases ap/rl/cf/v/t/w/tm/i can all be changed.
Commands and Operations

Create a Task

Input:

s title|description|start time|due time|priority
The last four fields may be left empty. Supported date formats include today, tomorrow, +3d, weekday names, and YYYY-MM-DD.

Supported priorities are low/低, medium/中, high/高, and critical/紧急.

From the results, select a project or list and press Return to create the task. Project-level tasks are added to Backlog, while list-level tasks are added to the corresponding Stack. The task file is written to the current Stacks workspace.

s ap: Add a Path

Enter s ap.
Press Return to open the directory picker.
Select the Stacks 2 workspace.
The core recursively scans for .project files and atomically rebuilds Project.json and Stack.json.
s reload and s cl are compatibility aliases.

s rl: Reload All Paths

Enter s rl.
Press Return to rescan all saved workspaces.
This operation does not open the directory picker.
s cf: Path Configuration
Displays "Add New Path", "Reload All Paths", and all saved paths. The first path is the default Inbox path.

s v: Projects, Lists, and Tasks

Enter s v and fuzzy-filter projects or lists.
Press Return to open the task page for a project or list.
Continue entering a keyword to fuzzy-filter tasks at that level.
Press Return on a task to open its editing details.
If there are matching tasks, they are displayed. If there are no matches, "Create New Task" is displayed and the insertion flow opens.
Both the task page and task details provide Back on the last row.
Task details support the following operations:

Edit the title and description.
Set a start date, a due date, or a complete date range.
Set or clear the priority.
Complete, reopen, or archive the task.
Start or stop time tracking and write to Stacks timelogs.
Synchronize the task to Apple Reminders, OmniFocus, or both.
Move the task to the recoverable trash folder tasks/.trash.
s t: Global Task Search
Searches for tasks across all workspaces, projects, and lists. Enter:

s t keyword

s w: Due This Week

Aggregates unfinished, unarchived tasks due this week across all saved workspaces. You can synchronize this week's tasks to Reminders and OmniFocus with one action.

s tm: Time Tracking

Lists running timers. Press Return on a timer to stop it and write a Stacks-compatible timelog.

s i: Inbox

Enter s i to list all workspaces. The first workspace is the default Inbox.
Press Return on a workspace to display its Inbox tasks directly.
Enter a keyword to fuzzy-filter tasks. Press Return to edit a task.
If there are no matches, the option to create a new Inbox task is displayed automatically.
If the current workspace has no Inbox tasks, "Create Inbox Task" is displayed immediately.
Back is always the last row.
Text entered directly after s i is blocked. You must select a workspace first.

Notes
Editing the same task details simultaneously in the Stacks app and Omni-Stacks is not recommended.
Creating a task updates both the .task and .project files. If the second step fails, the new task is rolled back.
Deleting a task moves it to tasks/.trash; it is not immediately deleted permanently.
Reminder synchronization uses [Stacks-ID:<id>] in the task to deduplicate and update entries.
When STACKS_LOGGING is disabled, no bqlog or trace files are written.
When logging is enabled, interface logs and daily traces older than 3 months are cleaned up automatically.
The release package does not contain user workspace paths, indexes, or logs.