create-claude-workspace 2.3.31 → 2.3.33

package/README.md

@@ -28,9 +28,11 @@ Answer the discovery questions (non-technical). Claude generates the full pipeli
 ### Start Autonomous Development
 
 ```bash
-npx create-claude-workspace scheduler                    # start (1 agent)
-npx create-claude-workspace scheduler --concurrency 3    # 3 parallel agents
-npx create-claude-workspace scheduler --resume           # resume from saved state
+npx create-claude-workspace run                          # start (1 agent)
+npx create-claude-workspace run --concurrency 3          # 3 parallel agents
+npx create-claude-workspace run -i                       # interactive mode (user input only)
+npx create-claude-workspace run --task-mode local        # force local task mode
+npx create-claude-workspace run --resume                 # resume from saved state
 ```
 
 Or interactively: `claude --agent orchestrator`, then `/ralph-loop:ralph-loop Continue autonomous development according to CLAUDE.md`
@@ -45,12 +47,27 @@ The scheduler replaces the single-orchestrator model with parallel agent executi
 - **N agents in parallel** — independent tasks run concurrently in separate git worktrees
 
 ```bash
-npx create-claude-workspace scheduler                    # start (1 agent)
-npx create-claude-workspace scheduler --concurrency 3    # 3 parallel agents
-npx create-claude-workspace scheduler --resume           # resume from saved state
-npx create-claude-workspace scheduler --help             # all options
+npx create-claude-workspace run                          # start (1 agent)
+npx create-claude-workspace run --concurrency 3          # 3 parallel agents
+npx create-claude-workspace run -i                       # interactive mode
+npx create-claude-workspace run --task-mode local        # force local mode
+npx create-claude-workspace run --help                   # all options
 ```
 
+#### Task modes
+
+The scheduler supports three task modes (`--task-mode`):
+
+| Mode | Source | Use case |
+|------|--------|----------|
+| **local** | `TODO.md` / `tasks.json` | Solo development, no issue tracker |
+| **platform** | GitHub/GitLab issues | Team workflows with issue tracking |
+| **interactive** | User TUI input only | Ad-hoc tasks, exploration, prototyping |
+
+Auto-detected at startup: if the repo has a remote with `status::` labeled issues → `platform`, otherwise → `local`. Override with `--task-mode` flag or set `Task Platform` in CLAUDE.md via `project-initializer`.
+
+The `--interactive` (`-i`) flag implies `--task-mode interactive`. Type task descriptions directly in the TUI — each becomes a task that goes through the full pipeline (plan → implement → test → review → commit). Pending tasks are shown in the status bar queue.
+
 #### Communicate at runtime
 
 Write to `.claude/scheduler/inbox.json` while the scheduler is running:

package/dist/index.js

@@ -70,6 +70,8 @@ ${C.b}Scheduler options:${C.n}
   --concurrency <n>            Parallel agents (default: 1)
   --max-iterations <n>         Max iterations (default: 50)
   --max-turns <n>              Max turns per agent invocation (default: 50)
+  --task-mode <mode>           Task source: local, platform, or interactive
+  --interactive, -i            Interactive mode — tasks from user input only
   --resume                     Resume from saved state
   --dry-run                    Validate prerequisites only
   See 'npx create-claude-workspace run --help' for all options.
@@ -78,6 +80,8 @@ ${C.b}Examples:${C.n}
   npx create-claude-workspace                          # scaffold in current directory
   npx create-claude-workspace run                      # start scheduler
   npx create-claude-workspace run --concurrency 3      # 3 parallel agents
+  npx create-claude-workspace run -i                   # interactive mode (user input only)
+  npx create-claude-workspace run --task-mode local    # force local task mode
   npx create-claude-workspace run --resume             # resume from state
   npx create-claude-workspace validate                 # check prerequisites
 
