create-claude-workspace 1.1.19 → 1.1.21

package/README.md

@@ -29,8 +29,8 @@ Answer the discovery questions (non-technical). Claude generates the full pipeli
 
 Pick one:
 
-- **Unattended** (recommended): `node .claude/scripts/autonomous.mjs --skip-permissions` — clean context per task, survives rate limits
-- **Docker** (fully isolated): `node .claude/scripts/docker-run.mjs` — container sandbox, safe `--skip-permissions`
+- **Unattended** (recommended): `npx create-claude-workspace run` — clean context per task, survives rate limits
+- **Docker** (fully isolated): `npx create-claude-workspace docker` — container sandbox, safe `--skip-permissions`
 - **Interactive**: `claude --agent orchestrator`, then `/ralph-loop:ralph-loop Continue autonomous development according to CLAUDE.md`
 
 ### npx Options
@@ -45,11 +45,11 @@ npx create-claude-workspace --docker       # scaffold + run in Docker
 ### Docker Options
 
 ```bash
-node .claude/scripts/docker-run.mjs --max-iterations 20   # limit iterations
-node .claude/scripts/docker-run.mjs --shell                # interactive shell
-node .claude/scripts/docker-run.mjs --rebuild              # force rebuild image
-node .claude/scripts/docker-run.mjs --login                # run 'claude auth login' on host first
-ANTHROPIC_API_KEY=sk-... node .claude/scripts/docker-run.mjs  # API key
+npx create-claude-workspace docker --max-iterations 20   # limit iterations
+npx create-claude-workspace docker --shell                # interactive shell
+npx create-claude-workspace docker --rebuild              # force rebuild image
+npx create-claude-workspace docker --login                # run 'claude auth login' on host first
+ANTHROPIC_API_KEY=sk-... npx create-claude-workspace docker  # API key
 ```
 
 **Authentication:** The Docker container uses your host machine's Claude auth automatically.
@@ -99,17 +99,16 @@ ralph-loop -> orchestrator agent (autonomous development)
 
 ## Autonomous Mode (Unattended)
 
-The `.claude/scripts/autonomous.mjs` script runs Claude Code in a loop with clean context per task. MEMORY.md maintains continuity between invocations.
+The autonomous loop runs Claude Code in separate invocations with clean context per task. MEMORY.md maintains continuity between invocations.
 
 ```bash
-# Unattended (requires --skip-permissions for no permission prompts)
-node .claude/scripts/autonomous.mjs --skip-permissions
+# Unattended (--skip-permissions is added automatically)
+npx create-claude-workspace run
 
 # Custom options
-node .claude/scripts/autonomous.mjs --skip-permissions --max-iterations 20 --delay 10000
+npx create-claude-workspace run --max-iterations 20 --delay 10000
 
 # All options:
-#   --skip-permissions       Required for unattended (adds --dangerously-skip-permissions)
 #   --max-iterations <n>     Safety limit (default: 50)
 #   --max-turns <n>          Max turns per Claude invocation (default: 50)
 #   --delay <ms>             Pause between tasks (default: 5000)

package/dist/index.js

@@ -60,23 +60,34 @@ function printHelp() {
 ${C.b}create-claude-workspace${C.n} — Scaffold autonomous AI-driven development with Claude Code
 
 ${C.b}Usage:${C.n}
-  npx create-claude-workspace [directory] [options]
+  npx create-claude-workspace [directory] [options]     # scaffold
+  npx create-claude-workspace run [options]             # autonomous loop
+  npx create-claude-workspace docker [options]          # Docker runner
+  npx create-claude-workspace validate                  # check prerequisites
 
-${C.b}Arguments:${C.n}
+${C.b}Scaffold options:${C.n}
   directory          Target directory (default: current directory)
-
-${C.b}Options:${C.n}
   --update           Overwrite existing agent files with latest version
   --run              Start autonomous development after scaffolding
   --docker           Use Docker for autonomous run (implies --run)
   -h, --help         Show this help
 
+${C.b}Run options:${C.n}
+  --max-iterations <n>         Max iterations (default: 50)
+  --max-turns <n>              Max turns per invocation (default: 50)
+  --process-timeout <ms>       Max time per invocation (default: 1800000)
+  --activity-timeout <ms>      Max silence before kill (default: 300000)
+  --notify-command <cmd>       Shell command on critical events
+  --resume                     Resume from checkpoint
+  --dry-run                    Validate prerequisites only
+  See 'npx create-claude-workspace run --help' for all options.
+
 ${C.b}Examples:${C.n}
   npx create-claude-workspace                    # scaffold in current directory
-  npx create-claude-workspace my-project         # scaffold in ./my-project
-  npx create-claude-workspace --update           # update agents to latest version
-  npx create-claude-workspace --run              # scaffold + start autonomous loop
-  npx create-claude-workspace --docker           # scaffold + run in Docker
+  npx create-claude-workspace run                # start autonomous loop
+  npx create-claude-workspace run --resume       # resume from checkpoint
+  npx create-claude-workspace docker             # run in Docker
+  npx create-claude-workspace validate           # check prerequisites
 
 ${C.b}What it creates:${C.n}
   .claude/agents/        10 specialist agents (orchestrator, architects, etc.)
@@ -90,6 +101,7 @@ ${C.b}What it creates:${C.n}
 function ask(question) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((res) => {
+        rl.on('close', () => res(''));
         rl.question(question, (answer) => {
             rl.close();
             res(answer.trim());
@@ -116,12 +128,14 @@ function listFiles(dir, base = dir) {
 }
 function ensureGitignore(targetDir) {
     const gitignorePath = join(targetDir, '.gitignore');
-    const entries = ['.npmrc', '.docker-compose.auth.yml'];
+    const entries = ['.npmrc', '.docker-compose.auth.yml', '.claude/autonomous.log', '.claude/autonomous.lock', '.claude/autonomous-state.json'];
     if (existsSync(gitignorePath)) {
         let content = readFileSync(gitignorePath, 'utf-8');
         const added = [];
+        if (!content.endsWith('\n'))
+            content += '\n';
         for (const entry of entries) {
-            if (!content.includes(entry)) {
+            if (!content.split('\n').some(line => line.trim() === entry)) {
                 content += `\n${entry}`;
                 added.push(entry);
             }
@@ -133,9 +147,9 @@ function ensureGitignore(targetDir) {
     }
 }
 // ─── Run ───
-function runAutonomous(targetDir, docker) {
+function runAutonomous(targetDir, docker, extraArgs = []) {
     const script = docker ? '.claude/scripts/docker-run.mjs' : '.claude/scripts/autonomous.mjs';
-    const args = docker ? [script] : [script, '--skip-permissions'];
+    const args = docker ? [script, ...extraArgs] : [script, '--skip-permissions', ...extraArgs];
     if (docker) {
         info('Starting Docker-based autonomous development...');
     }
@@ -146,12 +160,27 @@ function runAutonomous(targetDir, docker) {
     const child = spawn('node', args, {
         cwd: targetDir,
         stdio: 'inherit',
-        shell: true,
     });
     child.on('close', (code) => process.exit(code ?? 0));
 }
 // ─── Main ───
 async function main() {
+    // Subcommand routing: run, docker, validate, plan
+    const firstArg = process.argv[2];
+    if (firstArg === 'run') {
+        const extraArgs = process.argv.slice(3);
+        runAutonomous(process.cwd(), false, extraArgs);
+        return;
+    }
+    if (firstArg === 'docker') {
+        const extraArgs = process.argv.slice(3);
+        runAutonomous(process.cwd(), true, extraArgs);
+        return;
+    }
+    if (firstArg === 'validate') {
+        runAutonomous(process.cwd(), false, ['--dry-run']);
+        return;
+    }
     const opts = parseArgs();
     if (opts.help) {
         printHelp();
@@ -217,10 +246,10 @@ async function main() {
         console.log(`  claude --agent project-initializer`);
         console.log('');
         console.log(`  ${C.d}# Autonomous development in Docker${C.n}`);
