@heyamiko/amiko-cli 0.4.11 → 0.4.12

package/dist/cli.js

@@ -15,6 +15,11 @@ function parseArgs(argv) {
             case "--headless":
                 overrides.headless = true;
                 break;
+            case "--message":
+            case "-m":
+                overrides.message = argv[i + 1];
+                i += 1;
+                break;
             case "--workspace":
             case "-w":
                 overrides.workspacePath = argv[i + 1];
@@ -80,9 +85,9 @@ async function main() {
     const persisted = await loadConfigFile(workspace.root);
     const mergedConfig = { ...finalConfig, ...persisted, ...overrides };
     const sessionFile = await createSessionFile(workspace.sessionsDir, finalConfig.sessionId);
-    // Auto-detect non-TTY or explicit --headless flag
-    if (overrides.headless || !process.stdout.isTTY) {
-        await runHeadless(mergedConfig, workspace, sessionFile.path);
+    // Auto-detect non-TTY, --headless flag, or -m single-shot
+    if (overrides.headless || overrides.message || !process.stdout.isTTY) {
+        await runHeadless(mergedConfig, workspace, sessionFile.path, overrides.message);
         return;
     }
     render(_jsx(App, { config: mergedConfig, workspace: workspace, sessionPath: sessionFile.path }));

package/dist/headless.js

@@ -7,7 +7,7 @@ import { createPiAgent } from "./agent/piAgent.js";
 import { qmdSearch, qmdGet, qmdCollectionAdd, qmdEmbed } from "./memory/qmd.js";
 import { saveConfigFile } from "./configFile.js";
 import { getModels, getProviders } from "@mariozechner/pi-ai";
-export async function runHeadless(config, workspace, sessionPath) {
+export async function runHeadless(config, workspace, sessionPath, singleMessage) {
     const agent = await createPiAgent(config);
     let currentModel = config.model
         ?? (config.modelProvider && config.modelId ? `${config.modelProvider}/${config.modelId}` : "auto");
@@ -33,6 +33,13 @@ export async function runHeadless(config, workspace, sessionPath) {
             }
         });
     }
+    // Single-shot mode: process one message and exit
+    if (singleMessage) {
+        const response = await processMessage(singleMessage, { config, workspace, sessionPath, agent, currentModel });
+        if (response !== undefined)
+            process.stdout.write(response.endsWith("\n") ? response : response + "\n");
+        process.exit(0);
+    }
     console.log(`amiko-cli (headless) | model: ${currentModel} | workspace: ${workspace.root}`);
     console.log("Type a message or /command. Press Ctrl+D to exit.");
     const rl = createInterface({
@@ -57,57 +64,59 @@ export async function runHeadless(config, workspace, sessionPath) {
             rl.prompt();
             continue;
         }
-        console.log(`[user] ${trimmed}`);
-        await appendSession(sessionPath, "user", trimmed);
-        const workspaceData = await readWorkspaceFiles(workspace);
-        let hits = [];
-        if (config.qmdEnabled) {
-            hits = await qmdSearch({
-                qmdBin: config.qmdBin,
-                query: trimmed,
-                limit: config.qmdLimit,
-                collection: config.qmdCollection,
-            });
-        }
-        if (config.qmdFull && hits.length > 0) {
-            const expanded = [];
-            for (const hit of hits) {
-                const docId = hit.path || hit.id;
-                if (!docId) {
-                    expanded.push(hit);
-                    continue;
-                }
-                const text = await qmdGet({ qmdBin: config.qmdBin, docId, full: true });
-                expanded.push({ ...hit, snippet: text || hit.snippet });
-            }
-            hits = expanded;
+        const response = await processMessage(trimmed, { config, workspace, sessionPath, agent, currentModel });
+        if (response) {
+            process.stdout.write(response.endsWith("\n") ? response : response + "\n");
         }
-        const prompt = buildPrompt({
-            identity: workspaceData.identity,
-            personality: workspaceData.personality,
-            memory: workspaceData.memory,
-            hits,
+        rl.prompt();
+    }
+    process.exit(0);
+}
+async function processMessage(message, ctx) {
+    await appendSession(ctx.sessionPath, "user", message);
+    const workspaceData = await readWorkspaceFiles(ctx.workspace);
+    let hits = [];
+    if (ctx.config.qmdEnabled) {
+        hits = await qmdSearch({
+            qmdBin: ctx.config.qmdBin,
+            query: message,
+            limit: ctx.config.qmdLimit,
+            collection: ctx.config.qmdCollection,
         });
-        let assistantText = "";
-        try {
-            for await (const chunk of agent.streamReply({ prompt, userMessage: trimmed })) {
-                process.stdout.write(chunk);
-                assistantText += chunk;
+    }
+    if (ctx.config.qmdFull && hits.length > 0) {
+        const expanded = [];
+        for (const hit of hits) {
+            const docId = hit.path || hit.id;
+            if (!docId) {
+                expanded.push(hit);
+                continue;
             }
+            const text = await qmdGet({ qmdBin: ctx.config.qmdBin, docId, full: true });
+            expanded.push({ ...hit, snippet: text || hit.snippet });
         }
-        catch (error) {
-            const message = error.message || "unknown error";
-            assistantText += `\n[error] ${message}\n`;
-            console.error(`[error] ${message}`);
-        }
-        if (!assistantText.endsWith("\n"))
-            process.stdout.write("\n");
-        if (assistantText) {
-            await appendSession(sessionPath, "assistant", assistantText);
+        hits = expanded;
+    }
+    const prompt = buildPrompt({
+        identity: workspaceData.identity,
+        personality: workspaceData.personality,
+        memory: workspaceData.memory,
+        hits,
+    });
+    let assistantText = "";
+    try {
+        for await (const chunk of ctx.agent.streamReply({ prompt, userMessage: message })) {
+            assistantText += chunk;
         }
-        rl.prompt();
     }
-    process.exit(0);
+    catch (error) {
+        const msg = error.message || "unknown error";
+        assistantText += `\n[error] ${msg}\n`;
+    }
+    if (assistantText) {
+        await appendSession(ctx.sessionPath, "assistant", assistantText);
+    }
+    return assistantText;
 }
 async function handleCommand(name, args, ctx) {
     switch (name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "type": "module",
   "bin": {
     "amiko": "dist/cli.js"

package/src/cli.tsx

@@ -21,6 +21,7 @@ type ArgOverrides = Partial<{
   modelId?: string;
   thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
   headless?: boolean;
+  message?: string;
 }>;
 
 function parseArgs(argv: string[]): ArgOverrides {
@@ -31,6 +32,11 @@ function parseArgs(argv: string[]): ArgOverrides {
       case "--headless":
         overrides.headless = true;
         break;
+      case "--message":
+      case "-m":
+        overrides.message = argv[i + 1];
+        i += 1;
+        break;
       case "--workspace":
       case "-w":
         overrides.workspacePath = argv[i + 1];
@@ -99,9 +105,9 @@ async function main() {
   const mergedConfig = { ...finalConfig, ...persisted, ...overrides };
   const sessionFile = await createSessionFile(workspace.sessionsDir, finalConfig.sessionId);
 
-  // Auto-detect non-TTY or explicit --headless flag
-  if (overrides.headless || !process.stdout.isTTY) {
-    await runHeadless(mergedConfig, workspace, sessionFile.path);
+  // Auto-detect non-TTY, --headless flag, or -m single-shot
+  if (overrides.headless || overrides.message || !process.stdout.isTTY) {
+    await runHeadless(mergedConfig, workspace, sessionFile.path, overrides.message);
     return;
   }
 

package/src/headless.ts

@@ -13,6 +13,7 @@ export async function runHeadless(
   config: AppConfig,
   workspace: WorkspaceFiles,
   sessionPath: string,
+  singleMessage?: string,
 ) {
   const agent = await createPiAgent(config);
   let currentModel = config.model
@@ -40,6 +41,13 @@ export async function runHeadless(
     });
   }
 
+  // Single-shot mode: process one message and exit
+  if (singleMessage) {
+    const response = await processMessage(singleMessage, { config, workspace, sessionPath, agent, currentModel });
+    if (response !== undefined) process.stdout.write(response.endsWith("\n") ? response : response + "\n");
+    process.exit(0);
+  }
+
   console.log(`amiko-cli (headless) | model: ${currentModel} | workspace: ${workspace.root}`);
   console.log("Type a message or /command. Press Ctrl+D to exit.");
 
@@ -69,61 +77,74 @@ export async function runHeadless(
       continue;
     }
 
-    console.log(`[user] ${trimmed}`);
-    await appendSession(sessionPath, "user", trimmed);
-
-    const workspaceData = await readWorkspaceFiles(workspace);
-
-    let hits: MemoryHit[] = [];
-    if (config.qmdEnabled) {
-      hits = await qmdSearch({
-        qmdBin: config.qmdBin,
-        query: trimmed,
-        limit: config.qmdLimit,
-        collection: config.qmdCollection,
-      });
+    const response = await processMessage(trimmed, { config, workspace, sessionPath, agent, currentModel });
+    if (response) {
+      process.stdout.write(response.endsWith("\n") ? response : response + "\n");
     }
 
-    if (config.qmdFull && hits.length > 0) {
-      const expanded: MemoryHit[] = [];
-      for (const hit of hits) {
-        const docId = hit.path || hit.id;
-        if (!docId) { expanded.push(hit); continue; }
-        const text = await qmdGet({ qmdBin: config.qmdBin, docId, full: true });
-        expanded.push({ ...hit, snippet: text || hit.snippet });
-      }
-      hits = expanded;
-    }
+    rl.prompt();
+  }
+
+  process.exit(0);
+}
 
-    const prompt = buildPrompt({
-      identity: workspaceData.identity,
-      personality: workspaceData.personality,
-      memory: workspaceData.memory,
-      hits,
+async function processMessage(
+  message: string,
+  ctx: {
+    config: AppConfig;
+    workspace: WorkspaceFiles;
+    sessionPath: string;
+    agent: any;
+    currentModel: string;
+  },
+): Promise<string> {
+  await appendSession(ctx.sessionPath, "user", message);
+
+  const workspaceData = await readWorkspaceFiles(ctx.workspace);
+
+  let hits: MemoryHit[] = [];
+  if (ctx.config.qmdEnabled) {
+    hits = await qmdSearch({
+      qmdBin: ctx.config.qmdBin,
+      query: message,
+      limit: ctx.config.qmdLimit,
+      collection: ctx.config.qmdCollection,
     });
+  }
 
-    let assistantText = "";
-    try {
-      for await (const chunk of agent.streamReply({ prompt, userMessage: trimmed })) {
-        process.stdout.write(chunk);
-        assistantText += chunk;
-      }
-    } catch (error) {
-      const message = (error as Error).message || "unknown error";
-      assistantText += `\n[error] ${message}\n`;
-      console.error(`[error] ${message}`);
+  if (ctx.config.qmdFull && hits.length > 0) {
+    const expanded: MemoryHit[] = [];
+    for (const hit of hits) {
+      const docId = hit.path || hit.id;
+      if (!docId) { expanded.push(hit); continue; }
+      const text = await qmdGet({ qmdBin: ctx.config.qmdBin, docId, full: true });
+      expanded.push({ ...hit, snippet: text || hit.snippet });
     }
+    hits = expanded;
+  }
 
-    if (!assistantText.endsWith("\n")) process.stdout.write("\n");
+  const prompt = buildPrompt({
+    identity: workspaceData.identity,
+    personality: workspaceData.personality,
+    memory: workspaceData.memory,
+    hits,
+  });
 
-    if (assistantText) {
-      await appendSession(sessionPath, "assistant", assistantText);
+  let assistantText = "";
+  try {
+    for await (const chunk of ctx.agent.streamReply({ prompt, userMessage: message })) {
+      assistantText += chunk;
     }
+  } catch (error) {
+    const msg = (error as Error).message || "unknown error";
+    assistantText += `\n[error] ${msg}\n`;
+  }
 
-    rl.prompt();
+  if (assistantText) {
+    await appendSession(ctx.sessionPath, "assistant", assistantText);
   }
 
-  process.exit(0);
+  return assistantText;
 }
 
 async function handleCommand(