@lazarusrolando/crayoncli 0.0.0-stage → 0.1.0

package/.env.example

@@ -0,0 +1,3 @@
+OPENAI_API_KEY=
+OPENAI_BASE_URL=https://api.openai.com/v1
+CRAYON_MODEL=gpt-5.6

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# CRAYON — Open-source Crayon-style CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Node.js/TypeScript coding agent for local projects.
+
+## Setup
+
+```powershell
+npm install
+Copy-Item .env.example .env
+# edit .env and add OPENAI_API_KEY
+npm run build
+npm link
+crayon
+```
+
+Direct task:
+```powershell
+crayon "inspect this project and fix the failing tests"
+```
+
+The agent can read/write files, search source code, and run development commands. Destructive shell commands require approval.

package/dist/agent/agent.js

@@ -0,0 +1,27 @@
+import { OpenAIProvider } from "../providers/openai.js";
+import { definitions, execute } from "../tools/registry.js";
+const SYSTEM = `You are CRAYON, an autonomous coding agent. Work inside the current project. Inspect before editing. Prefer small, safe changes. Explain what you are doing. Use tools to read/search/edit/run tests. Never claim a change was made unless the tool succeeded. Do not access files outside the project root.`;
+export class Agent {
+    provider = new OpenAIProvider();
+    messages = [{ role: "system", content: SYSTEM }];
+    async run(input) { this.messages.push({ role: "user", content: input }); for (let i = 0; i < 30; i++) {
+        const r = await this.provider.chat(this.messages, definitions);
+        if (r.content)
+            console.log(`\n${r.content}`);
+        if (!r.toolCalls.length)
+            return;
+        if (r.content)
+            this.messages.push({ role: "assistant", content: r.content });
+        for (const c of r.toolCalls) {
+            let result = "";
+            try {
+                result = await execute(c.name, JSON.parse(c.arguments));
+            }
+            catch (e) {
+                result = `ERROR: ${e instanceof Error ? e.message : String(e)}`;
+            }
+            this.messages.push({ role: "tool", tool_call_id: c.id, content: String(result) });
+            console.log(`\n● ${c.name}`);
+        }
+    } throw new Error("Agent reached maximum tool iterations."); }
+}

package/dist/cli/interactive.js

@@ -0,0 +1,16 @@
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { Agent } from "../agent/agent.js";
+export async function interactive() { console.log("\n╭──────────────────────────────────────────────╮\n│              CRAYON CODING AGENT                │\n│        Open-source Crayon-style CLI     │\n╰──────────────────────────────────────────────╯\n"); const rl = readline.createInterface({ input, output }); const agent = new Agent(); while (true) {
+    const q = (await rl.question("\n> ")).trim();
+    if (!q)
+        continue;
+    if (["exit", "quit"].includes(q.toLowerCase()))
+        break;
+    try {
+        await agent.run(q);
+    }
+    catch (e) {
+        console.error(`\n✖ ${e instanceof Error ? e.message : e}`);
+    }
+} rl.close(); }

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { Command } from "commander";
+import { interactive } from "./cli/interactive.js";
+import { Agent } from "./agent/agent.js";
+const p = new Command();
+p.name("crayon").description("Open-source AI coding agent CLI").argument("[prompt]", "task for the coding agent").option("-v, --version", "show version").action(async (prompt) => { if (!process.env.OPENAI_API_KEY) {
+    console.error("Missing OPENAI_API_KEY. Copy .env.example to .env and add your key.");
+    process.exit(1);
+} if (prompt) {
+    await new Agent().run(prompt);
+}
+else
+    await interactive(); });
+p.parseAsync();

package/dist/providers/openai.js

@@ -0,0 +1,11 @@
+import OpenAI from "openai";
+export class OpenAIProvider {
+    client;
+    model;
+    constructor() { this.client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY, baseURL: process.env.OPENAI_BASE_URL }); this.model = process.env.CRAYON_MODEL || "gpt-5.6"; }
+    async chat(messages, tools) {
+        const r = await this.client.chat.completions.create({ model: this.model, messages: messages, tools: tools, tool_choice: "auto" });
+        const m = r.choices[0]?.message;
+        return { content: m?.content ?? null, toolCalls: (m?.tool_calls ?? []).map((x) => ({ id: x.id, name: x.function.name, arguments: x.function.arguments })) };
+    }
+}

package/dist/providers/provider.js

@@ -0,0 +1 @@
+export {};

package/dist/tools/filesystem.js

