openscout 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+declare const VERSION = "0.1.0";
+declare const BRAND = "\u001B[32m\u25C6\u001B[0m";
+declare const args: string[];
+declare const command: string;
+declare function printBrand(): void;
+declare function help(): void;
+declare function init(): Promise<void>;
+declare function add(): Promise<void>;
+declare function list(): Promise<void>;
+declare function run(): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+"use strict";
+const VERSION = "0.1.0";
+const BRAND = "\x1b[32m◆\x1b[0m";
+const args = process.argv.slice(2);
+const command = args[0];
+function print(msg) {
+    console.log(msg);
+}
+function printBrand() {
+    print(`\n  ${BRAND} \x1b[1mOpenScout\x1b[0m v${VERSION}\n`);
+}
+function help() {
+    printBrand();
+    print("  \x1b[2mAgent-forward development platform for builders\x1b[0m\n");
+    print("  \x1b[1mUsage:\x1b[0m");
+    print("    openscout <command> [options]\n");
+    print("  \x1b[1mCommands:\x1b[0m");
+    print("    init              Scaffold a new agent workspace");
+    print("    add <type>        Add an agent, tool, or workflow");
+    print("    run               Run your agents");
+    print("    list              List configured agents and tools");
+    print("    --help, -h        Show this help message");
+    print("    --version, -v     Show version\n");
+    print("  \x1b[1mExamples:\x1b[0m");
+    print("    npx openscout init");
+    print("    openscout add agent --name reviewer");
+    print("    openscout run\n");
+    print(`  \x1b[2mhttps://openscout.app\x1b[0m\n`);
+}
+async function init() {
+    printBrand();
+    const cwd = process.cwd();
+    const projectName = cwd.split("/").pop() || "my-project";
+    print(`  Initializing OpenScout in \x1b[1m${projectName}\x1b[0m...\n`);
+    // Create config directory
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const configDir = path.join(cwd, ".openscout");
+    await fs.mkdir(configDir, { recursive: true });
+    // Create config file
+    const config = {
+        name: projectName,
+        version: "0.1.0",
+        agents: [],
+        tools: [],
+        workflows: [],
+        settings: {
+            model: "auto",
+            local: true,
+            streaming: true,
+        },
+    };
+    await fs.writeFile(path.join(configDir, "config.json"), JSON.stringify(config, null, 2) + "\n");
+    // Create agents directory
+    await fs.mkdir(path.join(configDir, "agents"), { recursive: true });
+    // Create tools directory
+    await fs.mkdir(path.join(configDir, "tools"), { recursive: true });
+    // Create example agent
+    const exampleAgent = {
+        name: "scout",
+        description: "Default agent for general tasks",
+        model: "auto",
+        tools: [],
+        instructions: "You are a helpful development agent.",
+    };
+    await fs.writeFile(path.join(configDir, "agents", "scout.json"), JSON.stringify(exampleAgent, null, 2) + "\n");
+    print("  \x1b[32m✓\x1b[0m Created .openscout/config.json");
+    print("  \x1b[32m✓\x1b[0m Created .openscout/agents/scout.json");
+    print("  \x1b[32m✓\x1b[0m Created .openscout/agents/");
+    print("  \x1b[32m✓\x1b[0m Created .openscout/tools/\n");
+    print("  \x1b[1mNext steps:\x1b[0m");
+    print("    openscout add agent --name <name>");
+    print("    openscout run\n");
+}
+async function add() {
+    const type = args[1];
+    if (!type) {
+        print("\n  \x1b[31m✗\x1b[0m Missing type. Usage: openscout add <agent|tool>\n");
+        process.exit(1);
+    }
+    const nameIdx = args.indexOf("--name");
+    const name = nameIdx !== -1 ? args[nameIdx + 1] : undefined;
+    if (!name) {
+        print(`\n  \x1b[31m✗\x1b[0m Missing --name. Usage: openscout add ${type} --name <name>\n`);
+        process.exit(1);
+    }
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const cwd = process.cwd();
+    const configDir = path.join(cwd, ".openscout");
+    // Check if initialized
+    try {
+        await fs.access(path.join(configDir, "config.json"));
+    }
+    catch {
+        print("\n  \x1b[31m✗\x1b[0m Not initialized. Run \x1b[1mopenscout init\x1b[0m first.\n");
+        process.exit(1);
+    }
+    if (type === "agent") {
+        const agent = {
+            name,
+            description: "",
+            model: "auto",
+            tools: [],
+            instructions: `You are the ${name} agent.`,
+        };
+        await fs.writeFile(path.join(configDir, "agents", `${name}.json`), JSON.stringify(agent, null, 2) + "\n");
+        // Update config
+        const configRaw = await fs.readFile(path.join(configDir, "config.json"), "utf-8");
+        const config = JSON.parse(configRaw);
+        config.agents.push(name);
+        await fs.writeFile(path.join(configDir, "config.json"), JSON.stringify(config, null, 2) + "\n");
+        print(`\n  \x1b[32m✓\x1b[0m Added agent \x1b[1m${name}\x1b[0m`);
+        print(`  \x1b[2m→ .openscout/agents/${name}.json\x1b[0m\n`);
+    }
+    else if (type === "tool") {
+        const tool = {
+            name,
+            description: "",
+            command: "",
+        };
+        await fs.writeFile(path.join(configDir, "tools", `${name}.json`), JSON.stringify(tool, null, 2) + "\n");
+        const configRaw = await fs.readFile(path.join(configDir, "config.json"), "utf-8");
+        const config = JSON.parse(configRaw);
+        config.tools.push(name);
+        await fs.writeFile(path.join(configDir, "config.json"), JSON.stringify(config, null, 2) + "\n");
+        print(`\n  \x1b[32m✓\x1b[0m Added tool \x1b[1m${name}\x1b[0m`);
+        print(`  \x1b[2m→ .openscout/tools/${name}.json\x1b[0m\n`);
+    }
+    else {
+        print(`\n  \x1b[31m✗\x1b[0m Unknown type: ${type}. Use \x1b[1magent\x1b[0m or \x1b[1mtool\x1b[0m.\n`);
+        process.exit(1);
+    }
+}
+async function list() {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, ".openscout", "config.json");
+    try {
+        await fs.access(configPath);
+    }
+    catch {
+        print("\n  \x1b[31m✗\x1b[0m Not initialized. Run \x1b[1mopenscout init\x1b[0m first.\n");
+        process.exit(1);
+    }
+    const configRaw = await fs.readFile(configPath, "utf-8");
+    const config = JSON.parse(configRaw);
+    printBrand();
+    print("  \x1b[1mAgents:\x1b[0m");
+    if (config.agents.length === 0) {
+        print("    \x1b[2m(none — run openscout add agent --name <name>)\x1b[0m");
+    }
+    else {
+        for (const a of config.agents) {
+            print(`    ${BRAND} ${a}`);
+        }
+    }
+    print("\n  \x1b[1mTools:\x1b[0m");
+    if (config.tools.length === 0) {
+        print("    \x1b[2m(none — run openscout add tool --name <name>)\x1b[0m");
+    }
+    else {
+        for (const t of config.tools) {
+            print(`    ▣ ${t}`);
+        }
+    }
+    print("");
+}
+async function run() {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, ".openscout", "config.json");
+    try {
+        await fs.access(configPath);
+    }
+    catch {
+        print("\n  \x1b[31m✗\x1b[0m Not initialized. Run \x1b[1mopenscout init\x1b[0m first.\n");
+        process.exit(1);
+    }
+    const configRaw = await fs.readFile(configPath, "utf-8");
+    const config = JSON.parse(configRaw);
+    printBrand();
+    print("  Starting agents...\n");
+    if (config.agents.length === 0) {
+        print("  \x1b[33m!\x1b[0m No agents configured. Add one with:");
+        print("    openscout add agent --name <name>\n");
+        return;
+    }
+    for (const name of config.agents) {
+        const agentPath = path.join(cwd, ".openscout", "agents", `${name}.json`);
+        try {
+            const raw = await fs.readFile(agentPath, "utf-8");
+            const agent = JSON.parse(raw);
+            print(`  \x1b[32m●\x1b[0m ${agent.name} \x1b[2m— ${agent.description || agent.instructions}\x1b[0m`);
+        }
+        catch {
+            print(`  \x1b[33m○\x1b[0m ${name} \x1b[2m— config not found\x1b[0m`);
+        }
+    }
+    print("\n  \x1b[2mAgent runtime coming soon.\x1b[0m\n");
+}
+// Route
+switch (command) {
+    case "init":
+        init();
+        break;
+    case "add":
+        add();
+        break;
+    case "run":
+        run();
+        break;
+    case "list":
+    case "ls":
+        list();
+        break;
+    case "--version":
+    case "-v":
+        print(VERSION);
+        break;
+    case "--help":
+    case "-h":
+    case undefined:
+        help();
+        break;
+    default:
+        print(`\n  \x1b[31m✗\x1b[0m Unknown command: ${command}\n`);
+        help();
+        process.exit(1);
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "openscout",
+  "version": "0.1.0",
+  "description": "Agent-forward development platform for builders",
+  "type": "module",
+  "bin": {
+    "openscout": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "agents",
+    "ai",
+    "development",
+    "cli",
+    "local-first"
+  ],
+  "author": "Arach Tchoupani",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5"
+  }
+}