@thesolaceproject/emberharmony-linux-arm64-musl 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +157 -0
- package/bin/RELEASE_NOTES.md +75 -0
- package/bin/emberharmony +0 -0
- package/package.json +10 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Sydney Renee
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://github.com/SolaceHarmony/emberharmony">
|
|
3
|
+
<picture>
|
|
4
|
+
<source srcset="packages/console/app/src/asset/logo-ornate-dark.svg" media="(prefers-color-scheme: dark)">
|
|
5
|
+
<source srcset="packages/console/app/src/asset/logo-ornate-light.svg" media="(prefers-color-scheme: light)">
|
|
6
|
+
<img src="packages/console/app/src/asset/logo-ornate-light.svg" alt="EmberHarmony logo">
|
|
7
|
+
</picture>
|
|
8
|
+
</a>
|
|
9
|
+
</p>
|
|
10
|
+
<p align="center">The open source AI coding agent.</p>
|
|
11
|
+
<p align="center">
|
|
12
|
+
<a href="https://discord.gg/EdF8f7JR"><img alt="Discord" src="https://img.shields.io/discord/1391832426048651334?style=flat-square&label=discord" /></a>
|
|
13
|
+
<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>
|
|
14
|
+
<a href="https://github.com/SolaceHarmony/emberharmony/actions/workflows/ci.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/SolaceHarmony/emberharmony/ci.yml?style=flat-square&branch=main" /></a>
|
|
15
|
+
</p>
|
|
16
|
+
|
|
17
|
+
[](https://github.com/SolaceHarmony/emberharmony)
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## What is EmberHarmony?
|
|
22
|
+
|
|
23
|
+
EmberHarmony is an open source AI coding agent that runs in your terminal. It's provider-agnostic — use it with Claude, OpenAI, Google, local models via Ollama, or any OpenAI-compatible endpoint. It features a rich TUI, built-in LSP support, and a client/server architecture that lets you drive it remotely.
|
|
24
|
+
|
|
25
|
+
### Zero-Config Local Models
|
|
26
|
+
|
|
27
|
+
EmberHarmony automatically discovers every model installed in your local [Ollama](https://ollama.com) instance. No API keys, no configuration files, no manual setup. If Ollama is running, your models appear:
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
ollama (custom): 19 models
|
|
31
|
+
gemma3:latest · 4.3B · Q4_K_M
|
|
32
|
+
llama3.2:latest · 3.2B · Q4_K_M
|
|
33
|
+
deepseek-r1:14b · 14.0B · Q4_K_M
|
|
34
|
+
qwen3:8b · 8.2B · Q4_K_M
|
|
35
|
+
...
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Switch between cloud and local models mid-conversation. Run sensitive code analysis entirely on your machine. Use cloud models when you need frontier capability, local models when you need privacy or offline access.
|
|
39
|
+
|
|
40
|
+
**Key differences from other AI coding tools:**
|
|
41
|
+
|
|
42
|
+
- **Local-first** — automatic Ollama model discovery, zero config, no keys needed
|
|
43
|
+
- 100% open source (MIT)
|
|
44
|
+
- Not coupled to any single provider — works with Claude, OpenAI, Google, Ollama, and more
|
|
45
|
+
- Out-of-the-box LSP support for intelligent code navigation
|
|
46
|
+
- Rich terminal UI pushing the limits of what's possible in the terminal
|
|
47
|
+
- Client/server architecture — run on your machine, drive from anywhere
|
|
48
|
+
|
|
49
|
+
### Installation
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# Quick install
|
|
53
|
+
curl -fsSL https://raw.githubusercontent.com/SolaceHarmony/emberharmony/dev/install | bash
|
|
54
|
+
|
|
55
|
+
# npm / bun
|
|
56
|
+
npm i -g @thesolaceproject/emberharmony@latest
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
#### Local Build + Install
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
bun install
|
|
63
|
+
npm run pack:local
|
|
64
|
+
# prints a .tgz path you can install, e.g.
|
|
65
|
+
# npm i -g /absolute/path/to/emberharmony-1.2.2.tgz
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Desktop App (Beta)
|
|
69
|
+
|
|
70
|
+
EmberHarmony is also available as a desktop application. Download directly from the [releases page](https://github.com/SolaceHarmony/emberharmony/releases).
|
|
71
|
+
|
|
72
|
+
| Platform | Download |
|
|
73
|
+
| --------------------- | ----------------------------------------- |
|
|
74
|
+
| macOS (Apple Silicon) | `emberharmony-desktop-darwin-aarch64.dmg` |
|
|
75
|
+
| macOS (Intel) | `emberharmony-desktop-darwin-x64.dmg` |
|
|
76
|
+
| Windows | `emberharmony-desktop-windows-x64.exe` |
|
|
77
|
+
| Linux | `.deb`, `.rpm`, or AppImage |
|
|
78
|
+
|
|
79
|
+
#### Installation Directory
|
|
80
|
+
|
|
81
|
+
The install script respects the following priority order:
|
|
82
|
+
|
|
83
|
+
1. `$EMBERHARMONY_INSTALL_DIR` — custom installation directory
|
|
84
|
+
2. `$XDG_BIN_DIR` — XDG Base Directory compliant path
|
|
85
|
+
3. `$HOME/bin` — standard user binary directory (if exists)
|
|
86
|
+
4. `$HOME/.emberharmony/bin` — default fallback
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
EMBERHARMONY_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/SolaceHarmony/emberharmony/dev/install | bash
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Agents
|
|
93
|
+
|
|
94
|
+
EmberHarmony includes two built-in agents you can switch between with the `Tab` key.
|
|
95
|
+
|
|
96
|
+
- **build** — default, full-access agent for development work
|
|
97
|
+
- **plan** — read-only agent for analysis and code exploration
|
|
98
|
+
- Denies file edits by default
|
|
99
|
+
- Asks permission before running bash commands
|
|
100
|
+
- Ideal for exploring unfamiliar codebases or planning changes
|
|
101
|
+
|
|
102
|
+
A **general** subagent is also available for complex searches and multistep tasks. It's used internally and can be invoked with `@general` in messages.
|
|
103
|
+
|
|
104
|
+
### Provider Support
|
|
105
|
+
|
|
106
|
+
EmberHarmony works with any OpenAI-compatible API. Built-in support for:
|
|
107
|
+
|
|
108
|
+
| Provider | Models | Config needed |
|
|
109
|
+
|----------|--------|---------------|
|
|
110
|
+
| **Ollama (local)** | Auto-discovered from `localhost:11434` | None — just run Ollama |
|
|
111
|
+
| **Ollama Cloud** | Hosted Ollama models | API key |
|
|
112
|
+
| **Anthropic** | Claude Opus, Sonnet, Haiku | API key |
|
|
113
|
+
| **OpenAI** | GPT-4o, o1, o3 | API key |
|
|
114
|
+
| **Google** | Gemini Pro, Flash | API key |
|
|
115
|
+
| **Any OpenAI-compatible** | LM Studio, vLLM, Together, Groq, etc. | Endpoint + key |
|
|
116
|
+
|
|
117
|
+
#### Ollama Local Setup
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
# 1. Install Ollama (https://ollama.com)
|
|
121
|
+
# 2. Pull a model
|
|
122
|
+
ollama pull llama3.2
|
|
123
|
+
|
|
124
|
+
# 3. Run EmberHarmony — models appear automatically
|
|
125
|
+
emberharmony
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
To use a non-default Ollama address, add to `~/.config/emberharmony/config.json`:
|
|
129
|
+
```json
|
|
130
|
+
{
|
|
131
|
+
"provider": {
|
|
132
|
+
"ollama": {
|
|
133
|
+
"options": { "baseURL": "http://192.168.1.100:11434" }
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Contributing
|
|
140
|
+
|
|
141
|
+
If you're interested in contributing to EmberHarmony, please read our [contributing guide](./CONTRIBUTING.md) before submitting a pull request.
|
|
142
|
+
|
|
143
|
+
### Building on EmberHarmony
|
|
144
|
+
|
|
145
|
+
If you are working on a project related to EmberHarmony that uses "emberharmony" in its name, please add a note in your README clarifying that it is not built by The Solace Project and is not affiliated with us.
|
|
146
|
+
|
|
147
|
+
### Acknowledgments
|
|
148
|
+
|
|
149
|
+
EmberHarmony is a fork of [opencode](https://github.com/anomalyco/opencode) by the opencode upstream team. We are deeply grateful for their foundational work in building an exceptional open source AI coding agent. This project builds on their vision and engineering.
|
|
150
|
+
|
|
151
|
+
### Maintainer
|
|
152
|
+
|
|
153
|
+
**Sydney Renee** — [The Solace Project](https://github.com/SolaceHarmony)
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
**Community:** [Discord](https://discord.gg/EdF8f7JR) | [Issues](https://github.com/SolaceHarmony/emberharmony/issues) | [Releases](https://github.com/SolaceHarmony/emberharmony/releases)
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
## What's Changed
|
|
2
|
+
* EmberHarmony 1.1.0 — rebrand, security patches, gtk cleanup by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/1
|
|
3
|
+
* fix(security): add checksum verification to install script by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/22
|
|
4
|
+
* fix(security): prevent TOCTOU and symlink attacks in file operations by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/23
|
|
5
|
+
* EmberHarmony 1.2.2 — security hardening, Ollama auto-discovery, CI fi… by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/26
|
|
6
|
+
* [WIP] Fix security: encrypt credentials at rest instead of plaintext JSON by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/29
|
|
7
|
+
* fix(security): vendor models-snapshot.ts instead of fetching from models.dev at build time by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/28
|
|
8
|
+
* Skip model-dependent E2E tests on CI (no provider credentials) by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/30
|
|
9
|
+
* Fix/branding by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/27
|
|
10
|
+
* Add mock provider for CI E2E model picker tests by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/31
|
|
11
|
+
* build(deps): bump dompurify from 3.3.3 to 3.4.0 in /packages/ui by @dependabot[bot] in https://github.com/SolaceHarmony/emberharmony/pull/33
|
|
12
|
+
* build(deps): bump rustls-webpki from 0.103.10 to 0.103.13 in /packages/desktop/src-tauri by @dependabot[bot] in https://github.com/SolaceHarmony/emberharmony/pull/32
|
|
13
|
+
* Potential fix for code scanning alert no. 17: Creating biased random numbers from a cryptographically secure source by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/36
|
|
14
|
+
* build(deps): bump astro from 5.18.1 to 6.1.6 in /packages/web by @dependabot[bot] in https://github.com/SolaceHarmony/emberharmony/pull/34
|
|
15
|
+
* Potential fix for code scanning alert no. 18: Server-side request forgery by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/35
|
|
16
|
+
* build(deps): bump @astrojs/cloudflare from 12.6.11 to 13.1.10 in /packages/web by @dependabot[bot] in https://github.com/SolaceHarmony/emberharmony/pull/37
|
|
17
|
+
* Potential fix for code scanning alert no. 23: Workflow does not contain permissions by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/38
|
|
18
|
+
* fix(deps): bump h3/astro/wrangler + close 4 CVEs to unstick build by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/40
|
|
19
|
+
* Potential fix for code scanning alert no. 19: Uncontrolled command line by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/39
|
|
20
|
+
* Snapshot local working changes by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/41
|
|
21
|
+
* build(deps): bump astro from 6.1.6 to 6.1.10 in /packages/web by @dependabot[bot] in https://github.com/SolaceHarmony/emberharmony/pull/43
|
|
22
|
+
* build(deps): bump tauri from 2.10.3 to 2.11.1 in /packages/desktop/src-tauri by @dependabot[bot] in https://github.com/SolaceHarmony/emberharmony/pull/42
|
|
23
|
+
* Fix MessageTimeline crash and update actions for enterprise compliance by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/44
|
|
24
|
+
* Fix/enterprise actions by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/45
|
|
25
|
+
* Remove Docker and AUR publishing from workflow by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/46
|
|
26
|
+
* Restore version to 1.3.0 by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/47
|
|
27
|
+
* Restore version to 1.3.0 by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/50
|
|
28
|
+
* Pixel-perfect rebranding and CI quarantine by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/51
|
|
29
|
+
* Fix publish workflow: restore build tasks on push to dev, remove duplicate quarantine by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/52
|
|
30
|
+
* Repair publish workflow gates for main-as-default by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/53
|
|
31
|
+
* ci: reusable build workflow + per-merge CI + CodeQL by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/54
|
|
32
|
+
* ci: fix reusable-workflow permissions and tighten YAML hygiene by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/55
|
|
33
|
+
* Add Rust CodeQL coverage with buildless extraction by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/56
|
|
34
|
+
* Rename test workflow to 'Tests' by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/57
|
|
35
|
+
* chore(security): upgrade nitro to 3.0.260429-beta (CVE-2026-44373) by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/58
|
|
36
|
+
* Remove sydneyrenee launch config by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/59
|
|
37
|
+
* Restore corrected EmberHarmony asset variants by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/60
|
|
38
|
+
* Remove SST runtime integration by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/61
|
|
39
|
+
* Merge dev into main: cleanup, rebrand, and CI/security updates by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/62
|
|
40
|
+
* Harden version sync & publish: fail-loud over silent fallbacks by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/63
|
|
41
|
+
* Refreshing dev from main by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/64
|
|
42
|
+
* Merge pull request #64 from SolaceHarmony/main by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/65
|
|
43
|
+
* Remove upstream PR template; lock CI out of default-token writes by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/66
|
|
44
|
+
* Tag-driven releases: tag names the artifacts, version.json names the build by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/67
|
|
45
|
+
* Address PR #68 review: API user-agent, yarn support, portable hashing, tag validation order by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/69
|
|
46
|
+
* Merge dev into main: human-controlled releases, tag-driven artifacts, CI write lockdown by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/68
|
|
47
|
+
* Channel from the pre-release flag with main-ancestry enforcement; gate npm on assets by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/70
|
|
48
|
+
* Disable build/typecheck caching: every verification runs from scratch by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/71
|
|
49
|
+
* Make the desktop local build self-contained: declared requirements, preflight, no notarization by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/72
|
|
50
|
+
* Restore Tauri desktop build and desktop asset upload to CI by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/73
|
|
51
|
+
* Fix Tauri CI build: rustup target and action input fixes by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/75
|
|
52
|
+
* Re-enable desktop artifact upload, drop Intel macOS by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/76
|
|
53
|
+
* Fix/restore tauri build by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/78
|
|
54
|
+
* Pass EMBERHARMONY_RELEASE and EMBERHARMONY_TARGET to desktop Prepare … by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/80
|
|
55
|
+
* Fix tauri-action: pin to v0.6.2, use correct artifact inputs by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/82
|
|
56
|
+
* Fix/tauri action inputs by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/83
|
|
57
|
+
* 1.3.1-dev by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/77
|
|
58
|
+
* Catch up dev from main. by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/84
|
|
59
|
+
* Merge pull request #84 from SolaceHarmony/main by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/85
|
|
60
|
+
* Merge pull request #85 from SolaceHarmony/dev by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/86
|
|
61
|
+
* Fix notarization by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/87
|
|
62
|
+
* Add debug workflow to check APPLE_API_KEY format by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/88
|
|
63
|
+
* Migrating more fixes by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/89
|
|
64
|
+
* Merge pull request #89 from SolaceHarmony/dev by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/90
|
|
65
|
+
* Merge pull request #90 from SolaceHarmony/main by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/91
|
|
66
|
+
* LiveKit voice mode: hands-free sessions on desktop by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/92
|
|
67
|
+
* Security: fix code-scanning and dependabot findings by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/93
|
|
68
|
+
* Release 1.4.0: voice mode + security fixes by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/95
|
|
69
|
+
* Release 1.4.0 by @sydneyrenee in https://github.com/SolaceHarmony/emberharmony/pull/96
|
|
70
|
+
|
|
71
|
+
## New Contributors
|
|
72
|
+
* @sydneyrenee made their first contribution in https://github.com/SolaceHarmony/emberharmony/pull/22
|
|
73
|
+
* @dependabot[bot] made their first contribution in https://github.com/SolaceHarmony/emberharmony/pull/33
|
|
74
|
+
|
|
75
|
+
**Full Changelog**: https://github.com/SolaceHarmony/emberharmony/commits/v1.4.0
|
package/bin/emberharmony
ADDED
|
Binary file
|