@@ -0,0 +1,29 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const root = process.cwd();
+function safe(p) { const r = path.resolve(root, p); if (r !== root && !r.startsWith(root + path.sep))
+    throw new Error("Path escapes project root"); return r; }
+export const fsTools = [
+    { name: "read_file", description: "Read a UTF-8 text file in the project.", parameters: { type: "object", properties: { path: { type: "string" } }, required: ["path"] } },
+    { name: "write_file", description: "Write or replace a UTF-8 text file in the project.", parameters: { type: "object", properties: { path: { type: "string" }, content: { type: "string" } }, required: ["path", "content"] } },
+    { name: "list_files", description: "List project files recursively, excluding common dependency/build folders.", parameters: { type: "object", properties: { path: { type: "string" } }, required: [] } },
+];
+export async function runFs(name, args) { if (name === "read_file")
+    return await fs.readFile(safe(args.path), "utf8"); if (name === "write_file") {
+    await fs.mkdir(path.dirname(safe(args.path)), { recursive: true });
+    await fs.writeFile(safe(args.path), args.content, "utf8");
+    return `Wrote ${args.path}`;
+} if (name === "list_files") {
+    const out = [];
+    async function walk(d) { for (const e of await fs.readdir(d, { withFileTypes: true })) {
+        if (["node_modules", ".git", "dist", "build", ".next"].includes(e.name))
+            continue;
+        const p = path.join(d, e.name);
+        if (e.isDirectory())
+            await walk(p);
+        else
+            out.push(path.relative(root, p));
+    } }
+    await walk(safe(args.path || "."));
+    return out.slice(0, 500).join("\n");
+} throw new Error("Unknown filesystem tool"); }

package/dist/tools/registry.js

@@ -0,0 +1,8 @@
+import { fsTools, runFs } from "./filesystem.js";
+import { searchTool, searchCode } from "./search.js";
+import { terminalTool, runCommand } from "./terminal.js";
+export const definitions = [...fsTools.map(x => ({ type: "function", function: x })), { type: "function", function: searchTool }, { type: "function", function: terminalTool }];
+export async function execute(name, args) { if (["read_file", "write_file", "list_files"].includes(name))
+    return runFs(name, args); if (name === "search_code")
+    return searchCode(args.query); if (name === "run_command")
+    return runCommand(args.command); throw new Error(`Unknown tool: ${name}`); }

package/dist/tools/search.js

@@ -0,0 +1,18 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export const searchTool = { name: "search_code", description: "Search text across project source files.", parameters: { type: "object", properties: { query: { type: "string" } }, required: ["query"] } };
+export async function searchCode(query) { const root = process.cwd(), hits = []; async function walk(d) { for (const e of await fs.readdir(d, { withFileTypes: true })) {
+    if (["node_modules", ".git", "dist", "build", ".next"].includes(e.name))
+        continue;
+    const p = path.join(d, e.name);
+    if (e.isDirectory())
+        await walk(p);
+    else {
+        try {
+            const s = await fs.readFile(p, "utf8");
+            if (s.includes(query))
+                hits.push(path.relative(root, p));
+        }
+        catch { }
+    }
+} } await walk(root); return hits.slice(0, 100).join("\n") || "No matches."; }

package/dist/tools/terminal.js

@@ -0,0 +1,13 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import readline from "node:readline/promises";
+const ex = promisify(exec);
+export const terminalTool = { name: "run_command", description: "Run a shell command in the project. Use only for safe development commands.", parameters: { type: "object", properties: { command: { type: "string" } }, required: ["command"] } };
+const dangerous = /\b(del|erase|rmdir|rm|format|shutdown|reboot|diskpart|git\s+reset\s+--hard)\b/i;
+export async function runCommand(command) { if (dangerous.test(command)) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const a = await rl.question(`Approve potentially destructive command? ${command} [y/N] `);
+    rl.close();
+    if (a.toLowerCase() !== "y")
+        return "Command denied by user.";
+} const r = await ex(command, { cwd: process.cwd(), timeout: 120000, maxBuffer: 5 * 1024 * 1024, shell: process.platform === "win32" ? "powershell.exe" : true }); return (r.stdout + r.stderr).trim(); }

package/package.json

