octomux 1.0.34 → 1.1.0

package/README.md

@@ -6,7 +6,7 @@
 
 > **Coding got faster. Managing agents didn't.**
 
-A local web app to **dispatch, watch, and review** parallel **Claude Code** and **Cursor** agents from one place. Kanban for fleet status. One inbox for every "allow this tool?" prompt. In-app diff review with **Ship**. No cloud. MIT.
+A local web app to **dispatch, watch, and review** parallel **Claude Code** and **Cursor** agents from one place. Kanban for fleet status. One inbox for every "allow this tool?" prompt. In-app diff review with **Ship**. Run it from npm or the native macOS app. No cloud. MIT.
 
 ```bash
 npm install -g octomux && octomux init && cd your-repo && octomux start
@@ -20,7 +20,7 @@ Open [http://localhost:7777](http://localhost:7777) — describe a task in the c
 
 Three phases, one window:
 
-- **01 — Dispatch.** Type a task. Pick Claude Code or Cursor. Hit go. The composer takes plain English, Jira links, or GitHub issue URLs. Drop a second agent on the same branch with one click — or paste a whole list and **bulk-create** a worktree, branch, and agent for each.
+- **01 — Dispatch.** Type a task. Pick Claude Code or Cursor. Hit go. The composer takes plain English, Jira or Linear links, or GitHub issue URLs. Drop a second agent on the same branch with one click — or paste a whole list and **bulk-create** a worktree, branch, and agent for each.
 - **02 — Watch.** See every agent work, live. Each task streams its own view — files the agent is editing, the diff as it grows, terminal output as it runs. The **Monitor** view tiles every running agent into one grid so you can scan the whole fleet at a glance. When an agent needs permission, the prompt lands in your inbox so you don't have to babysit every pane.
 - **03 — Review & Ship.** Diff review in the same window. File tree, per-file reviewed state, inline comments. Hit **Ship** and the PR auto-links to the task — closes itself when the PR merges.
 
@@ -49,7 +49,9 @@ Code never leaves your laptop. No telemetry, no cloud sync. Crash, reboot, close
 - **Agents that dispatch agents** — `/create-task`, `/list-tasks`, `/send-agent-message` skills work inside any Claude Code window; recursive dispatch from inside an agent.
 - **Agent teams** — reusable crews defined as code in `<repo>/.octomux/team.yaml`: a lead spawns workers from a roster, each with its own model. Run on demand (`octomux team run`) or on a cron schedule.
 - **Per-task model** — pin any task or added agent to a specific model (`--model claude-opus-4-8`); mix models across a fleet so the right one lands on each job.
-- **Integrations** — Jira wiring plus orchestrator skills for GitHub / auto-review intake.
+- **Completion notifications** — link a worker to an orchestrator with `add-agent --notify-agent`; the lead gets pinged when each worker finishes. Teams wire this up automatically.
+- **Mobile-ready dashboard** — bottom nav, responsive pages, and mobile-friendly terminal scroll buttons; check the fleet and answer prompts from your phone.
+- **Integrations** — Jira and Linear sync (status push + comment-back, composer prefill) plus orchestrator skills for GitHub / auto-review intake.
 - **CLI ↔ dashboard parity** — `octomux create-task`, `send-message`, `resume-task` — same tasks the UI shows.
 - **Reboot-proof** — WAL SQLite + preserved worktrees across restarts.
 - **Local-only** — no telemetry, no cloud sync, no analytics. Your `.env` stays on the host.
@@ -77,7 +79,7 @@ Give an agent the orchestrator skills. It plans the work, breaks down the spec,
 ## Quick start
 
 ```bash
-brew install tmux git
+brew install git
 npm install -g @anthropic-ai/claude-code    # and/or Cursor CLI
 npm install -g octomux
 octomux init
