wordspace 0.0.8 → 0.0.10

package/dist/commands/init.js

@@ -19,8 +19,7 @@ export async function init(force) {
 Your project is ready. Next steps:
 
   1. Open this directory in your editor
-  2. Start Claude Code:  claude
-  3. Run a workflow:     prose run workflows/<name>.prose
+  2. Run a workflow:  wordspace run workflows/<name>.prose
 
 Browse more workflows:  wordspace search
 Add a workflow:         wordspace add <name>

package/dist/commands/run.d.ts

@@ -1 +1 @@
-export declare function run(target: string | undefined, force: boolean): Promise<void>;
+export declare function run(target: string | undefined, force: boolean, harnessArg?: string): Promise<void>;

package/dist/commands/run.js

@@ -1,22 +1,83 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseGitHubUri, toRawUrl, fileName } from "../lib/github-uri.js";
 import { httpGet, getAuthHeaders } from "../lib/workflows.js";
-import { isClaudeInstalled, spawnClaude } from "../lib/spawn.js";
+import { HARNESSES, detectInstalled, spawnHarness, } from "../lib/harness.js";
+import { pickOne } from "../lib/prompt.js";
 import { ensureInit } from "../steps/auto-init.js";
 import * as log from "../lib/log.js";
-export async function run(target, force) {
+/**
+ * Build the prompt string for a given harness.
+ *
+ * Skill-native harnesses (Claude Code) get the short `/open-prose run <path>` command.
+ * All others receive the .prose file content inline with execution instructions.
+ */
+function buildPrompt(harness, prosePath, cwd) {
+    if (harness.skillNative) {
+        return `/open-prose run ${prosePath}`;
+    }
+    const fullPath = join(cwd, prosePath);
+    const content = readFileSync(fullPath, "utf-8");
+    return [
+        `You are executing a wordspace workflow defined in the file "${prosePath}".`,
+        `Follow the steps below exactly. Write all output files to the "output/" directory.`,
+        "",
+        "--- BEGIN WORKFLOW ---",
+        content,
+        "--- END WORKFLOW ---",
+    ].join("\n");
+}
+export async function run(target, force, harnessArg) {
     if (!target) {
         log.error("Usage: wordspace run <github:owner/repo/path.prose | local-path>");
         process.exit(1);
     }
-    if (!isClaudeInstalled()) {
-        log.error("claude CLI not found. Install Claude Code first: https://claude.ai/code");
-        process.exit(1);
+    // --- Harness selection ---
+    let harness;
+    if (harnessArg) {
+        const match = HARNESSES.find((h) => h.bin === harnessArg || h.name.toLowerCase() === harnessArg.toLowerCase());
+        if (!match) {
+            log.error(`Unknown harness: ${harnessArg}`);
+            log.info("Available harnesses:");
+            for (const h of HARNESSES) {
+                log.info(`  ${h.bin.padEnd(14)} ${h.name}`);
+            }
+            process.exit(1);
+        }
+        // Verify it's installed
+        const installed = detectInstalled();
+        if (!installed.some((h) => h.bin === match.bin)) {
+            log.error(`${match.name} is not installed.`);
+            log.info(`Install it: ${match.installUrl}`);
+            process.exit(1);
+        }
+        harness = match;
+    }
+    else {
+        const installed = detectInstalled();
+        if (installed.length === 0) {
+            log.error("No supported coding agent found.");
+            log.info("Install one of the following:");
+            for (const h of HARNESSES) {
+                log.info(`  ${h.name} → ${h.installUrl}`);
+            }
+            process.exit(1);
+        }
+        else if (installed.length === 1) {
+            harness = installed[0];
+        }
+        else {
+            log.step("Pick a coding agent");
+            harness = await pickOne(installed, (h) => h.mode === "headless" ? `${h.name} (headless)` : h.name, "Select harness");
+        }
+    }
+    log.success(`Using ${harness.name}`);
+    if (harness.mode === "headless") {
+        log.warn("Headless mode — the agent will execute and exit without interaction.");
     }
     const cwd = process.cwd();
-    // Auto-init if needed
-    ensureInit(cwd);
+    // Auto-init if needed (harness-aware)
+    ensureInit(cwd, harness);
     let prosePath;
     if (target.startsWith("github:")) {
         // Remote: download from GitHub
@@ -46,10 +107,15 @@ export async function run(target, force) {
         }
         prosePath = target;
     }
-    const prompt = `/prose run ${prosePath}`;
+    const prompt = buildPrompt(harness, prosePath, cwd);
     console.log();
-    log.info(prompt);
+    if (harness.skillNative) {
+        log.info(prompt);
+    }
+    else {
+        log.info(`Running ${prosePath} via ${harness.name}...`);
+    }
     console.log();
-    const exitCode = spawnClaude(prompt, cwd);
+    const exitCode = spawnHarness(harness, prompt, cwd);
     process.exit(exitCode);
 }

package/dist/index.js

@@ -4,7 +4,7 @@ import { search } from "./commands/search.js";
 import { add } from "./commands/add.js";
 import { run } from "./commands/run.js";
 import * as log from "./lib/log.js";
-const VERSION = "0.0.8";
+const VERSION = "0.0.10";
 const HELP = `
 Usage: wordspace <command> [options]
 
@@ -12,12 +12,13 @@ Commands:
   init          Bootstrap a new wordspace project
   search [q]    List available workflows (optionally filter by query)
   add <name>    Download specific workflow(s) by name
-  run <target>  Run a .prose workflow via Claude Code
+  run <target>  Run a .prose workflow via a coding agent
 
 Options:
-  --force       Re-run all steps / overwrite existing files
-  --help        Show this help message
-  --version     Show version number
+  --force            Re-run all steps / overwrite existing files
+  --harness <name>   Use a specific coding agent (e.g. claude, aider, goose)
+  --help             Show this help message
+  --version          Show version number
 `.trim();
 async function main() {
     const args = process.argv.slice(2);
@@ -29,7 +30,18 @@ async function main() {
         console.log(VERSION);
         process.exit(0);
     }
-    const positional = args.filter((a) => !a.startsWith("-"));
+    const harnessIdx = args.indexOf("--harness");
+    const harnessArg = harnessIdx !== -1 ? args[harnessIdx + 1] : undefined;
+    // Filter out flags and their values from positional args
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--harness") {
+            i++; // skip the value
+        }
+        else if (!args[i].startsWith("-")) {
+            positional.push(args[i]);
+        }
+    }
     const command = positional[0];
     const force = args.includes("--force");
     if (command === "init") {
@@ -42,7 +54,7 @@ async function main() {
         await add(positional.slice(1), force);
     }
     else if (command === "run") {
-        await run(positional[1], force);
+        await run(positional[1], force, harnessArg);
     }
     else if (!command) {
         console.log(HELP);

package/dist/lib/harness.d.ts

@@ -0,0 +1,20 @@
+export interface Harness {
+    /** Display name shown in the picker. */
+    name: string;
+    /** Binary name on PATH. */
+    bin: string;
+    /** Build the CLI args from the prompt string. */
+    args: (prompt: string) => string[];
+    /** URL or install command the user can use to install this harness. */
+    installUrl: string;
+    /** Whether the harness runs interactively or headless. */
+    mode: "interactive" | "headless";
+    /** Whether the harness natively understands /open-prose skill commands. */
+    skillNative: boolean;
+}
+/** All harnesses wordspace knows about, in display order. */
+export declare const HARNESSES: Harness[];
+/** Return only the harnesses whose binary is found on PATH. */
+export declare function detectInstalled(): Harness[];
+/** Spawn a harness interactively, handing over the terminal. */
+export declare function spawnHarness(harness: Harness, prompt: string, cwd: string): number;

package/dist/lib/harness.js

@@ -0,0 +1,104 @@
+import { spawnSync, execSync } from "node:child_process";
+/** All harnesses wordspace knows about, in display order. */
+export const HARNESSES = [
+    {
+        name: "Claude Code",
+        bin: "claude",
+        args: (prompt) => [prompt],
+        installUrl: "npm i -g @anthropic-ai/claude-code",
+        mode: "interactive",
+        skillNative: true,
+    },
+    {
+        name: "Codex",
+        bin: "codex",
+        args: (prompt) => [prompt],
+        installUrl: "npm i -g @openai/codex",
+        mode: "interactive",
+        skillNative: false,
+    },
+    {
+        name: "Gemini CLI",
+        bin: "gemini",
+        args: (prompt) => [prompt],
+        installUrl: "npm i -g @google/gemini-cli",
+        mode: "interactive",
+        skillNative: false,
+    },
+    {
+        name: "Aider",
+        bin: "aider",
+        args: (prompt) => ["--message", prompt],
+        installUrl: "pip install aider-chat",
+        mode: "headless",
+        skillNative: false,
+    },
+    {
+        name: "Amp",
+        bin: "amp",
+        args: (prompt) => [prompt],
+        installUrl: "npm i -g @sourcegraph/amp",
+        mode: "interactive",
+        skillNative: false,
+    },
+    {
+        name: "OpenCode",
+        bin: "opencode",
+        args: (prompt) => ["-p", prompt],
+        installUrl: "https://opencode.ai",
+        mode: "interactive",
+        skillNative: false,
+    },
+    {
+        name: "Goose",
+        bin: "goose",
+        args: (prompt) => ["run", "-t", prompt],
+        installUrl: "brew install block-goose-cli",
+        mode: "headless",
+        skillNative: false,
+    },
+    {
+        name: "Cline",
+        bin: "cline",
+        args: (prompt) => [prompt],
+        installUrl: "npm i -g cline",
+        mode: "interactive",
+        skillNative: false,
+    },
+    {
+        name: "Kiro",
+        bin: "kiro",
+        args: (prompt) => [prompt],
+        installUrl: "curl -fsSL https://cli.kiro.dev/install | bash",
+        mode: "interactive",
+        skillNative: false,
+    },
+    {
+        name: "Cursor Agent",
+        bin: "cursor-agent",
+        args: (prompt) => ["chat", prompt],
+        installUrl: "https://cursor.com",
+        mode: "interactive",
+        skillNative: false,
+    },
+];
+/** Return only the harnesses whose binary is found on PATH. */
+export function detectInstalled() {
+    return HARNESSES.filter((h) => {
+        try {
+            execSync(`which ${h.bin}`, { stdio: "pipe" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** Spawn a harness interactively, handing over the terminal. */
+export function spawnHarness(harness, prompt, cwd) {
+    const result = spawnSync(harness.bin, harness.args(prompt), {
+        cwd,
+        stdio: "inherit",
+    });
+    return result.status ?? 1;
+}

package/dist/lib/prompt.d.ts

@@ -7,3 +7,9 @@
  * In non-TTY environments (CI), auto-selects all items.
  */
 export declare function pickMany<T>(items: T[], label: (item: T, index: number) => string, prompt: string): Promise<T[]>;
+/**
+ * Prompt the user to pick a single item from a numbered list.
+ *
+ * In non-TTY environments (CI), auto-selects the first item.
+ */
+export declare function pickOne<T>(items: T[], label: (item: T, index: number) => string, prompt: string): Promise<T>;

package/dist/lib/prompt.js

@@ -22,6 +22,35 @@ export async function pickMany(items, label, prompt) {
     const answer = await ask(`${prompt} [all/none/1,2,3/1-3]: `);
     return parseSelection(answer, items);
 }
+/**
+ * Prompt the user to pick a single item from a numbered list.
+ *
+ * In non-TTY environments (CI), auto-selects the first item.
+ */
+export async function pickOne(items, label, prompt) {
+    if (items.length === 1)
+        return items[0];
+    // Non-TTY: auto-select first
+    if (!process.stdin.isTTY) {
+        return items[0];
+    }
+    // Print numbered list
+    for (let i = 0; i < items.length; i++) {
+        console.log(`  ${String(i + 1).padStart(2)}  ${label(items[i], i)}`);
+    }
+    console.log();
+    // Keep asking until we get a valid answer
+    while (true) {
+        const answer = await ask(`${prompt} [1-${items.length}]: `);
+        const n = parseInt(answer, 10);
+        if (!isNaN(n) && n >= 1 && n <= items.length) {
+            return items[n - 1];
+        }
+        // Default to first item on empty input
+        if (answer === "")
+            return items[0];
+    }
+}
 function ask(prompt) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((resolve) => {

package/dist/steps/auto-init.d.ts

@@ -1,2 +1,3 @@
+import type { Harness } from "../lib/harness.js";
 /** Silently initialize the project if not already done. */
-export declare function ensureInit(cwd: string): void;
+export declare function ensureInit(cwd: string, harness: Harness): void;

package/dist/steps/auto-init.js

@@ -22,8 +22,11 @@ function installSkills(cwd) {
     }
 }
 /** Silently initialize the project if not already done. */
-export function ensureInit(cwd) {
-    const hasSettings = existsSync(join(cwd, ".claude", "settings.local.json"));
+export function ensureInit(cwd, harness) {
+    const isClaude = harness.bin === "claude";
+    const hasSettings = isClaude
+        ? existsSync(join(cwd, ".claude", "settings.local.json"))
+        : true; // non-Claude harnesses don't need Claude settings
     const hasOutput = existsSync(join(cwd, "output"));
     const skillsDir = join(cwd, ".agents", "skills");
     const hasSkills = existsSync(join(skillsDir, "open-prose")) &&
@@ -33,10 +36,12 @@ export function ensureInit(cwd) {
     if (hasSettings && hasOutput && hasSkills)
         return;
     log.info("Auto-initializing project...");
-    if (!hasSettings || !hasOutput) {
-        setupClaude(cwd);
+    if (!hasOutput) {
         createDirs(cwd);
     }
+    if (isClaude && !hasSettings) {
+        setupClaude(cwd);
+    }
     if (!hasSkills) {
         installSkills(cwd);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wordspace",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "files": [
     "dist"

package/dist/lib/spawn.d.ts

@@ -1,4 +0,0 @@
-/** Check if `claude` CLI is available on PATH. */
-export declare function isClaudeInstalled(): boolean;
-/** Spawn `claude` interactively, handing over the terminal. */
-export declare function spawnClaude(prompt: string, cwd: string): number;

package/dist/lib/spawn.js

@@ -1,19 +0,0 @@
-import { spawnSync, execSync } from "node:child_process";
-/** Check if `claude` CLI is available on PATH. */
-export function isClaudeInstalled() {
-    try {
-        execSync("which claude", { stdio: "pipe" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Spawn `claude` interactively, handing over the terminal. */
-export function spawnClaude(prompt, cwd) {
-    const result = spawnSync("claude", [prompt], {
-        cwd,
-        stdio: "inherit",
-    });
-    return result.status ?? 1;
-}