sisyphi 1.0.1 → 1.0.4

package/dist/chunk-DBR33QHM.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+import {
+  goalPath,
+  roadmapPath,
+  sessionsDir,
+  statePath
+} from "./chunk-YGBGKMTF.js";
+
+// src/shared/utils.ts
+function computeActiveTimeMs(session) {
+  const now = Date.now();
+  const intervals = [];
+  for (const cycle of session.orchestratorCycles) {
+    const start = new Date(cycle.timestamp).getTime();
+    const end = cycle.completedAt ? new Date(cycle.completedAt).getTime() : now;
+    if (end > start) intervals.push([start, end]);
+  }
+  for (const agent of session.agents) {
+    const start = new Date(agent.spawnedAt).getTime();
+    const end = agent.completedAt ? new Date(agent.completedAt).getTime() : now;
+    if (end > start) intervals.push([start, end]);
+  }
+  if (intervals.length === 0) return 0;
+  intervals.sort((a, b) => a[0] - b[0]);
+  const merged = [intervals[0]];
+  for (let i = 1; i < intervals.length; i++) {
+    const last = merged[merged.length - 1];
+    const cur = intervals[i];
+    if (cur[0] <= last[1]) {
+      last[1] = Math.max(last[1], cur[1]);
+    } else {
+      merged.push(cur);
+    }
+  }
+  return merged.reduce((sum, [start, end]) => sum + (end - start), 0);
+}
+
+// src/tui/lib/reports.ts
+import { readFileSync } from "fs";
+function loadReportContent(report) {
+  try {
+    return readFileSync(report.filePath, "utf-8");
+  } catch {
+    return report.summary;
+  }
+}
+function resolveReports(reports) {
+  return [...reports].reverse().map((r) => ({
+    type: r.type,
+    timestamp: r.timestamp,
+    content: loadReportContent(r),
+    summary: r.summary
+  }));
+}
+
+// src/tui/lib/context.ts
+import { readFileSync as readFileSync2, readdirSync } from "fs";
+function readFileSafe(filePath) {
+  try {
+    return readFileSync2(filePath, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function escapeXml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function buildCompanionContext(cwd) {
+  let sessionDirs;
+  try {
+    sessionDirs = readdirSync(sessionsDir(cwd));
+  } catch {
+    return "<sessions>No sessions found.</sessions>";
+  }
+  const now = Date.now();
+  const sevenDaysMs = 7 * 24 * 60 * 60 * 1e3;
+  const sessionBlocks = [];
+  for (const sessionId of sessionDirs) {
+    const stateRaw = readFileSafe(statePath(cwd, sessionId));
+    if (!stateRaw) continue;
+    let session;
+    try {
+      session = JSON.parse(stateRaw);
+    } catch {
+      continue;
+    }
+    if (session.status === "completed" && session.completedAt) {
+      if (now - new Date(session.completedAt).getTime() > sevenDaysMs) continue;
+    }
+    const lines = [];
+    const nameAttr = session.name ? ` name="${escapeXml(session.name)}"` : "";
+    lines.push(`  <session id="${escapeXml(session.id)}"${nameAttr} status="${escapeXml(session.status)}">`);
+    lines.push(`    <task>${escapeXml(session.task)}</task>`);
+    lines.push(`    <created>${escapeXml(session.createdAt)}</created>`);
+    lines.push(`    <cycles>${session.orchestratorCycles.length}</cycles>`);
+    if (session.status === "completed") {
+      if (session.completionReport) {
+        const snippet = session.completionReport.slice(0, 300).replace(/\n+/g, " ").trim();
+        lines.push(`    <completion-report>${escapeXml(snippet)}${session.completionReport.length > 300 ? "\u2026" : ""}</completion-report>`);
+      }
+    } else {
+      if (session.agents.length > 0) {
+        const counts = /* @__PURE__ */ new Map();
+        for (const agent of session.agents) {
+          counts.set(agent.status, (counts.get(agent.status) ?? 0) + 1);
+        }
+        const summary = [...counts.entries()].map(([status, n]) => `${n} ${status}`).join(", ");
+        lines.push(`    <agents>${escapeXml(summary)}</agents>`);
+      }
+      const goalContent = readFileSafe(goalPath(cwd, session.id));
+      if (goalContent) {
+        const firstLine = goalContent.split("\n").map((l) => l.trim()).find((l) => l.length > 0 && !l.startsWith("#"));
+        if (firstLine) lines.push(`    <goal>${escapeXml(firstLine)}</goal>`);
+      }
+      const roadmapContent = readFileSafe(roadmapPath(cwd, session.id));
+      if (roadmapContent) {
+        const todos = roadmapContent.split("\n").filter((l) => l.includes("- [ ]")).slice(0, 5).map((l) => l.trim());
+        if (todos.length > 0) {
+          lines.push("    <todos>");
+          for (const todo of todos) lines.push(`      ${escapeXml(todo)}`);
+          lines.push("    </todos>");
+        }
+      }
+    }
+    lines.push("  </session>");
+    sessionBlocks.push(lines.join("\n"));
+  }
+  if (sessionBlocks.length === 0) {
+    return "<sessions>No sessions found.</sessions>";
+  }
+  return ["<sessions>", ...sessionBlocks, "</sessions>"].join("\n");
+}
+function buildSessionContext(session, cwd) {
+  const goal = readFileSafe(goalPath(cwd, session.id));
+  const roadmap = readFileSafe(roadmapPath(cwd, session.id));
+  const agentsXml = session.agents.map((agent) => {
+    const reportBlocks = resolveReports(agent.reports);
+    const reportsXml = [...reportBlocks].reverse().map((block) => {
+      return `      <report type="${block.type}" time="${escapeXml(block.timestamp)}">${escapeXml(block.content)}</report>`;
+    }).join("\n");
+    return [
+      `    <agent id="${escapeXml(agent.id)}" name="${escapeXml(agent.name)}" type="${escapeXml(agent.agentType)}" status="${escapeXml(agent.status)}">`,
+      `      <instruction>${escapeXml(agent.instruction)}</instruction>`,
+      ...reportsXml ? [reportsXml] : [],
+      `    </agent>`
+    ].join("\n");
+  }).join("\n");
+  const cyclesXml = session.orchestratorCycles.map((cycle) => {
+    const agents = cycle.agentsSpawned.join(", ");
+    const mode = cycle.mode ? ` mode="${escapeXml(cycle.mode)}"` : "";
+    return `    <cycle number="${cycle.cycle}"${mode} agents="${escapeXml(agents)}" />`;
+  }).join("\n");
+  const lines = [
+    "<context>",
+    `<session id="${escapeXml(session.id)}" status="${escapeXml(session.status)}">`,
+    `  <task>${escapeXml(session.task)}</task>`,
+    `  <cwd>${escapeXml(session.cwd)}</cwd>`
+  ];
+  if (goal) lines.push(`  <goal>${escapeXml(goal)}</goal>`);
+  if (roadmap) lines.push(`  <roadmap>${escapeXml(roadmap)}</roadmap>`);
+  if (session.agents.length > 0) {
+    lines.push("  <agents>");
+    lines.push(agentsXml);
+    lines.push("  </agents>");
+  }
+  if (session.orchestratorCycles.length > 0) {
+    lines.push("  <cycles>");
+    lines.push(cyclesXml);
+    lines.push("  </cycles>");
+  }
+  if (session.completionReport) {
+    lines.push(`  <completion-report>${escapeXml(session.completionReport)}</completion-report>`);
+  }
+  lines.push("</session>");
+  lines.push("</context>");
+  return lines.join("\n");
+}
+
+export {
+  computeActiveTimeMs,
+  resolveReports,
+  buildCompanionContext,
+  buildSessionContext
+};
+//# sourceMappingURL=chunk-DBR33QHM.js.map

package/dist/chunk-DBR33QHM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/utils.ts","../src/tui/lib/reports.ts","../src/tui/lib/context.ts"],"sourcesContent":["import type { Session } from './types.js';\n\n/**\n * Compute the total wall-clock milliseconds during which at least one\n * orchestrator cycle or agent was running. Merges overlapping intervals\n * so parallel agents aren't double-counted.\n */\nexport function computeActiveTimeMs(session: Session): number {\n  const now = Date.now();\n  const intervals: Array<[number, number]> = [];\n\n  for (const cycle of session.orchestratorCycles) {\n    const start = new Date(cycle.timestamp).getTime();\n    const end = cycle.completedAt ? new Date(cycle.completedAt).getTime() : now;\n    if (end > start) intervals.push([start, end]);\n  }\n\n  for (const agent of session.agents) {\n    const start = new Date(agent.spawnedAt).getTime();\n    const end = agent.completedAt ? new Date(agent.completedAt).getTime() : now;\n    if (end > start) intervals.push([start, end]);\n  }\n\n  if (intervals.length === 0) return 0;\n\n  intervals.sort((a, b) => a[0] - b[0]);\n\n  const merged: Array<[number, number]> = [intervals[0]!];\n  for (let i = 1; i < intervals.length; i++) {\n    const last = merged[merged.length - 1]!;\n    const cur = intervals[i]!;\n    if (cur[0] <= last[1]) {\n      last[1] = Math.max(last[1], cur[1]);\n    } else {\n      merged.push(cur);\n    }\n  }\n\n  return merged.reduce((sum, [start, end]) => sum + (end - start), 0);\n}\n","import { readFileSync } from 'node:fs';\nimport type { AgentReport } from '../../shared/types.js';\n\nexport interface ReportBlock {\n  type: 'update' | 'final';\n  timestamp: string;\n  content: string;\n  summary: string;\n}\n\nfunction loadReportContent(report: AgentReport): string {\n  try {\n    return readFileSync(report.filePath, 'utf-8');\n  } catch {\n    return report.summary;\n  }\n}\n\nexport function resolveReports(reports: AgentReport[]): ReportBlock[] {\n  return [...reports].reverse().map((r) => ({\n    type: r.type as 'update' | 'final',\n    timestamp: r.timestamp,\n    content: loadReportContent(r),\n    summary: r.summary,\n  }));\n}\n","import { readFileSync, readdirSync } from 'node:fs';\nimport { goalPath, roadmapPath, sessionsDir, statePath } from '../../shared/paths.js';\nimport { resolveReports } from './reports.js';\nimport type { Session, AgentStatus } from '../../shared/types.js';\n\nfunction readFileSafe(filePath: string): string | null {\n  try {\n    return readFileSync(filePath, 'utf-8');\n  } catch {\n    return null;\n  }\n}\n\nfunction escapeXml(s: string): string {\n  return s\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\nexport function buildCompanionContext(cwd: string): string {\n  let sessionDirs: string[];\n  try {\n    sessionDirs = readdirSync(sessionsDir(cwd));\n  } catch {\n    return '<sessions>No sessions found.</sessions>';\n  }\n\n  const now = Date.now();\n  const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;\n  const sessionBlocks: string[] = [];\n\n  for (const sessionId of sessionDirs) {\n    const stateRaw = readFileSafe(statePath(cwd, sessionId));\n    if (!stateRaw) continue;\n\n    let session: Session;\n    try {\n      session = JSON.parse(stateRaw) as Session;\n    } catch {\n      continue;\n    }\n\n    // Skip completed sessions older than 7 days\n    if (session.status === 'completed' && session.completedAt) {\n      if (now - new Date(session.completedAt).getTime() > sevenDaysMs) continue;\n    }\n\n    const lines: string[] = [];\n    const nameAttr = session.name ? ` name=\"${escapeXml(session.name)}\"` : '';\n    lines.push(`  <session id=\"${escapeXml(session.id)}\"${nameAttr} status=\"${escapeXml(session.status)}\">`);\n    lines.push(`    <task>${escapeXml(session.task)}</task>`);\n    lines.push(`    <created>${escapeXml(session.createdAt)}</created>`);\n    lines.push(`    <cycles>${session.orchestratorCycles.length}</cycles>`);\n\n    if (session.status === 'completed') {\n      if (session.completionReport) {\n        const snippet = session.completionReport.slice(0, 300).replace(/\\n+/g, ' ').trim();\n        lines.push(`    <completion-report>${escapeXml(snippet)}${session.completionReport.length > 300 ? '…' : ''}</completion-report>`);\n      }\n    } else {\n      // Agent summary by status\n      if (session.agents.length > 0) {\n        const counts = new Map<AgentStatus, number>();\n        for (const agent of session.agents) {\n          counts.set(agent.status, (counts.get(agent.status) ?? 0) + 1);\n        }\n        const summary = [...counts.entries()].map(([status, n]) => `${n} ${status}`).join(', ');\n        lines.push(`    <agents>${escapeXml(summary)}</agents>`);\n      }\n\n      // Goal: first meaningful line\n      const goalContent = readFileSafe(goalPath(cwd, session.id));\n      if (goalContent) {\n        const firstLine = goalContent.split('\\n').map(l => l.trim()).find(l => l.length > 0 && !l.startsWith('#'));\n        if (firstLine) lines.push(`    <goal>${escapeXml(firstLine)}</goal>`);\n      }\n\n      // Roadmap unchecked todos (up to 5)\n      const roadmapContent = readFileSafe(roadmapPath(cwd, session.id));\n      if (roadmapContent) {\n        const todos = roadmapContent\n          .split('\\n')\n          .filter(l => l.includes('- [ ]'))\n          .slice(0, 5)\n          .map(l => l.trim());\n        if (todos.length > 0) {\n          lines.push('    <todos>');\n          for (const todo of todos) lines.push(`      ${escapeXml(todo)}`);\n          lines.push('    </todos>');\n        }\n      }\n    }\n\n    lines.push('  </session>');\n    sessionBlocks.push(lines.join('\\n'));\n  }\n\n  if (sessionBlocks.length === 0) {\n    return '<sessions>No sessions found.</sessions>';\n  }\n\n  return ['<sessions>', ...sessionBlocks, '</sessions>'].join('\\n');\n}\n\nexport function buildSessionContext(session: Session, cwd: string): string {\n  const goal = readFileSafe(goalPath(cwd, session.id));\n  const roadmap = readFileSafe(roadmapPath(cwd, session.id));\n\n  const agentsXml = session.agents.map((agent) => {\n    const reportBlocks = resolveReports(agent.reports);\n    // resolveReports returns newest-first; reverse to chronological for context\n    const reportsXml = [...reportBlocks].reverse().map((block) => {\n      return `      <report type=\"${block.type}\" time=\"${escapeXml(block.timestamp)}\">${escapeXml(block.content)}</report>`;\n    }).join('\\n');\n\n    return [\n      `    <agent id=\"${escapeXml(agent.id)}\" name=\"${escapeXml(agent.name)}\" type=\"${escapeXml(agent.agentType)}\" status=\"${escapeXml(agent.status)}\">`,\n      `      <instruction>${escapeXml(agent.instruction)}</instruction>`,\n      ...(reportsXml ? [reportsXml] : []),\n      `    </agent>`,\n    ].join('\\n');\n  }).join('\\n');\n\n  const cyclesXml = session.orchestratorCycles.map((cycle) => {\n    const agents = cycle.agentsSpawned.join(', ');\n    const mode = cycle.mode ? ` mode=\"${escapeXml(cycle.mode)}\"` : '';\n    return `    <cycle number=\"${cycle.cycle}\"${mode} agents=\"${escapeXml(agents)}\" />`;\n  }).join('\\n');\n\n  const lines: string[] = [\n    '<context>',\n    `<session id=\"${escapeXml(session.id)}\" status=\"${escapeXml(session.status)}\">`,\n    `  <task>${escapeXml(session.task)}</task>`,\n    `  <cwd>${escapeXml(session.cwd)}</cwd>`,\n  ];\n\n  if (goal) lines.push(`  <goal>${escapeXml(goal)}</goal>`);\n  if (roadmap) lines.push(`  <roadmap>${escapeXml(roadmap)}</roadmap>`);\n\n  if (session.agents.length > 0) {\n    lines.push('  <agents>');\n    lines.push(agentsXml);\n    lines.push('  </agents>');\n  }\n\n  if (session.orchestratorCycles.length > 0) {\n    lines.push('  <cycles>');\n    lines.push(cyclesXml);\n    lines.push('  </cycles>');\n  }\n\n  if (session.completionReport) {\n    lines.push(`  <completion-report>${escapeXml(session.completionReport)}</completion-report>`);\n  }\n\n  lines.push('</session>');\n  lines.push('</context>');\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["readFileSync","readFileSync"]}

package/dist/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import {
+  buildCompanionContext,
   computeActiveTimeMs
-} from "./chunk-ZE2SKB4B.js";
+} from "./chunk-DBR33QHM.js";
 import {
   daemonLogPath,
   daemonPidPath,
@@ -244,33 +245,15 @@ function printGettingStarted(keybindResult) {
   const lines = [
     "",
     "Sisyphus installed \u2014 daemon running via launchd.",
-    "",
-    "Sisyphus is a tmux-integrated orchestration daemon for Claude Code multi-agent workflows.",
-    "A background daemon manages sessions where an orchestrator Claude breaks tasks into",
-    "subtasks, spawns agent Claude instances in tmux panes, and coordinates their lifecycle.",
-    "",
-    "Quick start:",
-    '  sisyphus start "task description"   Start a session (must be inside tmux)',
-    "  sisyphus list                        List sessions",
-    "  sisyphus status                      Show current session status",
-    "  sisyphus kill <id>                   Kill a session",
-    "",
-    "Monitoring:",
-    "  sisyphus dashboard                   Open TUI dashboard",
-    "  tail -f ~/.sisyphus/daemon.log       Watch daemon logs",
     ""
   ];
   if (keybindResult.status === "installed") {
-    lines.push(`Tmux keybind: ${keybindResult.message}`);
+    lines.push(`Tmux keybind: ${keybindResult.message}`, "");
   } else if (keybindResult.status === "conflict") {
-    lines.push(`Keybind: ${keybindResult.message}`);
+    lines.push(`Keybind: ${keybindResult.message}`, "");
   }
   lines.push(
-    "",
-    "Troubleshooting:",
-    "  sisyphus doctor                      Check installation health",
-    "  sisyphus setup-keybind [key]         Configure tmux session-cycling keybind",
-    "  sisyphus uninstall [--purge]         Remove daemon and optionally all data",
+    "Run `sisyphus getting-started` for a complete usage guide.",
     ""
   );
   console.log(lines.join("\n"));
@@ -443,9 +426,23 @@ function registerDashboard(program2) {
 function shellQuote2(s) {
   return `'${s.replace(/'/g, "'\\''")}'`;
 }
+function isTmuxInstalled() {
+  try {
+    execSync5("which tmux", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function registerStart(program2) {
   program2.command("start").description("Start a new sisyphus session").argument("<task>", "Task description for the orchestrator").option("-c, --context <context>", "Background context for the orchestrator").option("-n, --name <name>", "Human-readable name for the session").action(async (task, opts) => {
     const cwd = process.env["SISYPHUS_CWD"] ?? process.cwd();
+    if (!process.env["TMUX"] && isTmuxInstalled()) {
+      console.log("Note: Sisyphus uses tmux to manage agent panes.");
+      console.log("It is highly recommended to run sisyphus from inside a tmux session.");
+      console.log("  tmux new-session");
+      console.log("");
+    }
     const request = { type: "start", task, context: opts.context, cwd, name: opts.name };
     const response = await sendRequest(request);
     if (response.ok) {
@@ -1245,6 +1242,144 @@ function registerDoctor(program2) {
   });
 }
 
+// src/cli/commands/companion-context.ts
+function registerCompanionContext(program2) {
+  program2.command("companion-context").description("Output session context JSON for companion hook").option("--cwd <path>", "Project directory", process.cwd()).action((opts) => {
+    const context = buildCompanionContext(opts.cwd);
+    process.stdout.write(JSON.stringify({ additionalContext: context }));
+  });
+}
+
+// src/cli/commands/getting-started.ts
+import { execSync as execSync8 } from "child_process";
+function isTmuxInstalled2() {
+  try {
+    execSync8("which tmux", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function registerGettingStarted(program2) {
+  program2.command("getting-started").description("Show a complete guide to using sisyphus effectively").action(() => {
+    const hasTmux = isTmuxInstalled2();
+    const inTmux = !!process.env["TMUX"];
+    const lines = [
+      "",
+      "  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557",
+      "  \u2551        Getting Started with Sisyphus     \u2551",
+      "  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D",
+      "",
+      "  Sisyphus is a multi-agent orchestration daemon for Claude Code.",
+      "  It breaks large tasks into subtasks, spawns parallel Claude agents,",
+      "  and coordinates their work across multiple cycles \u2014 autonomously.",
+      "",
+      "  \u2500\u2500\u2500 Tmux \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+      ""
+    ];
+    if (!hasTmux) {
+      lines.push(
+        "  \u26A0  tmux is not installed. Sisyphus requires tmux.",
+        "     Install it:  brew install tmux  (macOS)",
+        "                  apt install tmux   (Linux)",
+        ""
+      );
+    } else if (!inTmux) {
+      lines.push(
+        "  \u26A0  You are not inside a tmux session.",
+        "     Sisyphus spawns agent panes inside tmux, so you should",
+        "     start a tmux session before running sisyphus:",
+        "",
+        "       tmux new-session",
+        ""
+      );
+    } else {
+      lines.push(
+        "  \u2713  You are inside tmux. Good to go.",
+        ""
+      );
+    }
+    lines.push(
+      "  \u2500\u2500\u2500 What Makes a Good Sisyphus Task \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+      "",
+      "  Sisyphus is built for BIG tasks \u2014 the kind that would take",
+      "  multiple cycles of orchestration and parallel agent work.",
+      "  If you could do it with a single Claude Code session in plan",
+      "  mode, it's too small for sisyphus.",
+      "",
+      "  Good tasks:",
+      '    \u2022 "Implement this feature" @path/to/spec.md',
+      '    \u2022 "Do a deep dive on all SEO/AEO optimizations and',
+      '       systematically apply them across the site"',
+      "    \u2022 Large-scale refactors spanning dozens of files",
+      "    \u2022 Full feature builds from a written spec",
+      "",
+      "  Too small for sisyphus:",
+      '    \u2022 "Add these 3 UI components to the page"',
+      '    \u2022 "Fix this bug in auth.ts"',
+      "    \u2022 Anything a single Claude session handles comfortably",
+      "",
+      "  Tasks don't need to be hyper-specific \u2014 broad but meaningful",
+      "  tasks work great because the orchestrator will plan the approach.",
+      "  What matters is SCALE, not specificity.",
+      "",
+      "  For best results, write a spec and reference it directly:",
+      "",
+      '    sisyphus start "Implement this @path/to/spec.md"',
+      "",
+      "  \u2500\u2500\u2500 How It Works \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+      "",
+      '  1. You run:  sisyphus start "task description"',
+      "  2. An orchestrator Claude reviews the task and creates a roadmap",
+      "  3. It spawns agent Claude instances in parallel tmux panes",
+      "  4. Agents work independently, then submit reports when done",
+      "  5. The orchestrator respawns with fresh context, reviews progress,",
+      "     and kicks off the next cycle of work",
+      "  6. This repeats until the orchestrator marks the task complete",
+      "",
+      "  The orchestrator is stateless \u2014 it gets killed after each cycle",
+      "  and respawned fresh with the full session state. This means it",
+      "  never runs out of context, no matter how many cycles a task takes.",
+      "",
+      "  \u2500\u2500\u2500 Monitoring (Important!) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+      "",
+      "  Sisyphus sessions should be actively monitored. Agents can get",
+      "  stuck waiting for input, fail to submit reports, or take the",
+      "  roadmap in a direction you don't want. The dashboard is your",
+      "  primary tool for staying on top of things:",
+      "",
+      "    sisyphus dashboard",
+      "",
+      "  Key dashboard actions:",
+      "    m  \u2014 Message the orchestrator to steer direction",
+      "    w  \u2014 Jump directly into the sisyphus tmux session",
+      "         to see exactly what agents are doing",
+      "",
+      "  Use `m` to course-correct from the dashboard, and `w` when you",
+      "  need the most granular view of agent activity.",
+      "",
+      "  \u2500\u2500\u2500 Commands \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+      "",
+      "  Start & monitor:",
+      '    sisyphus start "task"               Start a session',
+      '    sisyphus start "task @spec.md"      Start referencing a spec',
+      "    sisyphus status [id]                Show session status",
+      "    sisyphus list                       List all sessions",
+      "    sisyphus dashboard                  Open TUI dashboard",
+      "",
+      "  Control:",
+      '    sisyphus resume <id> "instructions" Resume with new direction',
+      "    sisyphus kill <id>                  Stop a session",
+      "",
+      "  Health:",
+      "    sisyphus doctor                     Check installation health",
+      "    tail -f ~/.sisyphus/daemon.log      Watch daemon logs",
+      ""
+    );
+    console.log(lines.join("\n"));
+  });
+}
+
 // src/cli/index.ts
 var program = new Command();
 program.name("sisyphus").description("tmux-integrated orchestration daemon for Claude Code").version("0.1.0");
@@ -1268,6 +1403,8 @@ registerRollback(program);
 registerRestartAgent(program);
 registerSetupKeybind(program);
 registerDoctor(program);
+registerCompanionContext(program);
+registerGettingStarted(program);
 program.parseAsync(process.argv).catch((err) => {
   console.error(err.message);
   process.exit(1);