@@ -1,6 +1,29 @@
-{
-  "name": "@lazarusrolando/crayoncli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+    "name": "@lazarusrolando/crayoncli",
+    "version": "0.1.0",
+    "type": "module",
+    "bin": {
+        "crayon": "./dist/index.js"
+    },
+    "scripts": {
+        "dev": "tsx src/index.ts",
+        "build": "tsc",
+        "start": "node dist/index.js"
+    },
+    "dependencies": {
+        "chalk": "^5.4.1",
+        "commander": "^14.0.0",
+        "dotenv": "^17.2.2",
+        "fast-glob": "^3.3.3",
+        "inquirer": "^12.9.4",
+        "openai": "^6.0.0",
+        "ora": "^8.2.0",
+        "pino": "^9.9.0",
+        "uuid": "^11.1.0"
+    },
+    "devDependencies": {
+        "@types/node": "^24.5.2",
+        "tsx": "^4.19.2",
+        "typescript": "^5.9.2"
+    }
+}

package/src/agent/agent.ts

@@ -0,0 +1,3 @@
+import type {Message} from "../providers/provider.js"; import {OpenAIProvider} from "../providers/openai.js"; import {definitions,execute} from "../tools/registry.js";
+const SYSTEM=`You are CRAYON, an autonomous coding agent. Work inside the current project. Inspect before editing. Prefer small, safe changes. Explain what you are doing. Use tools to read/search/edit/run tests. Never claim a change was made unless the tool succeeded. Do not access files outside the project root.`;
+export class Agent { private provider=new OpenAIProvider(); private messages:Message[]=[{role:"system",content:SYSTEM}]; async run(input:string){this.messages.push({role:"user",content:input}); for(let i=0;i<30;i++){const r=await this.provider.chat(this.messages,definitions); if(r.content) console.log(`\n${r.content}`); if(!r.toolCalls.length) return; if(r.content)this.messages.push({role:"assistant",content:r.content}); for(const c of r.toolCalls){let result="";try{result=await execute(c.name,JSON.parse(c.arguments));}catch(e){result=`ERROR: ${e instanceof Error?e.message:String(e)}`;} this.messages.push({role:"tool",tool_call_id:c.id,content:String(result)}); console.log(`\n● ${c.name}`);}} throw new Error("Agent reached maximum tool iterations.");}}

package/src/cli/interactive.ts

@@ -0,0 +1,2 @@
+import readline from "node:readline/promises"; import {stdin as input,stdout as output} from "node:process"; import {Agent} from "../agent/agent.js";
+export async function interactive(){console.log("\n╭──────────────────────────────────────────────╮\n│              CRAYON CODING AGENT                │\n│        Open-source Crayon-style CLI     │\n╰──────────────────────────────────────────────╯\n"); const rl=readline.createInterface({input,output}); const agent=new Agent(); while(true){const q=(await rl.question("\n> ")).trim();if(!q)continue;if(["exit","quit"].includes(q.toLowerCase()))break;try{await agent.run(q);}catch(e){console.error(`\n✖ ${e instanceof Error?e.message:e}`);}}rl.close();}

package/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config"; import {Command} from "commander"; import {interactive} from "./cli/interactive.js"; import {Agent} from "./agent/agent.js";
+const p=new Command();p.name("crayon").description("Open-source AI coding agent CLI").argument("[prompt]","task for the coding agent").option("-v, --version","show version").action(async(prompt:string|undefined)=>{if(!process.env.OPENAI_API_KEY){console.error("Missing OPENAI_API_KEY. Copy .env.example to .env and add your key.");process.exit(1);}if(prompt){await new Agent().run(prompt);}else await interactive();});p.parseAsync();

package/src/providers/openai.ts

@@ -0,0 +1,10 @@
+import OpenAI from "openai";
+import type { ModelProvider, Message, ToolDef, ChatResult } from "./provider.js";
+export class OpenAIProvider implements ModelProvider {
+  private client: OpenAI; private model: string;
+  constructor() { this.client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY, baseURL: process.env.OPENAI_BASE_URL }); this.model = process.env.CRAYON_MODEL || "gpt-5.6"; }
+  async chat(messages: Message[], tools: ToolDef[]): Promise<ChatResult> {
+    const r = await this.client.chat.completions.create({ model: this.model, messages: messages as any, tools: tools as any, tool_choice: "auto" });
+    const m = r.choices[0]?.message; return { content: m?.content ?? null, toolCalls: (m?.tool_calls ?? []).map((x: any) => ({ id:x.id, name:x.function.name, arguments:x.function.arguments })) };
+  }
+}

package/src/providers/provider.ts

@@ -0,0 +1,4 @@
+export type Message = { role: "system" | "user" | "assistant" | "tool"; content: string; tool_call_id?: string };
+export type ToolDef = { type: "function"; function: { name: string; description: string; parameters: Record<string, unknown> } };
+export type ChatResult = { content: string | null; toolCalls: { id: string; name: string; arguments: string }[] };
+export interface ModelProvider { chat(messages: Message[], tools: ToolDef[]): Promise<ChatResult>; }

