You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
chore(release): bump to 1.2.2, rewrite README for EmberHarmony brand
- Bump all 15 packages from 1.2.1 to 1.2.2
- Rewrite README: remove dead solace.ofharmony.ai links, stub package
manager commands, and incorrect upstream references; add provider
support section; fix acknowledgments to reference opencode-ai/opencode
- Update CHANGELOG with full security audit results
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
+
**Key differences from other AI coding tools:**
26
+
27
+
- 100% open source (MIT)
28
+
- Not coupled to any single provider — works with Claude, OpenAI, Google, Ollama, and more
29
+
- Out-of-the-box LSP support for intelligent code navigation
30
+
- Rich terminal UI pushing the limits of what's possible in the terminal
31
+
- Client/server architecture — run on your machine, drive from anywhere
npm i -g @thesolaceproject/emberharmony@latest # or bun/pnpm/yarn
48
-
scoop install emberharmony # Windows
49
-
choco install emberharmony # Windows
50
-
paru -S emberharmony-bin # Arch Linux
51
-
mise use -g emberharmony # Any OS
52
-
nix run nixpkgs#emberharmony # or github:SolaceHarmony/emberharmony for latest dev branch
39
+
# npm / bun
40
+
npm i -g @thesolaceproject/emberharmony@latest
53
41
```
54
42
55
-
> [!TIP]
56
-
> Remove versions older than 0.1.x before installing.
57
-
58
-
#### Local Build + Install (No CI)
43
+
#### Local Build + Install
59
44
60
45
```bash
61
46
bun install
62
47
npm run pack:local
63
48
# prints a .tgz path you can install, e.g.
64
-
# npm i -g /absolute/path/to/emberharmony-1.0.0.tgz
49
+
# npm i -g /absolute/path/to/emberharmony-1.2.2.tgz
65
50
```
66
51
67
-
### Desktop App (BETA)
52
+
### Desktop App (Beta)
68
53
69
-
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).
54
+
EmberHarmony is also available as a desktop application. Download directly from the [releases page](https://github.com/SolaceHarmony/emberharmony/releases).
EmberHarmony includes two built-in agents you can switch between with the `Tab` key.
102
79
103
-
-**build**- Default, fullaccess agent for development work
104
-
-**plan**- Read-only agent for analysis and code exploration
80
+
-**build**— default, full-access agent for development work
81
+
-**plan**— read-only agent for analysis and code exploration
105
82
- Denies file edits by default
106
83
- Asks permission before running bash commands
107
84
- Ideal for exploring unfamiliar codebases or planning changes
108
85
109
-
Also, included is a **general** subagent for complex searches and multistep tasks.
110
-
This is used internally and can be invoked using `@general` in messages.
86
+
A **general** subagent is also available for complex searches and multistep tasks. It's used internally and can be invoked with `@general` in messages.
87
+
88
+
### Provider Support
111
89
112
-
Learn more about [agents](https://solace.ofharmony.ai/docs/agents).
90
+
EmberHarmony works with any OpenAI-compatible API. Built-in support for:
113
91
114
-
### Documentation
92
+
-**Anthropic** (Claude) — Opus, Sonnet, Haiku
93
+
-**OpenAI** — GPT-4o, o1, o3
94
+
-**Google** — Gemini Pro, Flash
95
+
-**Ollama** — local models auto-discovered on startup
96
+
-**Any OpenAI-compatible endpoint** — LM Studio, vLLM, Together, Groq, etc.
115
97
116
-
For more info on how to configure EmberHarmony [**head over to our docs**](https://solace.ofharmony.ai/docs).
98
+
Local Ollama models are detected automatically when Ollama is running — no configuration needed.
117
99
118
100
### Contributing
119
101
120
-
If you're interested in contributing to EmberHarmony, please read our [contributing docs](./CONTRIBUTING.md) before submitting a pull request.
102
+
If you're interested in contributing to EmberHarmony, please read our [contributing guide](./CONTRIBUTING.md) before submitting a pull request.
121
103
122
104
### Building on EmberHarmony
123
105
124
-
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.
125
-
126
-
### FAQ
127
-
128
-
#### How is this different from Claude Code?
129
-
130
-
It's very similar to Claude Code in terms of capability. Here are the key differences:
131
-
132
-
- 100% open source
133
-
- 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.
134
-
- Out of the box LSP support
135
-
- A focus on TUI — we are going to push the limits of what's possible in the terminal.
136
-
- 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.
106
+
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.
137
107
138
108
### Acknowledgments
139
109
140
-
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.
110
+
EmberHarmony is a fork of [opencode](https://github.com/opencode-ai/opencode) 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 builds on their vision and engineering.
0 commit comments