From dc41de9a4e4b48d2bdc565418aadc3cec3f3add7 Mon Sep 17 00:00:00 2001 From: YanzheL Date: Thu, 2 Apr 2026 02:24:20 +0800 Subject: [PATCH] docs: fix Sisyphus Tasks config reference to match actual schema The Sisyphus Tasks section documented a nonexistent 'enabled' field with a default of 'false', which contradicts the actual behavior: - The SisyphusTasksConfigSchema has no 'enabled' field; it only has storage_path, task_list_id, and claude_code_compat - The task system toggle lives at experimental.task_system and defaults to true (since v3.14) Updated the docs to: - Remove the phantom 'enabled' field from example and options table - Add the missing 'task_list_id' option that exists in the schema - Clarify that sisyphus.tasks configures storage only - Point to experimental.task_system as the actual on/off toggle - Explain what the task system does (replaces TodoWrite/TodoRead) --- docs/reference/configuration.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md index ad582c258..0b25595e6 100644 --- a/docs/reference/configuration.md +++ b/docs/reference/configuration.md @@ -435,13 +435,14 @@ Sisyphus agents can also be customized under `agents` using their names: `Sisyph ### Sisyphus Tasks -Enable the Sisyphus Tasks system for cross-session task tracking. +File-based task persistence with dependency tracking, used for cross-session task management. The task system is controlled by `experimental.task_system` (defaults to `true` since v3.14). When enabled, `TodoWrite`/`TodoRead` are intercepted and replaced with the Task tools (`task_create`, `task_get`, `task_list`, `task_update`). + +The `sisyphus.tasks` section configures **storage options** only: ```json { "sisyphus": { "tasks": { - "enabled": false, "storage_path": ".sisyphus/tasks", "claude_code_compat": false } @@ -451,10 +452,18 @@ Enable the Sisyphus Tasks system for cross-session task tracking. | Option | Default | Description | | -------------------- | ----------------- | ------------------------------------------ | -| `enabled` | `false` | Enable Sisyphus Tasks system | | `storage_path` | `.sisyphus/tasks` | Storage path (relative to project root) | +| `task_list_id` | - | Force task list ID (alternative to env `ULTRAWORK_TASK_LIST_ID`) | | `claude_code_compat` | `false` | Enable Claude Code path compatibility mode | +To disable the task system entirely, set `experimental.task_system` to `false`: + +```json +{ + "experimental": { "task_system": false } +} +``` + --- ## Features