package/src/tools/filesystem.ts

@@ -0,0 +1,9 @@
+import fs from "node:fs/promises"; import path from "node:path";
+const root = process.cwd();
+function safe(p:string){ const r=path.resolve(root,p); if(r!==root && !r.startsWith(root+path.sep)) throw new Error("Path escapes project root"); return r; }
+export const fsTools = [
+{name:"read_file",description:"Read a UTF-8 text file in the project.",parameters:{type:"object",properties:{path:{type:"string"}},required:["path"]}},
+{name:"write_file",description:"Write or replace a UTF-8 text file in the project.",parameters:{type:"object",properties:{path:{type:"string"},content:{type:"string"}},required:["path","content"]}},
+{name:"list_files",description:"List project files recursively, excluding common dependency/build folders.",parameters:{type:"object",properties:{path:{type:"string"}},required:[]}},
+];
+export async function runFs(name:string,args:any){ if(name==="read_file") return await fs.readFile(safe(args.path),"utf8"); if(name==="write_file"){await fs.mkdir(path.dirname(safe(args.path)),{recursive:true});await fs.writeFile(safe(args.path),args.content,"utf8");return `Wrote ${args.path}`;} if(name==="list_files"){const out:string[]=[]; async function walk(d:string){for(const e of await fs.readdir(d,{withFileTypes:true})){if(["node_modules",".git","dist","build",".next"].includes(e.name))continue;const p=path.join(d,e.name); if(e.isDirectory()) await walk(p); else out.push(path.relative(root,p));}} await walk(safe(args.path||".")); return out.slice(0,500).join("\n");} throw new Error("Unknown filesystem tool"); }

package/src/tools/registry.ts

@@ -0,0 +1,3 @@
+import {fsTools,runFs} from "./filesystem.js"; import {searchTool,searchCode} from "./search.js"; import {terminalTool,runCommand} from "./terminal.js"; import type {ToolDef} from "../providers/provider.js";
+export const definitions:ToolDef[]=[...fsTools.map(x=>({type:"function" as const,function:x})),{type:"function",function:searchTool},{type:"function",function:terminalTool}];
+export async function execute(name:string,args:any){if(["read_file","write_file","list_files"].includes(name))return runFs(name,args);if(name==="search_code")return searchCode(args.query);if(name==="run_command")return runCommand(args.command);throw new Error(`Unknown tool: ${name}`);}

package/src/tools/search.ts

@@ -0,0 +1,3 @@
+import fs from "node:fs/promises"; import path from "node:path";
+export const searchTool={name:"search_code",description:"Search text across project source files.",parameters:{type:"object",properties:{query:{type:"string"}},required:["query"]}};
+export async function searchCode(query:string){const root=process.cwd(), hits:string[]=[]; async function walk(d:string){for(const e of await fs.readdir(d,{withFileTypes:true})){if(["node_modules",".git","dist","build",".next"].includes(e.name))continue;const p=path.join(d,e.name);if(e.isDirectory()) await walk(p); else {try{const s=await fs.readFile(p,"utf8");if(s.includes(query)) hits.push(path.relative(root,p));}catch{}}}} await walk(root); return hits.slice(0,100).join("\n")||"No matches.";}

package/src/tools/terminal.ts

@@ -0,0 +1,4 @@
+import {exec} from "node:child_process"; import {promisify} from "node:util"; import readline from "node:readline/promises";
+const ex=promisify(exec); export const terminalTool={name:"run_command",description:"Run a shell command in the project. Use only for safe development commands.",parameters:{type:"object",properties:{command:{type:"string"}},required:["command"]}};
+const dangerous=/\b(del|erase|rmdir|rm|format|shutdown|reboot|diskpart|git\s+reset\s+--hard)\b/i;
+export async function runCommand(command:string){if(dangerous.test(command)){const rl=readline.createInterface({input:process.stdin,output:process.stdout});const a=await rl.question(`Approve potentially destructive command? ${command} [y/N] `);rl.close();if(a.toLowerCase()!=="y")return "Command denied by user.";} const r=await ex(command,{cwd:process.cwd(),timeout:120000,maxBuffer:5*1024*1024,shell:process.platform==="win32"?"powershell.exe":true});return (r.stdout+r.stderr).trim();}

package/tsconfig.json

@@ -0,0 +1 @@
+{"compilerOptions":{"target":"ES2022","module":"NodeNext","moduleResolution":"NodeNext","strict":true,"esModuleInterop":true,"skipLibCheck":true,"outDir":"dist","rootDir":"src"},"include":["src/**/*.ts"]}