hordecode 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 MiMo Code, Xiaomi Corporation
+Copyright (c) 2025 opencode
+Copyright (c) 2026 Hordecode
+
+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

@@ -1,3 +1,126 @@
-# Temporary Holding Version
+<p align="center">
+  <a href="https://hordecode.com"><img src="https://raw.githubusercontent.com/siliconstencil/hordecode/main/assets/logo.svg" alt="Hordecode" width="96" height="96"></a>
+</p>
+<h1 align="center">Hordecode</h1>
+<p align="center">The AI coding agent built for the terminal.</p>
+<p align="center">
+  <a href="https://hordecode.com">Website</a> |
+  <a href="https://hordecode.com/docs/">Docs</a> |
+  <a href="https://github.com/siliconstencil/hordecode">GitHub</a>
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/hordecode"><img alt="npm" src="https://img.shields.io/npm/v/hordecode?style=flat-square" /></a>
+  <a href="https://github.com/siliconstencil/hordecode/actions/workflows/fork-typecheck.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/siliconstencil/hordecode/fork-typecheck.yml?style=flat-square&branch=main" /></a>
+  <a href="https://github.com/siliconstencil/hordecode/blob/main/LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" /></a>
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+---
+
+Hordecode is a terminal-native AI coding agent. It is a friendly fork of
+[opencode](https://github.com/anomalyco/opencode) that tracks upstream, carries a
+delta-port of [MiMo Code](https://github.com/XiaomiMiMo/MiMo-Code), and adds its own
+layer: a supervisor for long-running work, a harness pipeline, an inbox, persistent
+memory with an optional on-device embedding index, skills, workflows and cron.
+
+Every opencode provider, plugin and config file keeps working. Hordecode is not
+affiliated with or endorsed by either upstream project.
+
+---
+
+## Quick Start
+
+```bash
+# npm (all platforms)
+npm install -g hordecode
+
+# One-line install (macOS / Linux)
+curl -fsSL https://raw.githubusercontent.com/siliconstencil/hordecode/main/install | bash
+
+# Run
+horde
+```
+
+`hordecode` is an alias of `horde`; both commands are installed. On first launch, add a
+provider with `horde providers` (or `horde auth`), then start a session.
+
+Upgrade an existing install with the method it was installed with:
+
+```bash
+horde upgrade            # latest
+horde upgrade 0.1.1      # a specific version
+```
+
+> [!WARNING]
+> 0.1.x is a pre-release. APIs, config and storage may change without a migration path.
+
+<details>
+<summary><strong>Install script details</strong></summary>
+
+The script installs into `~/.hordecode/bin` and adds that directory to your shell
+profile unless you pass `--no-modify-path`.
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/siliconstencil/hordecode/main/install | bash -s -- --version 0.1.1
+curl -fsSL https://raw.githubusercontent.com/siliconstencil/hordecode/main/install | bash -s -- --no-modify-path
+./install --binary /path/to/hordecode     # install a locally built binary
+```
+
+Set `HORDECODE_RELEASE_BASE` to install from a mirror of the GitHub releases.
+
+</details>
+
+<details>
+<summary><strong>Platforms</strong></summary>
+
+| Target | npm package | Notes |
+| --- | --- | --- |
+| linux-x64 | `hordecode-linux-x64` | verified target; ships the on-device embedding index |
+| linux-x64 (no AVX2) | `hordecode-linux-x64-baseline` | |
+| linux-x64 musl | `hordecode-linux-x64-musl`, `-baseline-musl` | Alpine and other musl systems |
+| linux-arm64 | `hordecode-linux-arm64`, `-musl` | |
+| darwin-arm64 | `hordecode-darwin-arm64` | |
+| darwin-x64 | `hordecode-darwin-x64`, `-baseline` | no embedding index (no onnxruntime binding) |
+| windows-x64 | `hordecode-windows-x64`, `-baseline` | use npm; the install script needs bash |
+| windows-arm64 | `hordecode-windows-arm64` | use npm |
+
+The `hordecode` npm package selects the right platform package at install time. On
+targets without the embedding index, memory search falls back to BM25.
+
+</details>
+
+## What Hordecode adds
+
+Fork features surface as tools the agent can call, not as extra CLI commands:
+
+- **supervisor**: runs delegated work as supervised child sessions with spawn
+  references, task links and waiters, so multi-step work is tracked past one turn.
+- **task** and **workflow**: units of work, and declared multi-step workflows.
+- **memory-add / memory-recall / memory-update / memory-session / memory-status /
+  memory-dump / memory-gc**: persistent project memory. With `memory.embedding`
+  enabled (linux-x64) recall uses an on-device embedding index; otherwise BM25.
+- **skill** and **skill-search**: discover and load skills from the user and project
+  skill directories; the bundled research pipeline ships as a skill set.
+- **cron**: scheduled runs.
+- **session**: manage sessions and worktrees, including a fleet view of running agents.
+
+Behind the tools, the **inbox** carries messages between agents and sessions, and the
+**harness** pipeline drives supervised runs.
+
+The upstream tool set (read, edit, bash, grep, glob, lsp, MCP, plan, question, ...)
+and the built-in **build**, **plan** and **general** agents are unchanged. Switch
+agents with `Tab`.
+
+### Memory search: keyword by default, semantic opt-in
+
+Memory recall is keyword search (BM25) out of the box and needs no download. Semantic
+(vector) search is opt-in. Enable it in `hordecode.json`:
+
+```json
+{ "memory": { "embedding": true } }
+```
+
+On first use Hordecode downloads the embedding model once (about 133 MB) into its cache
+directory; recall stays keyword-only until the model is ready, then becomes hybrid
+(keyword + semantic). The on-device index ships in the linux-x64 package; on other targets
+the setting is accepted but recall stays keyword-only. `memory-status` reports the current
+mode and vector count, and `horde debug embedding-check` verifies the pipeline.

package/bin/horde.exe

@@ -0,0 +1,10 @@
+echo "Error: hordecode's postinstall script was not run." >&2
+echo "" >&2
+echo "This occurs when using --ignore-scripts during installation, or when using a" >&2
+echo "package manager like pnpm that does not run postinstall scripts by default." >&2
+echo "" >&2
+echo "To fix this, run the postinstall script manually:" >&2
+echo "  cd node_modules/hordecode && node postinstall.mjs" >&2
+echo "" >&2
+echo "Or reinstall hordecode without the --ignore-scripts flag." >&2
+exit 1

package/bin/hordecode.exe

@@ -0,0 +1,10 @@
+echo "Error: hordecode's postinstall script was not run." >&2
+echo "" >&2
+echo "This occurs when using --ignore-scripts during installation, or when using a" >&2
+echo "package manager like pnpm that does not run postinstall scripts by default." >&2
+echo "" >&2
+echo "To fix this, run the postinstall script manually:" >&2
+echo "  cd node_modules/hordecode && node postinstall.mjs" >&2
+echo "" >&2
+echo "Or reinstall hordecode without the --ignore-scripts flag." >&2
+exit 1

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "hordecode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Hordecode: AI coding agent for the terminal, a friendly fork of opencode with a MiMo Code delta-port",
+  "bin": {
+    "horde": "./bin/horde.exe",
+    "hordecode": "./bin/hordecode.exe"
+  },
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs"
+  },
+  "version": "0.1.1",
+  "license": "MIT",
+  "homepage": "https://hordecode.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siliconstencil/hordecode.git"
+  },
+  "bugs": {
+    "url": "https://github.com/siliconstencil/hordecode/issues"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "coding-assistant",
+    "opencode",
+    "hordecode"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "optionalDependencies": {
+    "hordecode-linux-arm64": "0.1.1",
+    "hordecode-linux-x64": "0.1.1",
+    "hordecode-linux-x64-baseline": "0.1.1",
+    "hordecode-linux-arm64-musl": "0.1.1",
+    "hordecode-linux-x64-musl": "0.1.1",
+    "hordecode-linux-x64-baseline-musl": "0.1.1",
+    "hordecode-darwin-arm64": "0.1.1",
+    "hordecode-darwin-x64": "0.1.1",
+    "hordecode-darwin-x64-baseline": "0.1.1",
+    "hordecode-windows-arm64": "0.1.1",
+    "hordecode-windows-x64": "0.1.1",
+    "hordecode-windows-x64-baseline": "0.1.1"
+  }
 }

package/postinstall.mjs

@@ -0,0 +1,221 @@
+#!/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"))
+
+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 = `hordecode-${platform}-${arch}`
+const sourceBinary = platform === "windows" ? "hordecode.exe" : "hordecode"
+const legacySourceBinary = platform === "windows" ? "opencode.exe" : "opencode"
+// The published package.json maps both commands to bin/<name>.exe on every platform
+// (upstream postinstall.mjs:29 does the same), so the npm bin links resolve to the real binary.
+const targetBinary = path.join(__dirname, "bin", "horde.exe")
+const hordecodeTargetBinary = path.join(__dirname, "bin", "hordecode.exe")
+
+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`)
+  let binaryPath = path.join(path.dirname(packageJsonPath), "bin", sourceBinary)
+  if (fs.existsSync(binaryPath)) return binaryPath
+  binaryPath = path.join(path.dirname(packageJsonPath), "bin", legacySourceBinary)
+  if (fs.existsSync(binaryPath)) return binaryPath
+  throw new Error(`Binary not found at ${binaryPath}`)
+}
+
+function installPackage(name) {
+  const version = packageJson.optionalDependencies?.[name]
+  if (!version) return
+
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), "hordecode-install-"))
+  try {
+    const result = childProcess.spawnSync(
+      "npm",
+      ["install", "--ignore-scripts", "--no-save", "--loglevel=error", "--prefix", temp, `${name}@${version}`],
+      { stdio: "inherit", windowsHide: true },
+    )
+    if (result.status !== 0) return
+    const packageDir = path.join(temp, "node_modules", name)
+    copyBinary(path.join(packageDir, "bin", sourceBinary), targetBinary)
+    copyRuntime(path.join(packageDir, "bin", sourceBinary), targetBinary)
+    return true
+  } finally {
+    fs.rmSync(temp, { recursive: true, force: true })
+  }
+}
+
+// The memory embedding index loads its onnxruntime binding and wasm assets from
+// <exe-dir>/runtime and <exe-dir>/vendor (packages/memory/src/embedding/service.ts). The
+// platform package ships them next to its binary; carry them next to the installed one.
+function copyRuntime(source, target) {
+  const from = path.dirname(source)
+  const to = path.dirname(target)
+  for (const extra of ["runtime", "vendor"]) {
+    const dir = path.join(from, extra)
+    if (!fs.existsSync(dir)) continue
+    fs.rmSync(path.join(to, extra), { recursive: true, force: true })
+    fs.cpSync(dir, path.join(to, extra), { recursive: true })
+  }
+}
+
+function copyBinary(source, target) {
+  if (!fs.existsSync(source)) throw new Error(`Binary not found at ${source}`)
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  if (fs.existsSync(target)) fs.unlinkSync(target)
+  try {
+    fs.linkSync(source, target)
+  } catch {
+    fs.copyFileSync(source, target)
+  }
+  fs.chmodSync(target, 0o755)
+}
+
+function verifyBinary() {
+  const result = childProcess.spawnSync(targetBinary, ["--version"], {
+    encoding: "utf8",
+    stdio: "ignore",
+    windowsHide: true,
+  })
+  return result.status === 0
+}
+
+function main() {
+  for (const name of packageNames()) {
+    try {
+      const src = resolveBinary(name)
+      copyBinary(src, targetBinary)
+      copyRuntime(src, targetBinary)
+      try {
+        copyBinary(src, hordecodeTargetBinary)
+      } catch {}
+      if (verifyBinary()) return
+    } catch {
+      if (installPackage(name) && verifyBinary()) {
+        try {
+          const src2 = resolveBinary(name)
+          copyBinary(src2, hordecodeTargetBinary)
+        } catch {}
+        return
+      }
+    }
+  }
+
+  throw new Error(
+    `It seems your package manager failed to install the right hordecode CLI package. Try manually installing ${packageNames()
+      .map((name) => JSON.stringify(name))
+      .join(" or ")}.`,
+  )
+}
+
+try {
+  main()
+} catch (error) {
+  console.error(error.message)
+  process.exit(1)
+}