@knightcodeai/cli 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# @knightcodeai/cli
+
+`knightcode` — a local-first, bring-your-own-key AI coding CLI for your terminal.
+
+## Install
+
+```bash
+npm install -g @knightcodeai/cli
+```
+
+You don't need Bun — it's bundled into the platform binary. The small launcher
+(`bin/knightcode`) that spawns it runs on Node.js (>=18), which you already have
+if you installed with npm. The right platform binary installs automatically as
+an optional dependency.
+
+## Quick start
+
+```bash
+knightcode
+```
+
+On first run, set your OpenRouter API key from inside the app.
+
+## Configuration
+
+State lives in `~/.knightcode/` (sessions, settings, local SQLite database).
+
+| Command / env var | Effect |
+| ----------------- | ------ |
+| `knightcode --version` | Print the installed version |
+| `knightcode doctor` | Print diagnostics (config, database, API key, runtime) |
+| `KNIGHTCODE_NO_UPDATE_CHECK=1` | Disable the background update check |
+
+## Supported platforms
+
+Linux (x64, arm64), macOS (x64, arm64), Windows (x64).

package/bin/knightcode

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+// Dependency-free launcher: resolves the platform-specific compiled binary
+// (shipped as an optional dependency) and spawns it, forwarding args, stdio,
+// signals, and the exit code. Uses only Node builtins.
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"];
+
+function run(target) {
+  const child = spawn(target, process.argv.slice(2), {
+    stdio: "inherit",
+  });
+
+  child.on("error", (error) => {
+    console.error(error.message);
+    process.exit(1);
+  });
+
+  const forwarders = {};
+  for (const signal of forwardedSignals) {
+    forwarders[signal] = () => {
+      try {
+        child.kill(signal);
+      } catch {
+        // The child may have already exited.
+      }
+    };
+    process.on(signal, forwarders[signal]);
+  }
+
+  child.on("exit", (code, signal) => {
+    for (const s of forwardedSignals) process.removeListener(s, forwarders[s]);
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(typeof code === "number" ? code : 0);
+  });
+}
+
+const pkg = `@knightcodeai/cli-${process.platform}-${process.arch}`;
+const binary = process.platform === "win32" ? "knightcode.exe" : "knightcode";
+
+let target = process.env.KNIGHTCODE_BIN_PATH;
+if (!target) {
+  try {
+    target = require.resolve(`${pkg}/bin/${binary}`);
+  } catch {
+    console.error(
+      `knightcode: no prebuilt binary for ${process.platform}-${process.arch}.\n` +
+        `Your package manager may have skipped the optional dependency "${pkg}".\n` +
+        `Reinstall the CLI with your package manager (npm, yarn, pnpm, or bun), ` +
+        `or set KNIGHTCODE_BIN_PATH to a local knightcode binary.`,
+    );
+    process.exit(1);
+  }
+}
+
+run(target);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@knightcodeai/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "knightcode": "./bin/knightcode"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@knightcodeai/cli-linux-x64": "0.1.0",
+    "@knightcodeai/cli-linux-arm64": "0.1.0",
+    "@knightcodeai/cli-darwin-x64": "0.1.0",
+    "@knightcodeai/cli-darwin-arm64": "0.1.0",
+    "@knightcodeai/cli-win32-x64": "0.1.0"
+  },
+  "scripts": {
+    "dev": "bun run --watch src/index.tsx",
+    "check-types": "tsc --noEmit",
+    "test": "bun test src/**/*.test.ts"
+  },
+  "devDependencies": {
+    "@ai-sdk/provider-utils": "^4.0.27",
+    "@ai-sdk/react": "^3.0.193",
+    "@repo/shared": "workspace:*",
+    "@openrouter/ai-sdk-provider": "^2.9.0",
+    "@opentui/core": "^0.2.10",
+    "@opentui/react": "^0.2.10",
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "workspace:*",
+    "@types/bun": "latest",
+    "@types/html-to-text": "^9.0.4",
+    "@types/react": "^19.2.6",
+    "ai": "^6.0.191",
+    "date-fns": "^4.3.0",
+    "drizzle-kit": "^0.31.10",
+    "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.12",
+    "html-to-text": "^10.0.0",
+    "open": "^11.0.0",
+    "opentui-spinner": "^0.0.6",
+    "pretty-ms": "^9.3.0",
+    "react": "^19.2.6",
+    "react-router": "7.14.2",
+    "safe-regex": "^2.1.1",
+    "typescript": "^5",
+    "zod": "^4.3.6"
+  }
+}