twokey 1.0.0 → 1.0.3

package/README.md

@@ -22,6 +22,24 @@ 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.
+If no desktop binary is installed yet, `twokey` attempts to download an AppImage from the latest GitHub release into `~/.local/share/twokey/bin/` and starts it.
+
+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,273 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import readline from "node:readline";
+
+const VERSION = "1.0.3";
+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 LATEST_RELEASE_API = "https://api.github.com/repos/meinzeug/twokey/releases/latest";
+const APPIMAGE_DIR = path.join(os.homedir(), ".local", "share", "twokey", "bin");
+const APPIMAGE_PATH = path.join(APPIMAGE_DIR, "twokey-ai.AppImage");
+
+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("Could not start desktop app.");
+    console.error("Tried system binaries and auto-download from GitHub Releases.");
+    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", APPIMAGE_PATH);
+
+  for (const command of candidates) {
+    const started = await spawnDetached(command);
+    if (started) {
+      return true;
+    }
+  }
+
+  try {
+    const downloaded = await ensureLocalAppImage();
+    if (downloaded) {
+      return spawnDetached(APPIMAGE_PATH);
+    }
+  } catch {
+    return false;
+  }
+
+  return false;
+}
+
+async function ensureLocalAppImage() {
+  try {
+    await fs.promises.access(APPIMAGE_PATH, fs.constants.X_OK);
+    return true;
+  } catch {
+    // Not installed yet.
+  }
+
+  await fs.promises.mkdir(APPIMAGE_DIR, { recursive: true });
+  const assetUrl = await resolveLatestAppImageUrl();
+  if (!assetUrl) {
+    return false;
+  }
+
+  const response = await fetch(assetUrl, {
+    headers: {
+      "User-Agent": "twokey-cli",
+      Accept: "application/octet-stream",
+    },
+  });
+
+  if (!response.ok) {
+    return false;
+  }
+
+  const data = Buffer.from(await response.arrayBuffer());
+  await fs.promises.writeFile(APPIMAGE_PATH, data, { mode: 0o755 });
+
+  await fs.promises.chmod(APPIMAGE_PATH, 0o755);
+  return true;
+}
+
+async function resolveLatestAppImageUrl() {
+  const response = await fetch(LATEST_RELEASE_API, {
+    headers: {
+      "User-Agent": "twokey-cli",
+      Accept: "application/vnd.github+json",
+    },
+  });
+
+  if (!response.ok) {
+    return null;
+  }
+
+  const payload = await response.json();
+  const assets = Array.isArray(payload.assets) ? payload.assets : [];
+  const appImage = assets.find(
+    (asset) => typeof asset?.name === "string" && asset.name.endsWith(".AppImage") && asset.name.includes("amd64"),
+  ) || assets.find((asset) => typeof asset?.name === "string" && asset.name.endsWith(".AppImage"));
+
+  return appImage?.browser_download_url ?? null;
+}
+
+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.");
+  console.log("If no desktop binary is installed, twokey tries to download an AppImage from latest GitHub release.");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twokey",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "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"