@@ -85,11 +87,20 @@ cd your-project
 octomux start
 ```
 
+`tmux` ships bundled — octomux installs a static `tmux` for your platform (macOS and Linux,
+arm64/x64) and uses it automatically, so there's no separate `brew install tmux` step.
+
 ```bash
 octomux create-task -t "Add OAuth login" -r .
 octomux create-task -t "Spike with Cursor" -r . --harness cursor
 ```
 
+**Prefer a desktop app?** macOS users can download the `.dmg` from
+[GitHub Releases](https://github.com/ShreyPaharia/octomux/releases) instead of the npm CLI.
+It bundles its own `tmux` and runs against an isolated data directory (its own DB, tmux
+socket, and logs), so it never collides with a CLI install on the same machine. The build is
+ad-hoc signed (not notarized) — if macOS warns on first launch, right-click the app → **Open**.
+
 Step-by-step setup, Jira, and orchestrator skills: [ONBOARDING.md](./ONBOARDING.md)
 
 ## How it works
@@ -110,17 +121,17 @@ DISPATCH → BRANCH → CODE → INBOX → REVIEW → MERGE
 
 ## CLI
 
-| Command                                  | Description                                              |
-| ---------------------------------------- | -------------------------------------------------------- |
-| `octomux start`                          | Dashboard at `:7777`                                     |
-| `octomux init`                           | Defaults wizard (Jira, base branch, harness prefs)       |
-| `octomux create-task`                    | New task (`--harness cursor` optional)                   |
-| `octomux list-tasks` / `get-task`        | Inspect tasks                                            |
-| `octomux close-task` / `delete-task`     | Stop or fully remove                                     |
-| `octomux resume-task`                    | Resume a closed task                                     |
-| `octomux add-agent`                      | Another agent window (`--skeleton`, `--model` optional)  |
-| `octomux send-message`                   | Message a running agent — course-correct without restart |
-| `octomux team run` / `schedule` / `list` | Run or schedule an agent crew from `.octomux/team.yaml`  |
+| Command                                  | Description                                                               |
+| ---------------------------------------- | ------------------------------------------------------------------------- |
+| `octomux start`                          | Dashboard at `:7777`                                                      |
+| `octomux init`                           | Defaults wizard (Jira, base branch, harness prefs)                        |
+| `octomux create-task`                    | New task (`--harness cursor` optional)                                    |
+| `octomux list-tasks` / `get-task`        | Inspect tasks                                                             |
+| `octomux close-task` / `delete-task`     | Stop or fully remove                                                      |
+| `octomux resume-task`                    | Resume a closed task                                                      |
+| `octomux add-agent`                      | Another agent window (`--skeleton`, `--model`, `--notify-agent` optional) |
+| `octomux send-message`                   | Message a running agent — course-correct without restart                  |
+| `octomux team run` / `schedule` / `list` | Run or schedule an agent crew from `.octomux/team.yaml`                   |
 
 ## Architecture
 
@@ -156,11 +167,12 @@ flowchart LR
 ## Requirements
 
 - macOS (ARM64 or x64), Node.js 20+ (24 LTS recommended)
-- `tmux`, `git`
+- `git` (`tmux` ships bundled — installed automatically, no manual step)
 - At least one harness: **Claude Code** (`claude`) and/or **Cursor CLI** (`cursor-agent`)
 - Recommended: `lazygit`, `neovim`
+- macOS desktop app (`.dmg`) available on [GitHub Releases](https://github.com/ShreyPaharia/octomux/releases) as an alternative to the npm CLI
 
-> First run flags only the deps you're actually missing — install what the setup banner asks for and you're good. Jira and other integrations are configured later from the in-app **Integrations** page.
+> First run flags only the deps you're actually missing — install what the setup banner asks for and you're good. Jira, Linear, and other integrations are configured later from the in-app **Integrations** page.
 
 ## Configuration
 

package/bin/octomux.js

@@ -69,6 +69,7 @@ async function runStart(startArgs) {
 
   // Install bundled skills and configs
   installSkills();
+  installWorkflows();
   installLazygitConfig();
 
   // Ensure cli/ dependencies are installed
@@ -268,3 +269,22 @@ function installSkills() {
     console.log('Installed octomux skills for Claude Code');
   }
 }
+
+function installWorkflows() {
+  const src = path.join(__dirname, '..', 'workflows');
+  const target = path.join(os.homedir(), '.claude', 'workflows');
+  if (!existsSync(src)) return;
+
+  mkdirSync(target, { recursive: true });
+  let installed = false;
+  for (const file of readdirSync(src)) {
+    if (!file.endsWith('.js')) continue;
+    // Overwrite so workflow updates actually ship (unlike skills, which only
+    // install when missing). The review-deep skill invokes these by scriptPath.
+    cpSync(path.join(src, file), path.join(target, file));
+    installed = true;
+  }
+  if (installed) {
+    console.log('Installed octomux review workflows for Claude Code');
+  }
+}

package/cli/dist/client.js

@@ -1,154 +1,147 @@
-function qs(params) {
-    const entries = Object.entries(params).filter(([, v]) => v !== undefined);
-    if (entries.length === 0)
-        return '';
-    return '?' + entries.map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join('&');
-}
-async function request(baseUrl, path, options) {
-    let res;
-    try {
-        res = await fetch(`${baseUrl}${path}`, {
-            headers: { 'Content-Type': 'application/json' },
-            ...options,
-        });
-    }
-    catch (err) {
-        if (err.cause &&
-            err.cause.code === 'ECONNREFUSED') {
-            throw new Error(`Cannot connect to octomux server at ${baseUrl.replace('/api', '')}\nStart it with: octomux start`);
-        }
-        throw err;
-    }
-    if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        throw new Error(body.error || res.statusText);
+import { createRequestCore, qs } from '@octomux/api-client';
+function cliFetchError(err, { baseUrl }) {
+    if (err.cause &&
+        err.cause.code === 'ECONNREFUSED') {
+        throw new Error(`Cannot connect to octomux server at ${baseUrl.replace('/api', '')}\nStart it with: octomux start`);
     }
-    if (res.status === 204)
-        return undefined;
-    return res.json();
+    throw err;
 }
 export function createClient(serverUrl) {
     const baseUrl = serverUrl.replace(/\/$/, '') + '/api';
+    const { request } = createRequestCore({
+        baseUrl,
+        alwaysJsonContentType: true,
+        onFetchError: cliFetchError,
+    });
     return {
         listIntegrations() {
-            return request(baseUrl, '/integrations');
+            return request('/integrations');
         },
         createTask(data) {
-            return request(baseUrl, '/tasks', { method: 'POST', body: JSON.stringify(data) });
+            return request('/tasks', { method: 'POST', body: JSON.stringify(data) });
         },
         listTasks(params) {
-            return request(baseUrl, `/tasks${qs({ repo_path: params?.repo_path })}`);
+            return request(`/tasks${qs({ repo_path: params?.repo_path })}`);
         },
         getTask(id) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(id)}`);
