@ilura/northstar 0.1.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Ilura Technology OÜ
+Copyright (c) 2026 Kilo Code
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# Kilo Code CLI
+
+The AI coding agent built for the terminal. Generate code from natural language, automate tasks, and run terminal commands -- powered by 500+ AI models.
+
+![Kilo CLI showing code edits in a terminal](https://raw.githubusercontent.com/Kilo-Org/kilocode/main/packages/kilo-docs/public/img/npm-package-readme/kilo-cli.png)
+
+Kilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.
+
+[Website](https://kilo.ai) · [Install](https://kilo.ai/install) · [IDE](https://kilo.ai/landing/vs-code) · [CLI](https://kilo.ai/cli) · [Docs](https://kilo.ai/docs) · [Models](https://kilo.ai/leaderboard) · [Gateway](https://kilo.ai/gateway) · [Pricing](https://kilo.ai/pricing) · [Kilo Pass](https://kilo.ai/pricing/kilo-pass)
+
+[500+ models](https://kilo.ai/leaderboard). One open source agent in [VS Code](https://kilo.ai/vscode-marketplace), [JetBrains](https://plugins.jetbrains.com/plugin/27133-kilo-code), [CLI](https://www.npmjs.com/package/@kilocode/cli), [Slack](https://kilo.ai/slack), and [Cloud](https://kilo.ai/cloud).
+
+## Install
+
+```bash
+npm install -g @kilocode/cli
+```
+
+Or run directly with npx:
+
+```bash
+npx --package @kilocode/cli kilo
+```
+
+## Getting Started
+
+Run `kilo` in any project directory to launch the interactive TUI:
+
+```bash
+kilo
+```
+
+Run a one-off task:
+
+```bash
+kilo run "add input validation to the signup form"
+```
+
+## Features
+
+- **Code generation** -- describe what you want in natural language
+- **Terminal commands** -- the agent can run shell commands on your behalf
+- **500+ AI models** -- use models from OpenAI, Anthropic, Google, and more
+- **MCP servers** -- extend agent capabilities with the Model Context Protocol
+- **Multiple modes** -- Plan with Architect, code with Coder, debug with Debugger, or create your own
+- **Sessions** -- resume previous conversations and export transcripts
+- **API keys optional** -- bring your own keys or use Kilo credits
+
+## Commands
+
+| Command               | Description                |
+| --------------------- | -------------------------- |
+| `kilo`                | Launch interactive TUI     |
+| `kilo run "<task>"`   | Run a one-off task         |
+| `kilo auth`           | Manage authentication      |
+| `kilo models`         | List available models      |
+| `kilo mcp`            | Manage MCP servers         |
+| `kilo session list`   | List sessions              |
+| `kilo session delete` | Delete a session           |
+| `kilo export`         | Export session transcripts |
+
+Run `kilo --help` for the full list.
+
+## Alternative Installation
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew install Kilo-Org/tap/kilo
+```
+
+### GitHub Releases
+
+Download pre-built binaries from the [Releases page](https://github.com/Kilo-Org/kilocode/releases).
+
+## Documentation
+
+- [Docs](https://kilo.ai/docs)
+- [Getting Started](https://kilo.ai/docs/getting-started)
+
+## Links
+
+- [GitHub](https://github.com/Kilo-Org/kilocode)
+- [Discord](https://kilo.ai/discord)
+- [VS Code Extension](https://kilo.ai/vscode-marketplace)
+- [Website](https://kilo.ai)
+
+## License
+
+MIT

package/bin/northstar

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+// kilocode_change - new file
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"]
+
+// kilocode_change start - point packaged binaries at co-located tree-sitter WASM resources
+function configureTreeSitterResources(target) {
+  const wasmDir = path.join(path.dirname(target), "tree-sitter")
+  if (!process.env.KILO_TREE_SITTER_WASM_DIR && fs.existsSync(path.join(wasmDir, "tree-sitter.wasm"))) {
+    process.env.KILO_TREE_SITTER_WASM_DIR = wasmDir
+  }
+}
+// kilocode_change end
+
+function run(target, fallback) {
+  // kilocode_change - preserve cached binary fallback
+  configureTreeSitterResources(target) // kilocode_change
+  // kilocode_change start - fall through if the cached binary cannot be spawned
+  const child = (() => {
+    try {
+      return childProcess.spawn(target, process.argv.slice(2), {
+        stdio: "inherit",
+      })
+    } catch (error) {
+      if (fallback) {
+        run(fallback)
+        return
+      }
+      console.error(error.message)
+      process.exit(1)
+    }
+  })()
+  if (!child) return
+  // kilocode_change end
+
+  const forwarders = {}
+  const clear = () => {
+    // kilocode_change - remove listeners before cached binary fallback
+    for (const signal of forwardedSignals) {
+      process.removeListener(signal, forwarders[signal])
+    }
+  }
+
+  child.on("error", (error) => {
+    clear() // kilocode_change
+    // kilocode_change start - fall through to findBinary() if cached binary fails
+    if (fallback) {
+      run(fallback)
+      return
+    }
+    // kilocode_change end
+    console.error(error.message)
+    process.exit(1)
+  })
+
+  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) => {
+    clear() // kilocode_change
+
+    if (signal) {
+      process.kill(process.pid, signal)
+      return
+    }
+
+    process.exit(typeof code === "number" ? code : 0)
+  })
+}
+
+const envPath = process.env.KILO_BIN_PATH
+
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+
+const cached = path.join(scriptDir, ".kilo")
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+let platform = platformMap[os.platform()]
+if (!platform) {
+  platform = os.platform()
+}
+let arch = archMap[os.arch()]
+if (!arch) {
+  arch = os.arch()
+}
+const base = "@ilura/northstar-" + platform + "-" + arch
+const binary = platform === "windows" ? "northstar.exe" : "northstar"
+
+function supportsAvx2() {
+  if (arch !== "x64") return false
+
+  if (platform === "linux") {
+    try {
+      return /(^|\s)avx2(\s|$)/i.test(fs.readFileSync("/proc/cpuinfo", "utf8"))
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "darwin") {
+    try {
+      const result = childProcess.spawnSync("sysctl", ["-n", "hw.optional.avx2_0"], {
+        encoding: "utf8",
+        timeout: 1500,
+      })
+      if (result.status !== 0) return false
+      return (result.stdout || "").trim() === "1"
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "windows") {
+    const cmd =
+      '(Add-Type -MemberDefinition "[DllImport(""kernel32.dll"")] public static extern bool IsProcessorFeaturePresent(int ProcessorFeature);" -Name Kernel32 -Namespace Win32 -PassThru)::IsProcessorFeaturePresent(40)'
+
+    for (const exe of ["powershell.exe", "pwsh.exe", "pwsh", "powershell"]) {
+      try {
+        const result = childProcess.spawnSync(exe, ["-NoProfile", "-NonInteractive", "-Command", cmd], {
+          encoding: "utf8",
+          timeout: 3000,
+          windowsHide: true,
+        })
+        if (result.status !== 0) continue
+        const out = (result.stdout || "").trim().toLowerCase()
+        if (out === "true" || out === "1") return true
+        if (out === "false" || out === "0") return false
+      } catch {
+        continue
+      }
+    }
+
+    return false
+  }
+
+  return false
+}
+
+const names = (() => {
+  const avx2 = supportsAvx2()
+  const baseline = arch === "x64" && !avx2
+
+  if (platform === "linux") {
+    const musl = (() => {
+      try {
+        if (fs.existsSync("/etc/alpine-release")) return true
+      } catch {
+        // ignore
+      }
+
+      try {
+        const result = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" })
+        const text = ((result.stdout || "") + (result.stderr || "")).toLowerCase()
+        if (text.includes("musl")) return true
+      } catch {
+        // ignore
+      }
+
+      return false
+    })()
+
+    if (musl) {
+      if (arch === "x64") {
+        if (baseline) return [`${base}-baseline-musl`, `${base}-musl`, `${base}-baseline`, base]
+        return [`${base}-musl`, `${base}-baseline-musl`, base, `${base}-baseline`]
+      }
+      return [`${base}-musl`, base]
+    }
+
+    if (arch === "x64") {
+      if (baseline) return [`${base}-baseline`, base, `${base}-baseline-musl`, `${base}-musl`]
+      return [base, `${base}-baseline`, `${base}-musl`, `${base}-baseline-musl`]
+    }
+    return [base, `${base}-musl`]
+  }
+
+  if (arch === "x64") {
+    if (baseline) return [`${base}-baseline`, base]
+    return [base, `${base}-baseline`]
+  }
+  return [base]
+})()
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      for (const name of names) {
+        const candidate = path.join(modules, name, "bin", binary)
+        if (fs.existsSync(candidate)) return candidate
+      }
+    }
+    const parent = path.dirname(current)
+    if (parent === current) {
+      return
+    }
+    current = parent
+  }
+}
+
+const resolved = envPath || (fs.existsSync(cached) ? cached : findBinary(scriptDir))
+if (!resolved) {
+  console.error(
+    "It seems that your package manager failed to install the right version of the Kilo CLI for your platform. You can try manually installing " +
+      names.map((n) => `\"${n}\"`).join(" or ") +
+      " package",
+  )
+  process.exit(1)
+}
+
+run(resolved, resolved === cached ? findBinary(scriptDir) : undefined) // kilocode_change - preserve cached binary fallback

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@ilura/northstar",
+  "bin": {
+    "northstar": "./bin/northstar",
+    "kilocode": "./bin/northstar"
+  },
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs"
+  },
+  "version": "0.1.0",
+  "license": "MIT",
+  "keywords": [
+    "cli",
+    "tui",
+    "terminal",
+    "ai",
+    "agent",
+    "assistant",
+    "coding-agent",
+    "kilo-code",
+    "kilo",
+    "opencode",
+    "ink",
+    "react",
+    "copilot",
+    "autocomplete",
+    "developer-tools"
+  ],
+  "private": false,
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "optionalDependencies": {
+    "@ilura/northstar-linux-x64-musl": "0.1.0",
+    "@ilura/northstar-linux-arm64-musl": "0.1.0",
+    "@ilura/northstar-darwin-arm64": "0.1.0",
+    "@ilura/northstar-linux-arm64": "0.1.0",
+    "@ilura/northstar-windows-x64": "0.1.0",
+    "@ilura/northstar-darwin-x64": "0.1.0",
+    "@ilura/northstar-linux-x64": "0.1.0",
+    "@ilura/northstar-linux-x64-baseline": "0.1.0",
+    "@ilura/northstar-windows-x64-baseline": "0.1.0",
+    "@ilura/northstar-windows-arm64": "0.1.0",
+    "@ilura/northstar-darwin-x64-baseline": "0.1.0",
+    "@ilura/northstar-linux-x64-baseline-musl": "0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrtcnbsk/northstar"
+  }
+}

