From e13b4526c60c588f1c7b824290819c8fad58f92d Mon Sep 17 00:00:00 2001
From: Bohdan Triapitsyn <artmore@protonmail.com>
Date: Sun, 9 Aug 2026 21:43:16 +0300
Subject: [PATCH] feat(tasks): manage markdown loops from scheduled tasks

---
 .../docs/content/docs/scheduled-tasks.mdx     |   2 +-
 .../session/ScheduledTasksDialog.tsx          |  62 +++++---
 .../ui/src/components/views/FilesView.tsx     |  12 ++
 packages/ui/src/lib/i18n/messages/de.ts       |   1 +
 packages/ui/src/lib/i18n/messages/en.ts       |   1 +
 packages/ui/src/lib/i18n/messages/es.ts       |   1 +
 packages/ui/src/lib/i18n/messages/fr.ts       |   1 +
 packages/ui/src/lib/i18n/messages/ja.ts       |   1 +
 packages/ui/src/lib/i18n/messages/ko.ts       |   1 +
 packages/ui/src/lib/i18n/messages/pl.ts       |   1 +
 packages/ui/src/lib/i18n/messages/pt-BR.ts    |   1 +
 packages/ui/src/lib/i18n/messages/uk.ts       |   1 +
 packages/ui/src/lib/i18n/messages/zh-CN.ts    |   1 +
 packages/ui/src/lib/i18n/messages/zh-TW.ts    |   1 +
 packages/ui/src/lib/scheduledTasksApi.ts      |  31 ++++
 .../lib/scheduled-tasks/DOCUMENTATION.md      |  17 ++-
 .../web/server/lib/scheduled-tasks/loops.js   |  11 +-
 .../web/server/lib/scheduled-tasks/routes.js  |  29 ++++
 .../web/server/lib/scheduled-tasks/service.js |  44 ++++++
 .../lib/scheduled-tasks/service.test.js       | 137 +++++++++++++++++-
 20 files changed, 322 insertions(+), 34 deletions(-)

diff --git a/packages/docs/content/docs/scheduled-tasks.mdx b/packages/docs/content/docs/scheduled-tasks.mdx
index ed2fe202..358fbb3e 100644
--- a/packages/docs/content/docs/scheduled-tasks.mdx
+++ b/packages/docs/content/docs/scheduled-tasks.mdx
@@ -60,7 +60,7 @@ If a project loop and a user loop share a name, the project loop wins.
 
 ### How loops behave
 
-- The **file is authoritative** while it exists: edits made in the UI are reverted on the next sync. The scheduled-tasks dialog marks loop tasks and disables their edit/enable/delete actions — **run now** still works. To stop a loop, delete the file (or set `enabled: false`).
+- The **file is authoritative** while it exists. **Edit** opens it in the built-in file editor, the enabled toggle updates its frontmatter, and deleting the task deletes the markdown file after confirmation. **Run now** remains available.
 - Runtime state (last run, next run, status) lives in the project config and is never written back into the markdown file.
 - Renaming the `name` field renames the task in place. If a loop file temporarily fails to parse (mid-edit, merge conflict), its task is kept with the last good definition until the file is fixed.
 - `daily`/`weekly`/`once` schedules and goal settings remain UI-only; loop files are always cron.
diff --git a/packages/ui/src/components/session/ScheduledTasksDialog.tsx b/packages/ui/src/components/session/ScheduledTasksDialog.tsx
index 6590e67b..a186b742 100644
--- a/packages/ui/src/components/session/ScheduledTasksDialog.tsx
+++ b/packages/ui/src/components/session/ScheduledTasksDialog.tsx
@@ -21,14 +21,17 @@ import { useI18n } from '@/lib/i18n';
 import type { ProjectEntry } from '@/lib/api/types';
 import {
   deleteScheduledTask,
+  deleteScheduledTaskLoopFile,
   fetchScheduledTasks,
   runScheduledTaskNow,
+  setLoopScheduledTaskEnabled,
   upsertScheduledTask,
   type ScheduledTask,
   type ScheduledTaskStatus,
 } from '@/lib/scheduledTasksApi';
 import { ScheduledTaskEditorDialog } from './ScheduledTaskEditorDialog';
 import { canonicalizeTimezone } from '@/lib/timezones';