+            return request(`/tasks/${encodeURIComponent(id)}`);
         },
         updateTask(id, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(id)}`, {
+            return request(`/tasks/${encodeURIComponent(id)}`, {
                 method: 'PATCH',
                 body: JSON.stringify(data),
             });
         },
         deleteTask(id) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(id)}`, { method: 'DELETE' });
+            return request(`/tasks/${encodeURIComponent(id)}`, { method: 'DELETE' });
         },
         addAgent(taskId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/agents`, {
+            return request(`/tasks/${encodeURIComponent(taskId)}/agents`, {
                 method: 'POST',
                 body: JSON.stringify(data || {}),
             });
         },
         stopAgent(taskId, agentId) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/agents/${encodeURIComponent(agentId)}`, { method: 'DELETE' });
+            return request(`/tasks/${encodeURIComponent(taskId)}/agents/${encodeURIComponent(agentId)}`, { method: 'DELETE' });
         },
         sendMessage(taskId, agentId, message) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/agents/${encodeURIComponent(agentId)}/message`, { method: 'POST', body: JSON.stringify({ message }) });
+            return request(`/tasks/${encodeURIComponent(taskId)}/agents/${encodeURIComponent(agentId)}/message`, { method: 'POST', body: JSON.stringify({ message }) });
         },
         listSkills() {
-            return request(baseUrl, '/skills');
+            return request('/skills');
         },
         getSkill(name) {
-            return request(baseUrl, `/skills/${encodeURIComponent(name)}`);
+            return request(`/skills/${encodeURIComponent(name)}`);
         },
         createSkill(data) {
-            return request(baseUrl, '/skills', {
+            return request('/skills', {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         deleteSkill(name) {
-            return request(baseUrl, `/skills/${encodeURIComponent(name)}`, { method: 'DELETE' });
+            return request(`/skills/${encodeURIComponent(name)}`, { method: 'DELETE' });
         },
         recentRepos() {
-            return request(baseUrl, '/recent-repos');
+            return request('/recent-repos');
         },
         defaultBranch(repoPath) {
-            return request(baseUrl, `/default-branch${qs({ repo_path: repoPath })}`);
+            return request(`/default-branch${qs({ repo_path: repoPath })}`);
         },
         getRepoConfig(repoPath) {
-            return request(baseUrl, `/repo-config${qs({ repo_path: repoPath })}`);
+            return request(`/repo-config${qs({ repo_path: repoPath })}`);
         },
         postComment(taskId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/comments`, {
+            return request(`/tasks/${encodeURIComponent(taskId)}/comments`, {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         listComments(taskId, file) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/comments${qs({ file })}`);
+            return request(`/tasks/${encodeURIComponent(taskId)}/comments${qs({ file })}`);
         },
         updateComment(taskId, commentId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/comments/${encodeURIComponent(commentId)}`, { method: 'PATCH', body: JSON.stringify(data) });
+            return request(`/tasks/${encodeURIComponent(taskId)}/comments/${encodeURIComponent(commentId)}`, { method: 'PATCH', body: JSON.stringify(data) });
         },
         deleteComment(taskId, commentId) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/comments/${encodeURIComponent(commentId)}`, { method: 'DELETE' });
+            return request(`/tasks/${encodeURIComponent(taskId)}/comments/${encodeURIComponent(commentId)}`, { method: 'DELETE' });
         },
         moveTask(taskId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/move`, {
+            return request(`/tasks/${encodeURIComponent(taskId)}/move`, {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         postTaskSummary(taskId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/summary`, {
+            return request(`/tasks/${encodeURIComponent(taskId)}/summary`, {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         postTaskNote(taskId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/note`, {
+            return request(`/tasks/${encodeURIComponent(taskId)}/note`, {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         addTaskRef(taskId, data) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/refs`, {
+            return request(`/tasks/${encodeURIComponent(taskId)}/refs`, {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         deleteTaskRef(taskId, integration) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/refs/${encodeURIComponent(integration)}`, { method: 'DELETE' });
+            return request(`/tasks/${encodeURIComponent(taskId)}/refs/${encodeURIComponent(integration)}`, { method: 'DELETE' });
         },
         getTaskUpdates(taskId) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/updates`);
+            return request(`/tasks/${encodeURIComponent(taskId)}/updates`);
         },
         getTaskRefs(taskId) {
-            return request(baseUrl, `/tasks/${encodeURIComponent(taskId)}/refs`);
+            return request(`/tasks/${encodeURIComponent(taskId)}/refs`);
         },
         teamRun(data) {
-            return request(baseUrl, '/teams/run', {
+            return request('/teams/run', {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         teamSchedule(data) {
-            return request(baseUrl, '/teams/schedule', {
+            return request('/teams/schedule', {
                 method: 'POST',
                 body: JSON.stringify(data),
             });
         },
         listTeams() {
-            return request(baseUrl, '/teams');
+            return request('/teams');
+        },
+        listSavedFiles(repoPath) {
+            return request(`/repos/${encodeURIComponent(repoPath)}/files`);
+        },
+        getSavedFile(repoPath, relPath) {
+            return request(`/repos/${encodeURIComponent(repoPath)}/files/content${qs({ path: relPath })}`);
+        },
+        putSavedFile(repoPath, relPath, content) {
+            return request(`/repos/${encodeURIComponent(repoPath)}/files/content${qs({ path: relPath })}`, { method: 'PUT', body: JSON.stringify({ content }) });
         },
     };
 }

package/cli/dist/commands/close-task.js

@@ -6,7 +6,7 @@ export function registerCloseTask(program) {
         .description('Close a running task')
         .action(async (id, _opts, cmd) => {
         const { client, json } = getContext(cmd);
-        const task = await client.updateTask(id, { status: 'closed' });
+        const task = await client.updateTask(id, { runtime_state: 'idle' });
         if (json) {
             outputJson(task);
             return;

package/cli/dist/commands/create-task.js

@@ -2,9 +2,9 @@ import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import chalk from 'chalk';
 import { getContext } from '../action.js';
-import { outputJson, label, success, colorStatus } from '../format.js';
+import { RUN_MODES } from '@octomux/types';
+import { outputJson, label, success, colorStatus, taskDisplayStatus } from '../format.js';
 const execFileAsync = promisify(execFile);
-const VALID_MODES = ['new', 'existing', 'none', 'scratch'];
 export async function resolveForkFrom(client, forkFromId, explicitRepoPath, git = defaultGit) {
     let source;
     try {
@@ -14,13 +14,12 @@ export async function resolveForkFrom(client, forkFromId, explicitRepoPath, git
         const msg = err instanceof Error ? err.message : String(err);
         throw new Error(`cannot fork from ${forkFromId}: source not found (${msg})`);
     }
-    const status = source.status;
     const runMode = source.run_mode ?? 'new';
     if (runMode === 'scratch' || runMode === 'none' || runMode === 'existing') {
-        throw new Error(`cannot fork from ${forkFromId}: source has no managed branch (status=${status}, run_mode=${runMode})`);
+        throw new Error(`cannot fork from ${forkFromId}: source has no managed branch (runtime_state=${source.runtime_state}, run_mode=${runMode})`);
     }
-    if (status === 'draft') {
-        throw new Error(`cannot fork from ${forkFromId}: source has no branch (status=${status}, run_mode=${runMode})`);
+    if (source.runtime_state === 'idle') {
+        throw new Error(`cannot fork from ${forkFromId}: source has no branch (runtime_state=${source.runtime_state}, run_mode=${runMode})`);
     }
     const baseBranch = `agents/${forkFromId}`;
     const repoPath = explicitRepoPath ?? source.repo_path;
@@ -59,7 +58,7 @@ export function registerCreateTask(program) {
         .option('-p, --initial-prompt <prompt>', 'initial prompt for the agent')
         .option('-b, --branch <name>', 'branch name (new mode only)')
         .option('--base-branch <name>', 'base branch name (new mode only)')
-        .option('--mode <mode>', `run mode: ${VALID_MODES.join(' | ')} (default: new)`, 'new')
+        .option('--mode <mode>', `run mode: ${RUN_MODES.join(' | ')} (default: new)`, 'new')
         .option('--worktree-path <path>', 'existing worktree path (required for existing mode)')
         .option('--fork-from <task-id>', 'fork from an existing new-mode task (sets base_branch to agents/<id>)')
         .option('--draft', 'create as draft without starting')
@@ -69,8 +68,8 @@ export function registerCreateTask(program) {
         .action(async (opts, cmd) => {
         const { client, json } = getContext(cmd);
         const mode = opts.mode;
-        if (!VALID_MODES.includes(mode)) {
-            cmd.error(`--mode must be one of: ${VALID_MODES.join(', ')}`);
+        if (!RUN_MODES.includes(mode)) {
+            cmd.error(`--mode must be one of: ${RUN_MODES.join(', ')}`);
         }
         // --fork-from is only meaningful for new mode — it derives base_branch.
         if (opts.forkFrom) {
@@ -148,7 +147,7 @@ export function registerCreateTask(program) {
         success(`Created task ${task.id}`);
         console.log(label('Title', task.title));
         console.log(label('Mode', mode));
-        console.log(label('Status', colorStatus(task.status)));
+        console.log(label('Status', colorStatus(taskDisplayStatus(task))));
         console.log(label('Branch', task.branch));
         console.log(label('Repo', task.repo_path));
     });

package/cli/dist/commands/files.js

@@ -0,0 +1,67 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import { getContext } from '../action.js';
+import { outputJson, printTable, errorMessage } from '../format.js';
+function repoPath(opts) {
+    return opts.repo ?? process.cwd();
+}
+export function registerFiles(program) {
+    const files = program
+        .command('files')
+        .description('List, read, and write repo-portable saved files under .octomux/files/');
+    files
+        .command('list')
+        .description('List saved files in <repo>/.octomux/files/')
+        .option('-r, --repo <path>', 'repository path (default: cwd)')
+        .action(async (opts, cmd) => {
+        const { client, json } = getContext(cmd);
+        const entries = await client.listSavedFiles(repoPath(opts));
+        if (json) {
+            outputJson(entries);
+            return;
+        }
+        if (entries.length === 0) {
+            console.log('No saved files.');
+            return;
+        }
+        printTable([
+            { header: 'PATH', width: 40, get: (e) => e.path },
+            { header: 'SIZE', width: 10, get: (e) => String(e.size) },
+        ], entries);
+    });
+    files
+        .command('get <path>')
+        .description('Read a saved file')
+        .option('-r, --repo <path>', 'repository path (default: cwd)')
+        .action(async (filePath, opts, cmd) => {
+        const { client, json } = getContext(cmd);
+        const file = await client.getSavedFile(repoPath(opts), filePath);
+        if (json) {
+            outputJson(file);
+            return;
+        }
+        console.log(file.content);
+    });
+    files
+        .command('put <path>')
+        .description('Write a saved file (content from --content or stdin)')
+        .option('-r, --repo <path>', 'repository path (default: cwd)')
+        .option('-c, --content <text>', 'file content (default: read stdin)')
+        .action(async (filePath, opts, cmd) => {
+        const { client, json } = getContext(cmd);
+        let content = opts.content;
+        if (content === undefined) {
+            if (process.stdin.isTTY) {
+                errorMessage('Provide --content or pipe content on stdin');
+                process.exit(1);
+            }
+            content = fs.readFileSync(0, 'utf-8');
+        }
+        const file = await client.putSavedFile(repoPath(opts), filePath, content);
+        if (json) {
+            outputJson(file);
+            return;
+        }
+        console.log(chalk.green(`Wrote ${file.path}`));
+    });
+}

package/cli/dist/commands/get-task.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { getContext } from '../action.js';
-import { outputJson, label, heading, colorStatus, colorAgentStatus } from '../format.js';
+import { outputJson, label, heading, colorStatus, colorAgentStatus, taskDisplayStatus, } from '../format.js';
 export function registerGetTask(program) {
     program
         .command('get-task <id>')
@@ -15,7 +15,7 @@ export function registerGetTask(program) {
         }
         heading(`Task ${task.id}`);
         console.log(label('Title', task.title));
-        console.log(label('Status', colorStatus(task.status)));
+        console.log(label('Status', colorStatus(taskDisplayStatus(task))));
         console.log(label('Repo', task.repo_path));
         console.log(label('Branch', task.branch));
         if (task.base_branch)

package/cli/dist/commands/list-tasks.js

@@ -1,5 +1,5 @@
 import { getContext } from '../action.js';
-import { outputJson, colorStatus, printTable } from '../format.js';
+import { outputJson, colorStatus, printTable, taskDisplayStatus, taskMatchesStatusFilter, } from '../format.js';
 export function registerListTasks(program) {
     program
         .command('list-tasks')
@@ -11,7 +11,7 @@ export function registerListTasks(program) {
         const { client, json } = getContext(cmd);
         let tasks = await client.listTasks(opts.repoPath ? { repo_path: opts.repoPath } : undefined);
         if (opts.status) {
-            tasks = tasks.filter((t) => t.status === opts.status);
+            tasks = tasks.filter((t) => taskMatchesStatusFilter(t, opts.status));
         }
         if (json) {
             outputJson(tasks);
@@ -23,7 +23,7 @@ export function registerListTasks(program) {
         }
         printTable([
             { header: 'ID', width: 14, get: (t) => t.id },
-            { header: 'STATUS', width: 14, get: (t) => colorStatus(t.status) },
+            { header: 'STATUS', width: 14, get: (t) => colorStatus(taskDisplayStatus(t)) },
             { header: 'TITLE', get: (t) => t.title },
         ], tasks);
     });

package/cli/dist/commands/resume-task.js

@@ -1,18 +1,18 @@
 import { getContext } from '../action.js';
-import { outputJson, success, colorStatus, label } from '../format.js';
+import { outputJson, success, colorStatus, label, taskDisplayStatus } from '../format.js';
 export function registerResumeTask(program) {
     program
         .command('resume-task <id>')
         .description('Resume a closed or errored task')
         .action(async (id, _opts, cmd) => {
         const { client, json } = getContext(cmd);
-        const task = await client.updateTask(id, { status: 'running' });
+        const task = await client.updateTask(id, { runtime_state: 'running' });
         if (json) {
             outputJson(task);
             return;
         }
         success(`Resumed task ${task.id}`);
         console.log(label('Title', task.title));
-        console.log(label('Status', colorStatus(task.status)));
+        console.log(label('Status', colorStatus(taskDisplayStatus(task))));
     });
 }

package/cli/dist/commands/task-move.js

@@ -1,23 +1,16 @@
 import { getContext } from '../action.js';
+import { WORKFLOW_STATUSES } from '@octomux/types';
 import { outputJson, success, label } from '../format.js';
-const VALID_STATUSES = [
-    'backlog',
-    'planned',
-    'in_progress',
-    'human_review',
-    'pr',
-    'done',
-];
 export function registerTaskMove(program) {
     program
         .command('task-move <id> <workflow_status>')
-        .description(`Move a task to a workflow column (${VALID_STATUSES.join(' | ')})`)
+        .description(`Move a task to a workflow column (${WORKFLOW_STATUSES.join(' | ')})`)
         .option('-n, --note <note>', 'optional note to attach to the move')
         .action(async (id, workflowStatus, opts, cmd) => {
         const { client, json } = getContext(cmd);
-        if (!VALID_STATUSES.includes(workflowStatus)) {
+        if (!WORKFLOW_STATUSES.includes(workflowStatus)) {
             console.error(`Invalid workflow_status: ${workflowStatus}`);
-            console.error(`Valid values: ${VALID_STATUSES.join(', ')}`);
+            console.error(`Valid values: ${WORKFLOW_STATUSES.join(', ')}`);
             process.exit(1);
         }
         const task = await client.moveTask(id, {

package/cli/dist/commands/task-ref-add.js

@@ -25,12 +25,12 @@ export function registerTaskRefAdd(program) {
         .action(async (id, integration, externalId, opts, cmd) => {
         const { client, json } = getContext(cmd);
         const metadata = parseMetadata(opts.metadata);
+        const mergedMetadata = opts.title !== undefined ? { ...metadata, title: opts.title } : metadata;
         const ref = await client.addTaskRef(id, {
             integration,
-            external_id: externalId,
+            ref: externalId,
             url: opts.url,
-            title: opts.title,
-            ...(metadata !== undefined ? { metadata } : {}),
+            ...(mergedMetadata !== undefined ? { metadata: mergedMetadata } : {}),
         });
         if (json) {
             outputJson(ref);
@@ -39,7 +39,6 @@ export function registerTaskRefAdd(program) {
         success(`Linked ${integration}:${externalId} to task ${id}`);
         if (ref.url)
             console.log(label('URL', ref.url));
-        if (ref.title)
-            console.log(label('Title', ref.title));
+        console.log(label('Ref', ref.ref));
     });
 }

package/cli/dist/commands/task-updates.js

@@ -17,22 +17,11 @@ export function registerTaskUpdates(program) {
         }
         heading(`Updates for task ${id}`);
         for (const u of updates) {
-            const who = u.author ? ` [${u.author}]` : '';
             const ts = new Date(u.created_at).toLocaleString();
-            console.log(`  ${ts}${who}  ${u.kind}`);
-            if (u.payload) {
-                try {
-                    const parsed = JSON.parse(u.payload);
-                    if (parsed.note)
-                        console.log(`    ${parsed.note}`);
-                    if (parsed.summary)
-                        console.log(`    ${parsed.summary}`);
-                    if (parsed.to)
-                        console.log(`    → ${parsed.to}`);
-                }
-                catch {
-                    console.log(`    ${u.payload}`);
-                }
+            const transition = u.from_status && u.to_status ? `${u.from_status} → ${u.to_status}` : null;
+            console.log(`  ${ts}  ${u.kind}${transition ? `  ${transition}` : ''}`);
+            if (u.body) {
+                console.log(`    ${u.body}`);
             }
         }
     });

package/cli/dist/format.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 const STATUS_COLORS = {
     draft: chalk.cyan,
+    idle: chalk.cyan,
     setting_up: chalk.yellow,
     running: chalk.green,
     closed: chalk.dim,
@@ -16,6 +17,16 @@ export function colorStatus(status) {
     const colorFn = STATUS_COLORS[status] || chalk.white;
     return colorFn(status);
 }
+/** Legacy CLI status label derived from runtime_state + workflow_status. */
+export function taskDisplayStatus(task) {
+    if (task.runtime_state === 'idle') {
+        return task.workflow_status === 'backlog' ? 'draft' : 'closed';
+    }
+    return task.runtime_state;
+}
+export function taskMatchesStatusFilter(task, status) {
+    return taskDisplayStatus(task) === status;
+}
 export function colorAgentStatus(status) {
     const colorFn = AGENT_STATUS_COLORS[status] || chalk.white;
     return colorFn(status);