@@ -244,6 +248,9 @@ async function main() {
         console.log(`  ${C.d}# Multi-agent scheduler${C.n}`);
         console.log(`  npx create-claude-workspace run`);
         console.log('');
+        console.log(`  ${C.d}# Interactive mode (tasks from user input)${C.n}`);
+        console.log(`  npx create-claude-workspace run -i`);
+        console.log('');
         console.log(`  ${C.d}# With parallel agents${C.n}`);
         console.log(`  npx create-claude-workspace run --concurrency 3`);
         console.log('');

package/dist/scheduler/index.mjs

@@ -2,7 +2,7 @@
 // ─── Multi-agent scheduler entry point ───
 // Replaces the single-orchestrator autonomous loop with parallel agent execution.
 import { resolve } from 'node:path';
-import { existsSync, mkdirSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import { config as dotenvConfig } from '@dotenvx/dotenvx';
 import { SCHEDULER_DEFAULTS } from './types.mjs';
 import { detectCIPlatform, checkPlatformCLI, installPlatformCLI } from './git/ci-watcher.mjs';
@@ -15,6 +15,7 @@ import { checkAuth } from './agents/health-checker.mjs';
 import { pollForNewWork } from './util/idle-poll.mjs';
 import { TUI } from './ui/tui.mjs';
 import { DiscoveredIssueStore } from './tools/report-issue.mjs';
+import { readInbox, writeToInbox } from './tasks/inbox.mjs';
 // ─── Args ───
 export function parseSchedulerArgs(argv) {
     const opts = { ...SCHEDULER_DEFAULTS };
@@ -131,8 +132,8 @@ export function parseSchedulerArgs(argv) {
         }
         if (arg === '--task-mode') {
             const val = strFlag(arg, i);
-            if (val !== 'local' && val !== 'platform') {
-                console.error(`--task-mode must be 'local' or 'platform'`);
+            if (val !== 'local' && val !== 'platform' && val !== 'interactive') {
+                console.error(`--task-mode must be 'local', 'platform', or 'interactive'`);
                 process.exit(1);
             }
             mutable.taskMode = val;
@@ -146,10 +147,32 @@ export function parseSchedulerArgs(argv) {
     }
     return opts;
 }
+function readTaskPlatformFromClaudeMd(projectDir) {
+    for (const p of ['CLAUDE.md', '.claude/CLAUDE.md']) {
+        const fp = resolve(projectDir, p);
+        if (!existsSync(fp))
+            continue;
+        try {
+            const content = readFileSync(fp, 'utf-8');
+            const match = content.match(/^\s*-\s*\*\*Task Platform\*\*:\s*(\S+)/m);
+            if (match)
+                return match[1].toLowerCase();
+        }
+        catch { /* ignore */ }
+    }
+    return null;
+}
 function detectTaskMode(projectDir) {
+    // Respect explicit Task Platform setting from CLAUDE.md
+    const claudeMdPlatform = readTaskPlatformFromClaudeMd(projectDir);
+    if (claudeMdPlatform === 'local')
+        return 'local';
     const platform = detectCIPlatform(projectDir);
     if (platform === 'none')
         return 'local';
+    // CLAUDE.md says github/gitlab → platform mode
+    if (claudeMdPlatform === 'github' || claudeMdPlatform === 'gitlab')
+        return 'platform';
     try {
         const issues = fetchOpenIssues(projectDir, platform);
         if (issues.length === 0)
@@ -190,7 +213,8 @@ Options:
   --no-pull                  Skip auto git pull
   --idle-poll <ms>           Poll interval when idle (default: 300000)
   --max-idle <ms>            Max idle time before exit (default: 0 = unlimited)
-  --interactive, -i          Interactive TUI with input prompt
+  --task-mode <mode>         Task source: local, platform, or interactive
+  --interactive, -i          Interactive mode — tasks from user input only (implies --task-mode interactive)
   --dry-run                  Validate prerequisites only
   --help                     Show this message
 `);
@@ -225,6 +249,13 @@ export async function runScheduler(opts) {
     const logPath = resolve(opts.projectDir, opts.logFile);
     const tui = new TUI(logPath, opts.interactive);
     tui.setTopAgent('scheduler');
+    // Wire TUI input → inbox (interactive mode: user text becomes tasks)
+    if (opts.interactive) {
+        tui.setInputHandler((text) => {
+            writeToInbox(opts.projectDir, [{ type: 'add-task', title: text }]);
+            tui.addPendingInput(text); // tracks in status bar queue + logs "Queued: text"
+        });
+    }
     const logger = {
         info: (m) => tui.info(m),
         warn: (m) => tui.warn(m),
@@ -304,7 +335,12 @@ export async function runScheduler(opts) {
     }
     // Task mode detection — always re-detect unless user explicitly set --task-mode
     // (stored state may be stale if CLI was installed/authenticated since last run)
-    if (opts.taskMode) {
+    if (opts.interactive && !opts.taskMode) {
+        // Interactive flag implies interactive task mode (no issues, no TODO)
+        state.taskMode = 'interactive';
+        logger.info('Task mode: interactive (user input only)');
+    }
+    else if (opts.taskMode) {
         state.taskMode = opts.taskMode;
         logger.info(`Task mode (from flag): ${state.taskMode}`);
     }
@@ -369,6 +405,15 @@ export async function runScheduler(opts) {
     };
     process.on('SIGINT', cleanup);
     process.on('SIGTERM', cleanup);
+    // Wire TUI hotkeys → scheduler control
+    if (opts.interactive) {
+        tui.setHotkeyHandler((action) => {
+            if (action === 'stop' || action === 'quit') {
+                stopping = true;
+                stoppingRef.value = true;
+            }
+        });
+    }
     // ─── Loop ───
     for (let i = state.iteration; i < opts.maxIterations && !stopping; i++) {
         tui.setIteration(i + 1, opts.maxIterations);
@@ -384,23 +429,36 @@ export async function runScheduler(opts) {
                 onMessage,
                 onSpawnStart,
                 onSpawnEnd,
+                onInboxTaskPicked: opts.interactive ? () => tui.consumePendingInput() : undefined,
             });
             if (!workDone) {
-                // No work → idle polling
-                logger.info('No work available. Entering idle polling...');
-                const idleStart = Date.now();
-                while (!stopping) {
-                    const poll = await pollForNewWork(opts.projectDir, logger, state.taskMode, state.completedTasks);
-                    if (poll.hasWork) {
-                        logger.info(`New work detected (${poll.source}). Resuming...`);
-                        break;
+                if (state.taskMode === 'interactive') {
+                    // Interactive mode: wait for user input (no external polling)
+                    logger.info('Waiting for input...');
+                    while (!stopping) {
+                        const pending = readInbox(opts.projectDir);
+                        if (pending.length > 0 || discoveredIssueStore.peek().length > 0)
+                            break;
+                        await sleep(500, stoppingRef);
                     }
-                    if (opts.maxIdleTime > 0 && Date.now() - idleStart >= opts.maxIdleTime) {
-                        logger.info('Max idle time reached. Exiting.');
-                        stopping = true;
-                        break;
+                }
+                else {
+                    // No work → idle polling (platform/local)
+                    logger.info('No work available. Entering idle polling...');
+                    const idleStart = Date.now();
+                    while (!stopping) {
+                        const poll = await pollForNewWork(opts.projectDir, logger, state.taskMode, state.completedTasks);
+                        if (poll.hasWork) {
+                            logger.info(`New work detected (${poll.source}). Resuming...`);
+                            break;
+                        }
+                        if (opts.maxIdleTime > 0 && Date.now() - idleStart >= opts.maxIdleTime) {
+                            logger.info('Max idle time reached. Exiting.');
+                            stopping = true;
+                            break;
+                        }
+                        await sleep(opts.idlePollInterval, stoppingRef);
                     }
-                    await sleep(opts.idlePollInterval, stoppingRef);
                 }
                 continue;
             }

package/dist/scheduler/loop.mjs

@@ -40,6 +40,7 @@ export async function runIteration(deps) {
             const newTask = addTaskMessageToTask(addMsg, state.currentPhase, nextId);
             inboxTasks.push(newTask);
             logger.info(`[inbox] New task: ${newTask.title}`);
+            deps.onInboxTaskPicked?.(newTask.title);
             appendEvent(projectDir, createEvent('task_started', { taskId: nextId, detail: `inbox: ${newTask.title}` }));
         }
         else if (msg.type === 'message') {
@@ -79,9 +80,12 @@ export async function runIteration(deps) {
         state._recoveryDone = true;
         await recoverOrphanedWorktrees(projectDir, state, logger, deps);
     }
-    // Load tasks (dual mode: platform issues or local TODO.md)
+    // Load tasks (triple mode: interactive = inbox only, platform = issues, local = TODO.md)
     let tasks;
-    if (state.taskMode === 'platform') {
+    if (state.taskMode === 'interactive') {
+        tasks = []; // No external sources — only inbox + discovered
+    }
+    else if (state.taskMode === 'platform') {
         const platform = detectCIPlatform(projectDir);
         if (platform === 'none') {
             logger.error('Platform mode requires a git remote (github/gitlab)');

package/dist/scheduler/util/idle-poll.mjs

@@ -171,6 +171,10 @@ function readTodoSafe(projectDir) {
 }
 // ─── Main poll function ───
 export async function pollForNewWork(projectDir, log, taskMode = 'local', completedTasks = []) {
+    // Interactive mode: no external sources to poll — caller handles inbox directly
+    if (taskMode === 'interactive') {
+        return { hasWork: false, source: null, issueCount: 0 };
+    }
     // Platform mode: check issues directly via CLI
     if (taskMode === 'platform') {
         return pollPlatformIssues(projectDir, log, completedTasks);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-workspace",
-  "version": "2.3.31",
+  "version": "2.3.33",
   "author": "",
   "repository": {
     "type": "git",