twokey 1.0.0 → 1.0.2

package/README.md

@@ -22,6 +22,23 @@ No TTS or text injection is implemented yet.
 npm install twokey
 ```
 
+Start the tool directly:
+
+```bash
+twokey
+```
+
+Default behavior: start the native desktop app in background.
+
+Useful CLI options:
+
+```bash
+twokey --help
+twokey --cli
+twokey --once "Erklaere kurz den Unterschied zwischen X11 und Wayland"
+twokey --desktop
+```
+
 ## Minimal Usage
 
 ```ts

package/bin/twokey.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import readline from "node:readline";
+
+const VERSION = "1.0.2";
+const DEFAULT_MODEL = process.env.TWOKEY_OLLAMA_MODEL || "qwen2.5:3b";
+const DEFAULT_OLLAMA_URL = process.env.TWOKEY_OLLAMA_URL || "http://127.0.0.1:11434";
+
+const args = process.argv.slice(2);
+
+if (args.includes("--help") || args.includes("-h")) {
+  printHelp();
+  process.exit(0);
+}
+
+if (args.includes("--version") || args.includes("-v")) {
+  console.log(VERSION);
+  process.exit(0);
+}
+
+if (args.includes("--desktop")) {
+  launchDesktopApp().then((started) => {
+    if (started) {
+      console.log("TwoKey desktop app started in background.");
+      process.exit(0);
+    }
+    console.error("No native desktop binary found in PATH.");
+    console.error("Install the .deb/.AppImage release and ensure 'twokey-ai' is available in PATH.");
+    process.exit(1);
+  });
+}
+
+const onceIndex = args.findIndex((value) => value === "--once");
+if (onceIndex >= 0) {
+  const prompt = args.slice(onceIndex + 1).join(" ").trim();
+  if (!prompt) {
+    console.error("Missing prompt after --once");
+    process.exit(1);
+  }
+
+  runSinglePrompt(prompt).catch((error) => {
+    console.error(error.message || String(error));
+    process.exit(1);
+  });
+} else if (args.includes("--cli")) {
+  startRepl().catch((error) => {
+    console.error(error.message || String(error));
+    process.exit(1);
+  });
+} else {
+  launchDesktopApp().then((started) => {
+    if (started) {
+      console.log("TwoKey desktop app started in background.");
+      process.exit(0);
+    }
+
+    console.error("No native desktop binary found in PATH.");
+    console.error("Install the .deb/.AppImage release and ensure 'twokey-ai' is available in PATH.");
+    console.error("Use 'twokey --cli' to run terminal mode.");
+    process.exit(1);
+  });
+}
+
+async function runSinglePrompt(prompt) {
+  const answer = await askOllama(prompt);
+  console.log(answer);
+}
+
+async function startRepl() {
+  console.log("TwoKey CLI");
+  console.log("Type your prompt. Commands: /help, /exit");
+  console.log(`Ollama endpoint: ${DEFAULT_OLLAMA_URL}`);
+  console.log(`Model: ${DEFAULT_MODEL}`);
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: "twokey> ",
+  });
+
+  rl.prompt();
+
+  rl.on("line", async (line) => {
+    const input = line.trim();
+    if (!input) {
+      rl.prompt();
+      return;
+    }
+
+    if (input === "/exit" || input === "/quit") {
+      rl.close();
+      return;
+    }
+
+    if (input === "/help") {
+      printHelp();
+      rl.prompt();
+      return;
+    }
+
+    try {
+      const answer = await askOllama(input);
+      console.log(`\n${answer}\n`);
+    } catch (error) {
+      console.error(error.message || String(error));
+    }
+
+    rl.prompt();
+  });
+
+  rl.on("close", () => {
+    console.log("bye");
+    process.exit(0);
+  });
+}
+
+async function askOllama(prompt) {
+  const response = await fetch(`${DEFAULT_OLLAMA_URL.replace(/\/$/, "")}/api/chat`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      model: DEFAULT_MODEL,
+      stream: false,
+      messages: [
+        {
+          role: "system",
+          content: "You are TwoKey, a concise Linux assistant.",
+        },
+        {
+          role: "user",
+          content: prompt,
+        },
+      ],
+      options: {
+        temperature: 0.3,
+        num_predict: 384,
+      },
+    }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Ollama request failed with HTTP ${response.status}`);
+  }
+
+  const payload = await response.json();
+  const content = payload?.message?.content?.trim();
+  if (!content) {
+    throw new Error("Ollama returned an empty response");
+  }
+
+  return content;
+}
+
+async function launchDesktopApp() {
+  const candidates = [];
+  if (process.env.TWOKEY_DESKTOP_CMD) {
+    candidates.push(process.env.TWOKEY_DESKTOP_CMD);
+  }
+  candidates.push("twokey-ai", "twokey-desktop");
+
+  for (const command of candidates) {
+    const started = await spawnDetached(command);
+    if (started) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+function spawnDetached(command) {
+  return new Promise((resolve) => {
+    const child = spawn(command, [], {
+      detached: true,
+      stdio: "ignore",
+      shell: false,
+    });
+
+    child.once("spawn", () => {
+      child.unref();
+      resolve(true);
+    });
+
+    child.once("error", () => {
+      resolve(false);
+    });
+  });
+}
+
+function printHelp() {
+  console.log("twokey <command/options>");
+  console.log("");
+  console.log("Options:");
+  console.log("  --help, -h       Show help");
+  console.log("  --version, -v    Show version");
+  console.log("  --cli            Start interactive terminal mode");
+  console.log("  --once <prompt>  Send one prompt to Ollama and print response");
+  console.log("  --desktop        Start native desktop app in background");
+  console.log("");
+  console.log("Without options, twokey starts the native desktop app in background.");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twokey",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Linux-first desktop AI assistant built with Tauri, React, and TypeScript.",
   "license": "MIT",
   "repository": {
@@ -15,6 +15,9 @@
   "main": "./lib/index.js",
   "module": "./lib/index.js",
   "types": "./lib/index.d.ts",
+  "bin": {
+    "twokey": "./bin/twokey.js"
+  },
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
@@ -23,6 +26,7 @@
     }
   },
   "files": [
+    "bin",
     "lib",
     "README.md",
     "LICENSE"