@thesolaceproject/emberharmony 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sydney Renee
+
+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,149 @@
+<p align="center">
+  <a href="https://solace.ofharmony.ai">
+    <picture>
+      <source srcset="packages/console/app/src/asset/logo-ornate-dark.svg" media="(prefers-color-scheme: dark)">
+      <source srcset="packages/console/app/src/asset/logo-ornate-light.svg" media="(prefers-color-scheme: light)">
+      <img src="packages/console/app/src/asset/logo-ornate-light.svg" alt="EmberHarmony logo">
+    </picture>
+  </a>
+</p>
+<p align="center">The open source AI coding agent.</p>
+<p align="center">
+  <a href="https://discord.gg/EdF8f7JR"><img alt="Discord" src="https://img.shields.io/discord/1391832426048651334?style=flat-square&label=discord" /></a>
+  <a href="https://www.npmjs.com/package/@thesolaceproject/emberharmony"><img alt="npm" src="https://img.shields.io/npm/v/%40thesolaceproject%2Femberharmony?style=flat-square" /></a>
+  <a href="https://github.com/SolaceHarmony/emberharmony/actions/workflows/publish.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/SolaceHarmony/emberharmony/publish.yml?style=flat-square&branch=dev" /></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.zh.md">简体中文</a> |
+  <a href="README.zht.md">繁體中文</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.it.md">Italiano</a> |
+  <a href="README.da.md">Dansk</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.pl.md">Polski</a> |
+  <a href="README.ru.md">Русский</a> |
+  <a href="README.ar.md">العربية</a> |
+  <a href="README.no.md">Norsk</a> |
+  <a href="README.br.md">Português (Brasil)</a> |
+  <a href="README.th.md">ไทย</a>
+</p>
+
+[![EmberHarmony Terminal UI](packages/web/src/assets/lander/screenshot.png)](https://solace.ofharmony.ai)
+
+---
+
+### Installation
+
+```bash
+# YOLO
+curl -fsSL https://raw.githubusercontent.com/SolaceHarmony/emberharmony/dev/install | bash
+
+# Package managers
+npm i -g @thesolaceproject/emberharmony@latest        # or bun/pnpm/yarn
+scoop install emberharmony             # Windows
+choco install emberharmony             # Windows
+paru -S emberharmony-bin               # Arch Linux
+mise use -g emberharmony               # Any OS
+nix run nixpkgs#emberharmony           # or github:SolaceHarmony/emberharmony for latest dev branch
+```
+
+> [!TIP]
+> Remove versions older than 0.1.x before installing.
+
+#### Local Build + Install (No CI)
+
+```bash
+bun install
+npm run pack:local
+# prints a .tgz path you can install, e.g.
+# npm i -g /absolute/path/to/emberharmony-1.0.0.tgz
+```
+
+### Desktop App (BETA)
+
+EmberHarmony is also available as a desktop application. Download directly from the [releases page](https://github.com/SolaceHarmony/emberharmony/releases) or [solace.ofharmony.ai/download](https://github.com/SolaceHarmony/emberharmony/releases).
+
+| Platform              | Download                                  |
+| --------------------- | ----------------------------------------- |
+| macOS (Apple Silicon) | `emberharmony-desktop-darwin-aarch64.dmg` |
+| macOS (Intel)         | `emberharmony-desktop-darwin-x64.dmg`     |
+| Windows               | `emberharmony-desktop-windows-x64.exe`    |
+| Linux                 | `.deb`, `.rpm`, or AppImage               |
+
+```bash
+# Windows (Scoop)
+scoop bucket add extras; scoop install extras@thesolaceproject/emberharmony-desktop
+```
+
+#### Installation Directory
+
+The install script respects the following priority order for the installation path:
+
+1. `$EMBERHARMONY_INSTALL_DIR` - Custom installation directory (preferred)
+2. `$EMBERHARMONY_INSTALL_DIR` - Backward compat
+3. `$XDG_BIN_DIR` - XDG Base Directory Specification compliant path
+4. `$HOME/bin` - Standard user binary directory (if exists or can be created)
+5. `$HOME/.emberharmony/bin` - Default fallback
+
+```bash
+# Examples
+EMBERHARMONY_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/SolaceHarmony/emberharmony/dev/install | bash
+XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://raw.githubusercontent.com/SolaceHarmony/emberharmony/dev/install | bash
+```
+
+### Agents
+
+EmberHarmony includes two built-in agents you can switch between with the `Tab` key.
+
+- **build** - Default, full access agent for development work
+- **plan** - Read-only agent for analysis and code exploration
+  - Denies file edits by default
+  - Asks permission before running bash commands
+  - Ideal for exploring unfamiliar codebases or planning changes
+
+Also, included is a **general** subagent for complex searches and multistep tasks.
+This is used internally and can be invoked using `@general` in messages.
+
+Learn more about [agents](https://solace.ofharmony.ai/docs/agents).
+
+### Documentation
+
+For more info on how to configure EmberHarmony [**head over to our docs**](https://solace.ofharmony.ai/docs).
+
+### Contributing
+
+If you're interested in contributing to EmberHarmony, please read our [contributing docs](./CONTRIBUTING.md) before submitting a pull request.
+
+### Building on EmberHarmony
+
+If you are working on a project that's related to EmberHarmony and is using "emberharmony" or "emberharmony" as a part of its name, please add a note in your README to clarify that it is not built by The Solace Project and is not affiliated with us in any way.
+
+### FAQ
+
+#### How is this different from Claude Code?
+
+It's very similar to Claude Code in terms of capability. Here are the key differences:
+
+- 100% open source
+- Not coupled to any provider. EmberHarmony can be used with Claude, OpenAI, Google, or even local models. As models evolve the gaps between them will close and pricing will drop, so being provider-agnostic is important.
+- Out of the box LSP support
+- A focus on TUI — we are going to push the limits of what's possible in the terminal.
+- A client/server architecture. This for example can allow EmberHarmony to run on your computer, while you can drive it remotely from a mobile app. The TUI frontend is just one of the possible clients.
+
+### Acknowledgments
+
+EmberHarmony is a fork of [EmberHarmony](https://github.com/sst/emberharmony) by the [SST](https://sst.dev) team. We are deeply grateful for their foundational work in building an exceptional open source AI coding agent. This project would not exist without their vision and engineering.
+
+### Maintainer
+
+**Sydney Renee** — sydney@solace.ofharmony.ai
+[The Solace Project](https://solace.ofharmony.ai)
+
+---
+
+**Join our community** [Discord](https://discord.gg/EdF8f7JR) | [GitHub Discussions](https://github.com/SolaceHarmony/emberharmony/discussions)

package/bin/emberharmony

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+function run(target) {
+  const result = childProcess.spawnSync(target, process.argv.slice(2), {
+    stdio: "inherit",
+  })
+  if (result.error) {
+    console.error(result.error.message)
+    process.exit(1)
+  }
+  const code = typeof result.status === "number" ? result.status : 0
+  process.exit(code)
+}
+
+const envPath = process.env.EMBERHARMONY_BIN_PATH
+if (envPath) {
+  run(envPath)
+}
+
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+const pkgDir = path.join(scriptDir, "..")
+
+function readPackageName() {
+  try {
+    const pkgPath = path.join(scriptDir, "..", "package.json")
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"))
+    const name = typeof pkg.name === "string" ? pkg.name : "emberharmony"
+    return name.includes("/") ? name.split("/").pop() : name
+  } catch {
+    return "emberharmony"
+  }
+}
+
+function readCpuInfo() {
+  const path = "/proc/cpuinfo"
+  if (!fs.existsSync(path)) return ""
+  return fs.readFileSync(path, "utf8")
+}
+
+function hasAvx2() {
+  const info = readCpuInfo()
+  if (!info) return true
+  return info.includes("avx2")
+}
+
+function isMusl(arch) {
+  const checks = []
+  if (arch === "x64") checks.push("/lib/ld-musl-x86_64.so.1")
+  if (arch === "arm64") checks.push("/lib/ld-musl-aarch64.so.1")
+  if (arch === "arm") checks.push("/lib/ld-musl-arm.so.1")
+  checks.push("/lib/ld-musl.so.1")
+  return checks.some((item) => fs.existsSync(item))
+}
+
+function localCandidates(platform, arch) {
+  const list = []
+  const base = platform + "-" + arch
+  if (platform !== "linux") {
+    list.push(base)
+    list.push(base + "-baseline")
+    return list
+  }
+  const musl = isMusl(arch)
+  const baseline = arch === "x64" && !hasAvx2()
+  const suffix = (baseline ? "-baseline" : "") + (musl ? "-musl" : "")
+  list.push(base + suffix)
+  if (musl) {
+    list.push(base + (baseline ? "-baseline" : ""))
+  }
+  if (baseline) {
+    if (musl) list.push(base + "-musl")
+    list.push(base)
+  }
+  if (!baseline && !musl) {
+    list.push(base + "-baseline")
+  }
+  return Array.from(new Set(list))
+}
+
+function findLocalBinary(startDir, platform, arch, binaryName) {
+  const binDir = path.join(startDir, "bin")
+  if (!fs.existsSync(binDir)) {
+    return
+  }
+  const variants = localCandidates(platform, arch)
+  for (const variant of variants) {
+    const candidate = path.join(binDir, variant, binaryName)
+    if (fs.existsSync(candidate)) {
+      return candidate
+    }
+  }
+}
+
+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 = readPackageName() + "-" + platform + "-" + arch
+const binary = platform === "windows" ? "emberharmony.exe" : "emberharmony"
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      const entries = fs.readdirSync(modules)
+      for (const entry of entries) {
+        if (!entry.startsWith(base)) {
+          continue
+        }
+        const candidate = path.join(modules, entry, "bin", binary)
+        if (fs.existsSync(candidate)) {
+          return candidate
+        }
+      }
+    }
+    const parent = path.dirname(current)
+    if (parent === current) {
+      return
+    }
+    current = parent
+  }
+}
+
+const local = findLocalBinary(pkgDir, platform, arch, binary)
+if (local) {
+  run(local)
+}
+
+const resolved = findBinary(pkgDir)
+if (!resolved) {
+  console.error(
+    'It seems that your package manager failed to install the right version of the EmberHarmony CLI for your platform. You can try manually installing the "' +
+      base +
+      '" package',
+  )
+  process.exit(1)
+}
+
+run(resolved)

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@thesolaceproject/emberharmony",
+  "description": "EmberHarmony — the open source AI coding agent",
+  "homepage": "https://solace.ofharmony.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SolaceHarmony/emberharmony"
+  },
+  "bugs": {
+    "url": "https://github.com/SolaceHarmony/emberharmony/issues"
+  },
+  "license": "MIT",
+  "bin": {
+    "emberharmony": "bin/emberharmony"
+  },
+  "scripts": {
+    "postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
+  },
+  "version": "1.2.1",
+  "optionalDependencies": {
+    "@thesolaceproject/emberharmony-windows-x64": "1.2.1",
+    "@thesolaceproject/emberharmony-darwin-x64": "1.2.1",
+    "@thesolaceproject/emberharmony-darwin-x64-baseline": "1.2.1",
+    "@thesolaceproject/emberharmony-windows-x64-baseline": "1.2.1",
+    "@thesolaceproject/emberharmony-linux-arm64-musl": "1.2.1",
+    "@thesolaceproject/emberharmony-linux-x64-baseline": "1.2.1",
+    "@thesolaceproject/emberharmony-darwin-arm64": "1.2.1",
+    "@thesolaceproject/emberharmony-linux-arm64": "1.2.1",
+    "@thesolaceproject/emberharmony-linux-x64-musl": "1.2.1",
+    "@thesolaceproject/emberharmony-linux-x64-baseline-musl": "1.2.1",
+    "@thesolaceproject/emberharmony-linux-x64": "1.2.1"
+  },
+  "files": [
+    "bin/**",
+    "postinstall.mjs",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/postinstall.mjs

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+import fs from "fs"
+import path from "path"
+import os from "os"
+import { fileURLToPath } from "url"
+import { createRequire } from "module"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+
+function readPackageName() {
+  try {
+    const pkgPath = path.join(__dirname, "package.json")
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"))
+    const name = typeof pkg.name === "string" ? pkg.name : "emberharmony"
+    return name.includes("/") ? name.split("/").pop() : name
+  } catch {
+    return "emberharmony"
+  }
+}
+
+function detectPlatformAndArch() {
+  // Map platform names
+  let platform
+  switch (os.platform()) {
+    case "darwin":
+      platform = "darwin"
+      break
+    case "linux":
+      platform = "linux"
+      break
+    case "win32":
+      platform = "windows"
+      break
+    default:
+      platform = os.platform()
+      break
+  }
+
+  // Map architecture names
+  let arch
+  switch (os.arch()) {
+    case "x64":
+      arch = "x64"
+      break
+    case "arm64":
+      arch = "arm64"
+      break
+    case "arm":
+      arch = "arm"
+      break
+    default:
+      arch = os.arch()
+      break
+  }
+
+  return { platform, arch }
+}
+
+function findBinary() {
+  const { platform, arch } = detectPlatformAndArch()
+  const base = readPackageName()
+  const packageName = `${base}-${platform}-${arch}`
+  const binaryName = platform === "windows" ? "emberharmony.exe" : "emberharmony"
+
+  try {
+    // Use require.resolve to find the package
+    const packageJsonPath = require.resolve(`${packageName}/package.json`)
+    const packageDir = path.dirname(packageJsonPath)
+    const binaryPath = path.join(packageDir, "bin", binaryName)
+
+    if (!fs.existsSync(binaryPath)) {
+      throw new Error(`Binary not found at ${binaryPath}`)
+    }
+
+    return { binaryPath, binaryName }
+  } catch (error) {
+    throw new Error(`Could not find package ${packageName}: ${error.message}`)
+  }
+}
+
+function prepareBinDirectory(binaryName) {
+  const binDir = path.join(__dirname, "bin")
+  const targetPath = path.join(binDir, binaryName)
+
+  // Ensure bin directory exists
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true })
+  }
+
+  // Remove existing binary/symlink if it exists
+  if (fs.existsSync(targetPath)) {
+    fs.unlinkSync(targetPath)
+  }
+
+  return { binDir, targetPath }
+}
+
+function symlinkBinary(sourcePath, binaryName) {
+  const { targetPath } = prepareBinDirectory(binaryName)
+
+  fs.symlinkSync(sourcePath, targetPath)
+  console.log(`emberharmony binary symlinked: ${targetPath} -> ${sourcePath}`)
+
+  // Verify the file exists after operation
+  if (!fs.existsSync(targetPath)) {
+    throw new Error(`Failed to symlink binary to ${targetPath}`)
+  }
+}
+
+function findLocalBinary() {
+  const binDir = path.join(__dirname, "bin")
+  if (!fs.existsSync(binDir)) return
+  const binaryName = os.platform() === "win32" ? "emberharmony.exe" : "emberharmony"
+  const entries = fs.readdirSync(binDir)
+  for (const entry of entries) {
+    const candidate = path.join(binDir, entry, binaryName)
+    if (fs.existsSync(candidate)) {
+      return candidate
+    }
+  }
+}
+
+async function main() {
+  try {
+    if (os.platform() === "win32") {
+      // On Windows, the .exe is already included in the package and bin field points to it
+      // No postinstall setup needed
+      console.log("Windows detected: binary setup not needed (using packaged .exe)")
+      return
+    }
+
+    const local = findLocalBinary()
+    if (local) {
+      console.log(`Local binary verified at: ${local}`)
+      return
+    }
+
+    // On non-Windows platforms, just verify the binary package exists
+    // Don't replace the wrapper script - it handles binary execution
+    const { binaryPath } = findBinary()
+    console.log(`Platform binary verified at: ${binaryPath}`)
+    console.log("Wrapper script will handle binary execution")
+  } catch (error) {
+    console.error("Failed to setup emberharmony binary:", error.message)
+    process.exit(1)
+  }
+}
+
+try {
+  main()
+} catch (error) {
+  console.error("Postinstall script error:", error.message)
+  process.exit(0)
+}