+import { useFilesViewTabsStore } from '@/stores/useFilesViewTabsStore';
 
 const scheduleTimes = (task: ScheduledTask): string[] => {
   const raw = Array.isArray(task.schedule.times)
@@ -314,10 +317,11 @@ export function ScheduledTasksDialog() {
     setMutatingTaskID(task.id);
     setTasks((prev) => prev.map((item) => (item.id === task.id ? { ...item, enabled } : item)));
     try {
-      await upsertScheduledTask(selectedProjectID, {
-        ...task,
-        enabled,
-      });
+      if (task.loopFile) {
+        await setLoopScheduledTaskEnabled(selectedProjectID, task.id, enabled);
+      } else {
+        await upsertScheduledTask(selectedProjectID, { ...task, enabled });
+      }
       await reloadTasks(selectedProjectID, { silent: true });
     } catch (error) {
       toast.error(error instanceof Error ? error.message : t('sessions.scheduledTasks.dialog.toast.updateFailed'));
@@ -331,14 +335,20 @@ export function ScheduledTasksDialog() {
     if (!selectedProjectID) {
       return;
     }
-    const confirmed = window.confirm(t('sessions.scheduledTasks.dialog.confirm.deleteTask', { taskName: task.name }));
+    const confirmed = window.confirm(task.loopFile
+      ? t('sessions.scheduledTasks.dialog.confirm.deleteLoopFile', { taskName: task.name })
+      : t('sessions.scheduledTasks.dialog.confirm.deleteTask', { taskName: task.name }));
     if (!confirmed) {
       return;
     }
 
     setMutatingTaskID(task.id);
     try {
-      await deleteScheduledTask(selectedProjectID, task.id);
+      if (task.loopFile) {
+        await deleteScheduledTaskLoopFile(selectedProjectID, task.id);
+      } else {
+        await deleteScheduledTask(selectedProjectID, task.id);
+      }
       await reloadTasks(selectedProjectID, { silent: true });
       toast.success(t('sessions.scheduledTasks.dialog.toast.deleted'));
     } catch (error) {
@@ -348,6 +358,24 @@ export function ScheduledTasksDialog() {
     }
   }, [selectedProjectID, reloadTasks, t]);
 
+  const handleEditTask = React.useCallback((task: ScheduledTask) => {
+    if (!task.loopFile) {
+      setEditorTask(task);
+      setEditorOpen(true);
+      return;
+    }
+    if (!selectedProject?.path) {
+      return;
+    }
+    setOpen(false);
+    if (isMobile) {
+      useFilesViewTabsStore.getState().setSelectedPath(selectedProject.path, task.loopFile, { allowOutsideRoot: true });
+      useUIStore.getState().setActiveMainTab('files');
+      return;
+    }
+    useUIStore.getState().openContextFile(selectedProject.path, task.loopFile);
+  }, [isMobile, selectedProject?.path, setOpen]);
+
   const handleRunNow = React.useCallback(async (task: ScheduledTask) => {
     if (!selectedProjectID) {
       return;
@@ -533,11 +561,8 @@ export function ScheduledTasksDialog() {
                     className={cn(
                       'inline-flex cursor-pointer items-center gap-2 typography-micro font-medium',
                       task.enabled ? 'text-foreground' : 'text-muted-foreground',
-                      (isBusy || task.loopFile) && 'cursor-not-allowed opacity-50',
+                      isBusy && 'cursor-not-allowed opacity-50',
                     )}
-                    title={task.loopFile
-                      ? t('sessions.scheduledTasks.dialog.loopFile.toggleDisabled')
-                      : undefined}
                   >
                     <Checkbox
                       checked={task.enabled}
@@ -545,7 +570,7 @@ export function ScheduledTasksDialog() {
                       ariaLabel={task.enabled
                         ? t('sessions.scheduledTasks.dialog.taskToggle.pauseAria', { taskName: task.name })
                         : t('sessions.scheduledTasks.dialog.taskToggle.enableAria', { taskName: task.name })}
-                      disabled={isBusy || Boolean(task.loopFile)}
+                      disabled={isBusy}
                     />
                     {task.enabled ? t('sessions.scheduledTasks.dialog.taskToggle.enabled') : t('sessions.scheduledTasks.dialog.taskToggle.paused')}
                   </label>
@@ -562,14 +587,8 @@ export function ScheduledTasksDialog() {
                     <Button
                       variant="outline"
                       size="sm"
-                      onClick={() => {
-                        setEditorTask(task);
-                        setEditorOpen(true);
-                      }}
-                      disabled={isBusy || Boolean(task.loopFile)}
-                      title={task.loopFile
-                        ? t('sessions.scheduledTasks.dialog.loopFile.actionsDisabled')
-                        : undefined}
+                      onClick={() => handleEditTask(task)}
+                      disabled={isBusy}
                       aria-label={t('sessions.scheduledTasks.dialog.actions.editAria', { taskName: task.name })}
                     >
                       <Icon name="edit-2" className="h-4 w-4" /> {t('sessions.scheduledTasks.dialog.actions.edit')}
@@ -578,10 +597,7 @@ export function ScheduledTasksDialog() {
                       variant="destructive"
                       size="sm"
                       onClick={() => void handleDeleteTask(task)}
-                      disabled={isBusy || Boolean(task.loopFile)}
-                      title={task.loopFile
-                        ? t('sessions.scheduledTasks.dialog.loopFile.actionsDisabled')
-                        : undefined}
+                      disabled={isBusy}
                       aria-label={t('sessions.scheduledTasks.dialog.actions.deleteAria', { taskName: task.name })}
                     >
                       <Icon name="delete-bin" className="h-4 w-4" />
diff --git a/packages/ui/src/components/views/FilesView.tsx b/packages/ui/src/components/views/FilesView.tsx
index 951e9dd2..5e75f6d7 100644
--- a/packages/ui/src/components/views/FilesView.tsx
+++ b/packages/ui/src/components/views/FilesView.tsx
@@ -75,6 +75,8 @@ import { useOpenInAppsStore } from '@/stores/useOpenInAppsStore';
 import { eventMatchesShortcut, getEffectiveShortcutCombo } from '@/lib/shortcuts';
 import { useI18n } from '@/lib/i18n';
 import { sessionEvents } from '@/lib/sessionEvents';
+import { syncScheduledTaskLoops } from '@/lib/scheduledTasksApi';
+import { useProjectsStore } from '@/stores/useProjectsStore';
 
 type FileNode = {
   name: string;
@@ -1668,6 +1670,16 @@ export const FilesView: React.FC<FilesViewProps> = ({ mode = 'full' }) => {
           sessionEvents.requestGitRefresh({ directory: root, paths: [relativePath] });
         }
       }
+      if (root && /(?:^|\/)\.agents\/loops\/[^/]+\.md$/i.test(normalizePath(selectedFile.path))) {
+        const project = useProjectsStore.getState().projects.find((entry) => normalizePath(entry.path) === normalizePath(root));
+        if (project) {
+          try {
+            await syncScheduledTaskLoops(project.id);
+          } catch {
+            toast.error(t('sessions.scheduledTasks.dialog.toast.updateFailed'));
+          }
+        }
+      }
       if (selectedFile?.path && isDrawioFile(selectedFile.path)) {
         diagramXmlRef.current = draftContent;
         diagramSavedXmlRef.current = draftContent;
diff --git a/packages/ui/src/lib/i18n/messages/de.ts b/packages/ui/src/lib/i18n/messages/de.ts
index 3b32b9d9..507defa2 100644
--- a/packages/ui/src/lib/i18n/messages/de.ts
+++ b/packages/ui/src/lib/i18n/messages/de.ts
@@ -213,6 +213,7 @@ export const dict = {
   'sessions.scheduledTasks.dialog.toast.started': 'Aufgabe gestartet',
   'sessions.scheduledTasks.dialog.toast.runFailed': 'Fehler beim Ausführen der Aufgabe',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': 'Geplante Aufgabe "{taskName}" löschen?',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'Loop-Aufgabe „{taskName}“ und ihre Markdown-Datei löschen?',
   'sessions.scheduledTasks.dialog.schedule.daily': 'Täglich {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': 'Täglich {time} ({timezone})',
   'sessions.scheduledTasks.dialog.schedule.weekly': 'Wöchentlich {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/en.ts b/packages/ui/src/lib/i18n/messages/en.ts
index 5a8d790d..ccbd2ad0 100644
--- a/packages/ui/src/lib/i18n/messages/en.ts
+++ b/packages/ui/src/lib/i18n/messages/en.ts
@@ -233,6 +233,7 @@ export const dict = {
   'sessions.scheduledTasks.dialog.toast.started': 'Task started',
   'sessions.scheduledTasks.dialog.toast.runFailed': 'Failed to run task',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': 'Delete scheduled task "{taskName}"?',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'Delete loop task "{taskName}" and its markdown file?',
   'sessions.scheduledTasks.dialog.schedule.daily': 'Daily {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': 'Daily {time} ({timezone})',
   'sessions.scheduledTasks.dialog.schedule.weekly': 'Weekly {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/es.ts b/packages/ui/src/lib/i18n/messages/es.ts
index 3f4aede9..f88cfe0c 100644
--- a/packages/ui/src/lib/i18n/messages/es.ts
+++ b/packages/ui/src/lib/i18n/messages/es.ts
@@ -234,6 +234,7 @@ export const dict: Record<I18nKey, string> = {
   "sessions.scheduledTasks.dialog.toast.started": "Tarea iniciada",
   "sessions.scheduledTasks.dialog.toast.runFailed": "No se pudo ejecutar la tarea",
   "sessions.scheduledTasks.dialog.confirm.deleteTask": "Eliminar tarea programada \"{taskName}\"?",
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': '¿Eliminar la tarea de bucle «{taskName}» y su archivo Markdown?',
   "sessions.scheduledTasks.dialog.schedule.daily": "Cada día {time}",
   "sessions.scheduledTasks.dialog.schedule.dailyWithTimezone": "Cada día {time} ({timezone})",
   "sessions.scheduledTasks.dialog.schedule.weekly": "Cada semana {days} {time}",
diff --git a/packages/ui/src/lib/i18n/messages/fr.ts b/packages/ui/src/lib/i18n/messages/fr.ts
index 103c87c8..51f6cd8a 100644
--- a/packages/ui/src/lib/i18n/messages/fr.ts
+++ b/packages/ui/src/lib/i18n/messages/fr.ts
@@ -70,6 +70,7 @@ export const dict = {
   'sessions.scheduledTasks.dialog.toast.started': 'Tâche démarrée',
   'sessions.scheduledTasks.dialog.toast.runFailed': 'Échec de l\'exécution de la tâche',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': 'Supprimer la tâche planifiée « {taskName} » ?',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'Supprimer la tâche en boucle « {taskName} » et son fichier Markdown ?',
   'sessions.scheduledTasks.dialog.schedule.daily': 'Quotidien {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': 'Quotidien {time} ({timezone})',
   'sessions.scheduledTasks.dialog.schedule.weekly': 'Hebdomadaire {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/ja.ts b/packages/ui/src/lib/i18n/messages/ja.ts
index 2534e6e7..fa41fdd3 100644
--- a/packages/ui/src/lib/i18n/messages/ja.ts
+++ b/packages/ui/src/lib/i18n/messages/ja.ts
@@ -234,6 +234,7 @@ export const dict: Record<I18nKey, string> = {
   'sessions.scheduledTasks.dialog.toast.started': 'タスクを開始しました',
   'sessions.scheduledTasks.dialog.toast.runFailed': 'タスクの実行に失敗しました',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': 'スケジュールタスク「{taskName}」を削除しますか？',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'ループタスク「{taskName}」とその Markdown ファイルを削除しますか？',
   'sessions.scheduledTasks.dialog.schedule.daily': '毎日 {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': '毎日 {time}（{timezone}）',
   'sessions.scheduledTasks.dialog.schedule.weekly': '毎週 {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/ko.ts b/packages/ui/src/lib/i18n/messages/ko.ts
index f8e27b6a..924ae307 100644
--- a/packages/ui/src/lib/i18n/messages/ko.ts
+++ b/packages/ui/src/lib/i18n/messages/ko.ts
@@ -234,6 +234,7 @@ export const dict: Record<I18nKey, string> = {
   'sessions.scheduledTasks.dialog.toast.started': '작업 시작됨',
   'sessions.scheduledTasks.dialog.toast.runFailed': '작업 실행 실패',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': '예약 작업 "{taskName}" 삭제?',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': '루프 작업 "{taskName}" 및 해당 Markdown 파일을 삭제할까요?',
   'sessions.scheduledTasks.dialog.schedule.daily': '매일 {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': '매일 {time} ({timezone})',
   'sessions.scheduledTasks.dialog.schedule.weekly': '매주 {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/pl.ts b/packages/ui/src/lib/i18n/messages/pl.ts
index e4d0c3a2..079153ef 100644
--- a/packages/ui/src/lib/i18n/messages/pl.ts
+++ b/packages/ui/src/lib/i18n/messages/pl.ts
@@ -361,6 +361,7 @@ export const dict: Record<I18nKey, string> = {
   'sessions.scheduledTasks.dialog.toast.started': 'Zadanie uruchomione',
   'sessions.scheduledTasks.dialog.toast.runFailed': 'Nie udało się uruchomić zadania',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': 'Usunąć zaplanowane zadanie "{taskName}"?',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'Usunąć zadanie pętli „{taskName}” i jego plik Markdown?',
   'sessions.scheduledTasks.dialog.schedule.daily': 'Codziennie {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': 'Codziennie {time} ({timezone})',
   'sessions.scheduledTasks.dialog.schedule.weekly': 'Co tydzień {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/pt-BR.ts b/packages/ui/src/lib/i18n/messages/pt-BR.ts
index 23713a12..1a5cc0cf 100644
--- a/packages/ui/src/lib/i18n/messages/pt-BR.ts
+++ b/packages/ui/src/lib/i18n/messages/pt-BR.ts
@@ -234,6 +234,7 @@ export const dict: Record<I18nKey, string> = {
   "sessions.scheduledTasks.dialog.toast.started": "Tarefa iniciada",
   "sessions.scheduledTasks.dialog.toast.runFailed": "Não foi possível executar a tarefa",
   "sessions.scheduledTasks.dialog.confirm.deleteTask": "Excluir tarefa agendada \"{taskName}\"?",
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'Excluir a tarefa de loop “{taskName}” e seu arquivo Markdown?',
   "sessions.scheduledTasks.dialog.schedule.daily": "Todos os dias {time}",
   "sessions.scheduledTasks.dialog.schedule.dailyWithTimezone": "Todos os dias {time} ({timezone})",
   "sessions.scheduledTasks.dialog.schedule.weekly": "Toda semana {days} {time}",
diff --git a/packages/ui/src/lib/i18n/messages/uk.ts b/packages/ui/src/lib/i18n/messages/uk.ts
index 22f7f740..9068e465 100644
--- a/packages/ui/src/lib/i18n/messages/uk.ts
+++ b/packages/ui/src/lib/i18n/messages/uk.ts
@@ -234,6 +234,7 @@ export const dict: Record<I18nKey, string> = {
   "sessions.scheduledTasks.dialog.toast.started": "Завдання розпочато",
   "sessions.scheduledTasks.dialog.toast.runFailed": "Не вдалося виконати завдання",
   "sessions.scheduledTasks.dialog.confirm.deleteTask": "Видалити заплановане завдання \"{taskName}\"?",
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': 'Видалити циклічне завдання «{taskName}» і його Markdown-файл?',
   "sessions.scheduledTasks.dialog.schedule.daily": "Щодня {time}",
   "sessions.scheduledTasks.dialog.schedule.dailyWithTimezone": "Щодня {time} ({timezone})",
   "sessions.scheduledTasks.dialog.schedule.weekly": "Щотижня {days} {time}",
diff --git a/packages/ui/src/lib/i18n/messages/zh-CN.ts b/packages/ui/src/lib/i18n/messages/zh-CN.ts
index 1d66ebf0..79fbe910 100644
--- a/packages/ui/src/lib/i18n/messages/zh-CN.ts
+++ b/packages/ui/src/lib/i18n/messages/zh-CN.ts
@@ -234,6 +234,7 @@ export const dict: Record<I18nKey, string> = {
   'sessions.scheduledTasks.dialog.toast.started': '任务已启动',
   'sessions.scheduledTasks.dialog.toast.runFailed': '运行任务失败',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': '删除计划任务“{taskName}”？',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': '删除循环任务“{taskName}”及其 Markdown 文件？',
   'sessions.scheduledTasks.dialog.schedule.daily': '每天 {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': '每天 {time}（{timezone}）',
   'sessions.scheduledTasks.dialog.schedule.weekly': '每周 {days} {time}',
diff --git a/packages/ui/src/lib/i18n/messages/zh-TW.ts b/packages/ui/src/lib/i18n/messages/zh-TW.ts
index 6d81c64d..bfbb98d0 100644
--- a/packages/ui/src/lib/i18n/messages/zh-TW.ts
+++ b/packages/ui/src/lib/i18n/messages/zh-TW.ts
@@ -247,6 +247,7 @@ export const dict: Record<I18nKey, string> = {
   'sessions.scheduledTasks.dialog.toast.started': '任務已啟動',
   'sessions.scheduledTasks.dialog.toast.runFailed': '執行任務失敗',
   'sessions.scheduledTasks.dialog.confirm.deleteTask': '刪除排程任務「{taskName}」？',
+  'sessions.scheduledTasks.dialog.confirm.deleteLoopFile': '刪除迴圈任務「{taskName}」及其 Markdown 檔案？',
   'sessions.scheduledTasks.dialog.schedule.daily': '每天 {time}',
   'sessions.scheduledTasks.dialog.schedule.dailyWithTimezone': '每天 {time}（{timezone}）',
   'sessions.scheduledTasks.dialog.schedule.weekly': '每週 {days} {time}',
diff --git a/packages/ui/src/lib/scheduledTasksApi.ts b/packages/ui/src/lib/scheduledTasksApi.ts
index c7c4aeb1..201f71c6 100644
--- a/packages/ui/src/lib/scheduledTasksApi.ts
+++ b/packages/ui/src/lib/scheduledTasksApi.ts
@@ -112,6 +112,37 @@ export const deleteScheduledTask = async (projectID: string, taskID: string): Pr
   return parsed.tasks as ScheduledTask[];
 };
 
+const getLoopFileEndpoint = (projectID: string, taskID: string): string => {
+  const safeProjectID = ensureProjectID(projectID);
+  const safeTaskID = ensureProjectID(taskID);
+  return `/api/projects/${encodeURIComponent(safeProjectID)}/scheduled-tasks/${encodeURIComponent(safeTaskID)}/loop-file`;
+};
+
+export const setLoopScheduledTaskEnabled = async (projectID: string, taskID: string, enabled: boolean): Promise<void> => {
+  const response = await runtimeFetch(getLoopFileEndpoint(projectID, taskID), {
+    method: 'PATCH',
+    headers: { 'content-type': 'application/json', accept: 'application/json' },
+    body: JSON.stringify({ enabled }),
+  });
+  if (!response.ok) {
+    throw new Error(await parseErrorMessage(response, 'Failed to update loop task'));
+  }
+};
+
+export const deleteScheduledTaskLoopFile = async (projectID: string, taskID: string): Promise<void> => {
+  const response = await runtimeFetch(getLoopFileEndpoint(projectID, taskID), {
+    method: 'DELETE',
+    headers: { accept: 'application/json' },
+  });
+  if (!response.ok) {
+    throw new Error(await parseErrorMessage(response, 'Failed to delete loop file'));
+  }
+};
+
+export const syncScheduledTaskLoops = async (projectID: string): Promise<void> => {
+  await fetchScheduledTasks(projectID);
+};
+
 export const runScheduledTaskNow = async (projectID: string, taskID: string): Promise<{ sessionId?: string }> => {
   const safeProjectID = ensureProjectID(projectID);
   const safeTaskID = ensureProjectID(taskID);
diff --git a/packages/web/server/lib/scheduled-tasks/DOCUMENTATION.md b/packages/web/server/lib/scheduled-tasks/DOCUMENTATION.md
index a7fa66c0..33d48502 100644
--- a/packages/web/server/lib/scheduled-tasks/DOCUMENTATION.md
+++ b/packages/web/server/lib/scheduled-tasks/DOCUMENTATION.md
@@ -26,6 +26,7 @@ Server-owned scheduled task runtime and routes for OpenChamber-only automation.
 - `packages/web/server/lib/scheduled-tasks/routes.js`
   - Scheduled task CRUD endpoints
   - Listing tasks reconciles loop files first, so opening the Scheduled Tasks UI discovers file additions, edits, and removals without a server restart
+  - Loop-file endpoints toggle `enabled` in frontmatter or delete the authoritative markdown file, then reconcile the project
   - Manual run endpoint
   - OpenChamber events SSE stream endpoint
 
@@ -94,14 +95,12 @@ project write lock on every `syncProject` when the project path is known:
 - **Malformed files** (missing `name`/`schedule`/`model`/body, invalid cron,
   unreadable) are reported to the scheduler as `definition: null` entries and
   warned about; they never block valid loops in the same or other scopes.
-- **UI edits** to a loop-sourced task are preserved in the config but the loop
-  file remains authoritative: the next reconciliation re-applies the file's
-  definition (including `enabled`). Use `enabled: false` in the file to
-  disable. Deleting a loop-sourced task through the API is rejected with a 400
-  while its loop file still exists on disk — the loop file is the removal
-  surface; once the file is gone, deleting the orphan task is allowed. The
-  scheduled-tasks UI marks loop tasks as file-managed and disables their
-  edit/enable/delete actions for the same reason; `run now` remains available.
+- **Loop-file mutations.** The loop file remains authoritative. The scheduled-
+  tasks UI opens it in the built-in file editor, updates its `enabled`
+  frontmatter through the loop-file endpoint, and deletes the file through the
+  loop-file endpoint after confirmation. Each mutation reconciles the project.
+  The general task deletion API still rejects loop-sourced tasks while their
+  file exists; once the file is gone, deleting an orphan task is allowed.
 
 ## Public exports (runtime.js)
 
@@ -120,6 +119,8 @@ project write lock on every `syncProject` when the project path is known:
   - `GET /api/projects/:projectId/scheduled-tasks`
   - `PUT /api/projects/:projectId/scheduled-tasks`
   - `DELETE /api/projects/:projectId/scheduled-tasks/:taskId`
+  - `PATCH /api/projects/:projectId/scheduled-tasks/:taskId/loop-file`
+  - `DELETE /api/projects/:projectId/scheduled-tasks/:taskId/loop-file`
   - `POST /api/projects/:projectId/scheduled-tasks/:taskId/run`
   - `GET /api/openchamber/scheduled-tasks/status`
   - `GET /api/openchamber/events`
diff --git a/packages/web/server/lib/scheduled-tasks/loops.js b/packages/web/server/lib/scheduled-tasks/loops.js
index 7d15e671..b7dc4c7d 100644
--- a/packages/web/server/lib/scheduled-tasks/loops.js
+++ b/packages/web/server/lib/scheduled-tasks/loops.js
@@ -40,7 +40,7 @@
 import fs from 'fs';
 import os from 'os';
 import path from 'path';
-import { parseMdFile, getAncestors, findWorktreeRoot } from '../opencode/shared.js';
+import { parseMdFile, writeMdFile, getAncestors, findWorktreeRoot } from '../opencode/shared.js';
 import { MAX_TASK_NAME_LENGTH } from '../projects/project-config.js';
 
 const LOOP_DIR_NAME = 'loops';
@@ -140,6 +140,15 @@ export const parseLoopDefinition = (filePath) => {
   };
 };
 
+export const setLoopFileEnabled = (filePath, enabled) => {
+  if (!parseLoopDefinition(filePath)) {
+    return false;
+  }
+  const { frontmatter, body } = parseMdFile(filePath);
+  writeMdFile(filePath, { ...frontmatter, enabled: Boolean(enabled) }, body);
+  return true;
+};
+
 const walkLoopMdFiles = (rootDir) => {
   if (!rootDir || !fs.existsSync(rootDir)) {
     return [];
diff --git a/packages/web/server/lib/scheduled-tasks/routes.js b/packages/web/server/lib/scheduled-tasks/routes.js
index b4e97c52..236ef0d6 100644
--- a/packages/web/server/lib/scheduled-tasks/routes.js
+++ b/packages/web/server/lib/scheduled-tasks/routes.js
@@ -81,6 +81,35 @@ export const registerScheduledTaskRoutes = (app, dependencies) => {
     }
   });
 
+  app.patch('/api/projects/:projectId/scheduled-tasks/:taskId/loop-file', async (req, res) => {
+    const projectID = parseProjectID(req);
+    const taskID = parseTaskID(req);
+    if (!projectID) return res.status(400).json({ error: 'projectId is required' });
+    if (!taskID) return res.status(400).json({ error: 'taskId is required' });
+    try {
+      const task = await scheduledTaskService.setLoopEnabled(projectID, taskID, req.body?.enabled);
+      return res.json({ task });
+    } catch (error) {
+      if (error?.statusCode) return res.status(error.statusCode).json({ error: error.message });
+      console.error('[ScheduledTasks] failed to update loop file:', error);
+      return res.status(500).json({ error: 'Failed to update loop file' });
+    }
+  });
+
+  app.delete('/api/projects/:projectId/scheduled-tasks/:taskId/loop-file', async (req, res) => {
+    const projectID = parseProjectID(req);
+    const taskID = parseTaskID(req);
+    if (!projectID) return res.status(400).json({ error: 'projectId is required' });
+    if (!taskID) return res.status(400).json({ error: 'taskId is required' });
+    try {
+      return res.json({ tasks: await scheduledTaskService.removeLoopFile(projectID, taskID) });
+    } catch (error) {
+      if (error?.statusCode) return res.status(error.statusCode).json({ error: error.message });
+      console.error('[ScheduledTasks] failed to delete loop file:', error);
+      return res.status(500).json({ error: 'Failed to delete loop file' });
+    }
+  });
+
   app.post('/api/projects/:projectId/scheduled-tasks/:taskId/run', async (req, res) => {
     const projectID = parseProjectID(req);
     const taskID = parseTaskID(req);
diff --git a/packages/web/server/lib/scheduled-tasks/service.js b/packages/web/server/lib/scheduled-tasks/service.js
index 506550f9..0f286991 100644
--- a/packages/web/server/lib/scheduled-tasks/service.js
+++ b/packages/web/server/lib/scheduled-tasks/service.js
@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { OpenChamberControlError } from '../openchamber-control/error.js';
+import { setLoopFileEnabled } from './loops.js';
 
 const asNonEmptyString = (value) => {
   if (typeof value !== 'string') return null;
@@ -53,6 +54,47 @@ export const createScheduledTaskService = (dependencies) => {
     return scheduledTasksRuntime.syncProject(projectID);
   };
 
+  const findLoopTask = async (projectID, taskID) => {
+    await findProjectByID(projectID);
+    const normalizedTaskID = asNonEmptyString(taskID);
+    if (!normalizedTaskID) throw new OpenChamberControlError('taskId is required', 400);
+    const tasks = await scheduledTasksRuntime.syncProject(projectID);
+    const task = tasks.find((entry) => entry?.id === normalizedTaskID) || null;
+    if (!task) throw new OpenChamberControlError('Task not found', 404);
+    if (!task.loopFile) throw new OpenChamberControlError('Task is not managed by a loop file', 400);
+    if (!fs.existsSync(task.loopFile)) throw new OpenChamberControlError('Loop file not found', 404);
+    return task;
+  };
+
+  const setLoopEnabled = async (projectID, taskID, enabled) => {
+    if (typeof enabled !== 'boolean') {
+      throw new OpenChamberControlError('enabled must be a boolean', 400);
+    }
+    const task = await findLoopTask(projectID, taskID);
+    try {
+      if (!setLoopFileEnabled(task.loopFile, enabled)) {
+        throw new OpenChamberControlError('Loop file must be valid before changing its enabled state', 400);
+      }
+    } catch (error) {
+      if (error instanceof OpenChamberControlError) throw error;
+      const message = error instanceof Error ? error.message : 'Failed to update loop file';
+      throw new OpenChamberControlError(message, 500);
+    }
+    const tasks = await scheduledTasksRuntime.syncProject(projectID);
+    return tasks.find((entry) => entry.id === taskID) || null;
+  };
+
+  const removeLoopFile = async (projectID, taskID) => {
+    const task = await findLoopTask(projectID, taskID);
+    try {
+      fs.unlinkSync(task.loopFile);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Failed to delete loop file';
+      throw new OpenChamberControlError(message, 500);
+    }
+    return scheduledTasksRuntime.syncProject(projectID);
+  };
+
   const upsert = async (projectID, taskInput) => {
     await findProjectByID(projectID);
     if (!taskInput || typeof taskInput !== 'object') {
@@ -154,6 +196,8 @@ export const createScheduledTaskService = (dependencies) => {
     remove,
     run,
     setEnabled,
+    setLoopEnabled,
+    removeLoopFile,
     status,
   };
 };
diff --git a/packages/web/server/lib/scheduled-tasks/service.test.js b/packages/web/server/lib/scheduled-tasks/service.test.js
index 61643157..ca7e0685 100644
--- a/packages/web/server/lib/scheduled-tasks/service.test.js
+++ b/packages/web/server/lib/scheduled-tasks/service.test.js
@@ -1,8 +1,9 @@
 import { describe, expect, it, vi } from 'vitest';
 import os from 'os';
 import path from 'path';
-import { mkdtemp, rm, writeFile } from 'fs/promises';
+import { mkdtemp, readFile, rm, writeFile } from 'fs/promises';
 import { createScheduledTaskService } from './service.js';
+import { registerScheduledTaskRoutes } from './routes.js';
 
 const createService = (overrides = {}) => {
   const projectConfigRuntime = {
@@ -64,6 +65,140 @@ describe('scheduled-task service list', () => {
   });
 });
 
+describe('scheduled-task loop-file mutations', () => {
+  it('updates only enabled in loop frontmatter and reconciles the task', async () => {
+    const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'oc-loop-toggle-'));
+    try {
+      const loopFilePath = path.join(tempRoot, 'daily.md');
+      await writeFile(loopFilePath, `---
+name: daily-digest
+schedule: "0 9 * * *"
+enabled: true
+model: openai/gpt-5
+custom: keep-me
+---
+
+Run the digest.
+`, 'utf8');
+      const currentTask = { ...loopTask, loopFile: loopFilePath };
+      const updatedTask = { ...currentTask, enabled: false };
+      const syncProject = vi.fn()
+        .mockResolvedValueOnce([currentTask])
+        .mockResolvedValueOnce([updatedTask]);
+      const { service } = createService({ scheduledTasksRuntime: { syncProject } });
+
+      await expect(service.setLoopEnabled('project-test', currentTask.id, false)).resolves.toEqual(updatedTask);
+
+      const content = await readFile(loopFilePath, 'utf8');
+      expect(content).toContain('enabled: false');
+      expect(content).toContain('custom: keep-me');
+      expect(content).toContain('Run the digest.');
+      expect(syncProject).toHaveBeenCalledTimes(2);
+    } finally {
+      await rm(tempRoot, { recursive: true, force: true });
+    }
+  });
+
+  it('deletes the authoritative loop file and reconciles the task away', async () => {
+    const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'oc-loop-remove-'));
+    try {
+      const loopFilePath = path.join(tempRoot, 'daily.md');
+      await writeFile(loopFilePath, 'loop', 'utf8');
+      const currentTask = { ...loopTask, loopFile: loopFilePath };
+      const syncProject = vi.fn()
+        .mockResolvedValueOnce([currentTask])
+        .mockResolvedValueOnce([]);
+      const { service } = createService({ scheduledTasksRuntime: { syncProject } });
+
+      await expect(service.removeLoopFile('project-test', currentTask.id)).resolves.toEqual([]);
+      await expect(readFile(loopFilePath, 'utf8')).rejects.toMatchObject({ code: 'ENOENT' });
+      expect(syncProject).toHaveBeenCalledTimes(2);
+    } finally {
+      await rm(tempRoot, { recursive: true, force: true });
+    }
+  });
+
+  it('does not rewrite a malformed loop when toggling', async () => {
+    const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'oc-loop-invalid-'));
+    try {
+      const loopFilePath = path.join(tempRoot, 'daily.md');
+      const malformed = '---\nname: daily-digest\n---\nRun.\n';
+      await writeFile(loopFilePath, malformed, 'utf8');
+      const currentTask = { ...loopTask, loopFile: loopFilePath };
+      const syncProject = vi.fn(async () => [currentTask]);
+      const { service } = createService({ scheduledTasksRuntime: { syncProject } });
+
+      await expect(service.setLoopEnabled('project-test', currentTask.id, false)).rejects.toMatchObject({ statusCode: 400 });
+      await expect(readFile(loopFilePath, 'utf8')).resolves.toBe(malformed);
+      expect(syncProject).toHaveBeenCalledOnce();
+    } finally {
+      await rm(tempRoot, { recursive: true, force: true });
+    }
+  });
+});
+
+describe('scheduled-task loop-file routes', () => {
+  const createResponse = () => ({
+    statusCode: 200,
+    payload: null,
+    status(code) {
+      this.statusCode = code;
+      return this;
+    },
+    json(payload) {
+      this.payload = payload;
+      return this;
+    },
+  });
+
+  const captureHandlers = (scheduledTaskService) => {
+    const handlers = new Map();
+    const app = {
+      get: vi.fn(),
+      put: vi.fn(),
+      post: vi.fn(),
+      patch: vi.fn((route, handler) => handlers.set(`PATCH ${route}`, handler)),
+      delete: vi.fn((route, handler) => handlers.set(`DELETE ${route}`, handler)),
+    };
+    registerScheduledTaskRoutes(app, {
+      scheduledTaskService,
+      readSettingsFromDiskMigrated: vi.fn(),
+      sanitizeProjects: vi.fn(),
+      projectConfigRuntime: {},
+      scheduledTasksRuntime: {},
+      getOpenChamberEventClients: () => new Set(),
+      writeSseEvent: vi.fn(),
+    });
+    return handlers;
+  };
+
+  it('routes loop enabled changes through the loop-file service', async () => {
+    const setLoopEnabled = vi.fn(async () => ({ ...loopTask, enabled: false }));
+    const handlers = captureHandlers({ setLoopEnabled });
+    const handler = handlers.get('PATCH /api/projects/:projectId/scheduled-tasks/:taskId/loop-file');
+    const res = createResponse();
+
+    await handler({ params: { projectId: 'project-test', taskId: loopTask.id }, body: { enabled: false } }, res);
+
+    expect(setLoopEnabled).toHaveBeenCalledWith('project-test', loopTask.id, false);
+    expect(res.statusCode).toBe(200);
+    expect(res.payload.task.enabled).toBe(false);
+  });
+
+  it('routes loop deletion through the loop-file service', async () => {
+    const removeLoopFile = vi.fn(async () => []);
+    const handlers = captureHandlers({ removeLoopFile });
+    const handler = handlers.get('DELETE /api/projects/:projectId/scheduled-tasks/:taskId/loop-file');
+    const res = createResponse();
+
+    await handler({ params: { projectId: 'project-test', taskId: loopTask.id } }, res);
+
+    expect(removeLoopFile).toHaveBeenCalledWith('project-test', loopTask.id);
+    expect(res.statusCode).toBe(200);
+    expect(res.payload).toEqual({ tasks: [] });
+  });
+});
+
 describe('scheduled-task service remove', () => {
   it('rejects deleting a loop-sourced task while its loop file still exists', async () => {
     const tempRoot = await mkdtemp(path.join(os.tmpdir(), 'oc-loop-delete-'));