-        console.log(`  node .claude/scripts/docker-run.mjs`);
+        console.log(`  npx create-claude-workspace docker`);
         console.log('');
         console.log(`  ${C.d}# Autonomous development without Docker${C.n}`);
-        console.log(`  node .claude/scripts/autonomous.mjs --skip-permissions`);
+        console.log(`  npx create-claude-workspace run`);
         console.log('');
     }
     if (opts.run) {

package/dist/template/.claude/CLAUDE.md

@@ -53,10 +53,10 @@ You: "I'll delegate this to the project-initializer agent."
 
 ```powershell
 # Docker — isolated, safe (recommended)
-node .claude/scripts/docker-run.mjs       # all platforms (Windows / macOS / Linux)
+npx create-claude-workspace docker        # all platforms (Windows / macOS / Linux)
 
 # Without Docker (uses --agent orchestrator automatically)
-node .claude/scripts/autonomous.mjs --skip-permissions
+npx create-claude-workspace run
 
 # Interactive — start Claude with orchestrator as top-level agent
 claude --agent orchestrator

package/dist/template/.claude/agents/project-initializer.md

@@ -302,5 +302,5 @@ Then tell the user:
 - GitLab/GitHub: [N] milestones + [M] issues created
 
 Start autonomous development:
-- **Unattended**: `node .claude/scripts/autonomous.mjs --skip-permissions` (recommended — clean context per task, survives rate limits)
+- **Unattended**: `npx create-claude-workspace run` (recommended — clean context per task, survives rate limits)
 - **Interactive**: `/ralph-loop:ralph-loop Use orchestrator agent to continue autonomous development according to CLAUDE.md`"

package/dist/template/.claude/docker/docker-entrypoint.sh

@@ -44,7 +44,7 @@ if [[ -z "${ANTHROPIC_API_KEY:-}" ]]; then
     echo "    Then re-run docker-run.mjs"
     echo ""
     echo "  Option 2 — API key:"
-    echo "    ANTHROPIC_API_KEY=sk-... node .claude/scripts/docker-run.mjs"
+    echo "    ANTHROPIC_API_KEY=sk-... npx create-claude-workspace docker"
     echo ""
     exit 1
   fi