package/postinstall.mjs

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+
+import childProcess from "child_process"
+import fs from "fs"
+import os from "os"
+import path from "path"
+import { createRequire } from "module"
+import { fileURLToPath } from "url"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "package.json"), "utf8"))
+
+// kilocode_change start - variant detection matching bin/kilo logic
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+const platform = platformMap[os.platform()] ?? os.platform()
+const arch = archMap[os.arch()] ?? os.arch()
+const base = `@ilura/northstar-${platform}-${arch}`
+const sourceBinary = platform === "windows" ? "northstar.exe" : "northstar"
+const targetBinary = path.join(__dirname, "bin", ".kilo")
+
+function supportsAvx2() {
+  if (arch !== "x64") return false
+
+  if (platform === "linux") {
+    try {
+      return /(^|\s)avx2(\s|$)/i.test(fs.readFileSync("/proc/cpuinfo", "utf8"))
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "darwin") {
+    try {
+      const result = childProcess.spawnSync("sysctl", ["-n", "hw.optional.avx2_0"], {
+        encoding: "utf8",
+        timeout: 1500,
+      })
+      if (result.status !== 0) return false
+      return (result.stdout || "").trim() === "1"
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "windows") {
+    const command =
+      '(Add-Type -MemberDefinition "[DllImport(""kernel32.dll"")] public static extern bool IsProcessorFeaturePresent(int ProcessorFeature);" -Name Kernel32 -Namespace Win32 -PassThru)::IsProcessorFeaturePresent(40)'
+
+    for (const executable of ["powershell.exe", "pwsh.exe", "pwsh", "powershell"]) {
+      try {
+        const result = childProcess.spawnSync(executable, ["-NoProfile", "-NonInteractive", "-Command", command], {
+          encoding: "utf8",
+          timeout: 3000,
+          windowsHide: true,
+        })
+        if (result.status !== 0) continue
+        const output = (result.stdout || "").trim().toLowerCase()
+        if (output === "true" || output === "1") return true
+        if (output === "false" || output === "0") return false
+      } catch {
+        continue
+      }
+    }
+  }
+
+  return false
+}
+
+function isMusl() {
+  if (platform !== "linux") return false
+
+  try {
+    if (fs.existsSync("/etc/alpine-release")) return true
+  } catch {
+    // Ignore filesystem probes that are blocked by the host.
+  }
+
+  try {
+    const result = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" })
+    return `${result.stdout || ""}${result.stderr || ""}`.toLowerCase().includes("musl")
+  } catch {
+    return false
+  }
+}
+
+function packageNames() {
+  const baseline = arch === "x64" && !supportsAvx2()
+
+  if (platform === "linux") {
+    if (isMusl()) {
+      if (arch === "x64")
+        return baseline
+          ? [`${base}-baseline-musl`, `${base}-musl`, `${base}-baseline`, base]
+          : [`${base}-musl`, `${base}-baseline-musl`, base, `${base}-baseline`]
+      return [`${base}-musl`, base]
+    }
+
+    if (arch === "x64")
+      return baseline
+        ? [`${base}-baseline`, base, `${base}-baseline-musl`, `${base}-musl`]
+        : [base, `${base}-baseline`, `${base}-musl`, `${base}-baseline-musl`]
+    return [base, `${base}-musl`]
+  }
+
+  if (arch === "x64") return baseline ? [`${base}-baseline`, base] : [base, `${base}-baseline`]
+  return [base]
+}
+
+function resolveBinary(name) {
+  const packageJsonPath = require.resolve(`${name}/package.json`)
+  const binaryPath = path.join(path.dirname(packageJsonPath), "bin", sourceBinary)
+  if (!fs.existsSync(binaryPath)) throw new Error(`Binary not found at ${binaryPath}`)
+  return binaryPath
+}
+// kilocode_change end
+
+// kilocode_change start - copy runtime resources next to cached binary
+function copyResources(source) {
+  for (const [name, entry] of [
+    ["tree-sitter", "tree-sitter.wasm"],
+    ["console", "index.html"],
+  ]) {
+    const dir = path.join(path.dirname(source), name)
+    if (!fs.existsSync(path.join(dir, entry))) continue
+    const target = path.join(__dirname, "bin", name)
+    fs.rmSync(target, { recursive: true, force: true })
+    fs.cpSync(dir, target, { recursive: true })
+  }
+
+  const bwrap = path.join(path.dirname(source), "bwrap")
+  if (fs.existsSync(bwrap)) {
+    const target = path.join(__dirname, "bin", "bwrap")
+    fs.copyFileSync(bwrap, target)
+    fs.chmodSync(target, 0o755)
+  }
+
+  const licenses = path.join(path.dirname(source), "licenses")
+  if (fs.existsSync(licenses)) {
+    const target = path.join(__dirname, "bin", "licenses")
+    fs.rmSync(target, { recursive: true, force: true })
+    fs.cpSync(licenses, target, { recursive: true })
+  }
+
+  const worker = path.join(path.dirname(source), "kilo-sandbox-mutation-worker.js")
+  if (fs.existsSync(worker)) fs.copyFileSync(worker, path.join(__dirname, "bin", "kilo-sandbox-mutation-worker.js"))
+}
+
+function copyBinary(source) {
+  if (!fs.existsSync(source)) throw new Error(`Binary not found at ${source}`)
+  fs.mkdirSync(path.dirname(targetBinary), { recursive: true })
+  if (fs.existsSync(targetBinary)) fs.unlinkSync(targetBinary)
+  try {
+    fs.linkSync(source, targetBinary)
+  } catch {
+    fs.copyFileSync(source, targetBinary)
+  }
+  copyResources(source)
+  fs.chmodSync(targetBinary, 0o755)
+}
+// kilocode_change end
+
+function verifyBinary() {
+  const result = childProcess.spawnSync(targetBinary, ["--version"], {
+    stdio: "ignore",
+    windowsHide: true,
+  })
+  return result.status === 0
+}
+
+function main() {
+  if (platform === "windows") {
+    console.log("Windows detected: binary setup not needed (using packaged wrapper)")
+    return
+  }
+
+  for (const name of packageNames()) {
+    try {
+      copyBinary(resolveBinary(name))
+      if (verifyBinary()) return
+    } catch {
+      const temp = fs.mkdtempSync(path.join(os.tmpdir(), "kilo-install-"))
+      try {
+        const version = packageJson.optionalDependencies?.[name]
+        if (!version) continue
+        const result = childProcess.spawnSync(
+          "npm",
+          ["install", "--ignore-scripts", "--no-save", "--loglevel=error", "--prefix", temp, `${name}@${version}`],
+          { stdio: "inherit", windowsHide: true },
+        )
+        if (result.status !== 0) continue
+        copyBinary(path.join(temp, "node_modules", name, "bin", sourceBinary))
+        if (verifyBinary()) return
+      } finally {
+        fs.rmSync(temp, { recursive: true, force: true })
+      }
+    }
+  }
+
+  throw new Error(
+    `It seems your package manager failed to install the right Kilo CLI package. Try manually installing ${packageNames()
+      .map((name) => JSON.stringify(name))
+      .join(" or ")}.`,
+  )
+}
+
+try {
+  main()
+} catch (error) {
+  console.error("Failed to setup kilo binary:", error.message)
+  process.exit(1)
+}