- Rust 92%
- Python 5%
- JavaScript 1%
- C <1%
- TypeScript <1%
- 5 more languages <1%
eukhe #
eukhe (Greek εὐχή: a wish, a prayer) is a coding agent with one endless chat as its memory.
eukhe is a fork of Prime Agent by Prime Intellect. It is not affiliated with Prime Intellect, Victor Taelin or Earendil. See Attribution.
PROBLEM: A coding agent forgets. A new session starts empty. A compaction removes the start of a long session.
SOLUTION: eukhe keeps one chat log for all sessions. Each turn starts from a compact view of the full log.
Install #
macOS (Apple Silicon), Linux (x64, arm64):
curl -fsSL https://eukhe.com/install | sh
| Method | Command |
|---|---|
| Nix, one run | nix run github:gildrb/eukhe |
| Home Manager | programs.eukhe.enable = true; (module inputs.eukhe.homeManagerModules.default) |
| mise | "github:gildrb/eukhe" = { version = "latest", version_prefix = "eukhe-v" } |
| Source | cargo build --release --locked -p eukhe-cli |
To update, run the install command again. eukhe update does not download.
Details: docs/install.md.
Use #
cd /path/to/project
eukhe # start; run /login at the first start
eukhe agents # find and open sessions
eukhe gateway # connect Signal on your phone to the CLI session
eukhe dashboard # open the session in a browser
All commands: docs/usage.md.
Memory #
- The chat log is in
~/.eukhe/chat/. It is append-only. - The compactor writes one-line summaries into a binary tree over the log.
- Each root turn starts from the view: 64 KB to 128 KB of lines.
/memoryshows the view./memory zoom <id> <n>opens a node./memory-modelselects the compaction model and its reasoning effort.
The design is Victor Taelin's OptChat. Details: docs/memory.md.
Agents #
- An agent starts subagents from its Python REPL (
rlm.spawn). @name messagesends a message to a family agent./agentslists the agents of the session.
Dynamic workflows #
/dynamic-workflow <request>makes the agent write and run one orchestration script.- The script starts many subagents: fan-out, pipelines and phases.
--size small|medium|largesets how many agents run./workflow-sizesets the default./workflowsshows each run: phases, agents, log.
Details: docs/workflows.md.
Phone and browser #
eukhe gatewayconnects Signal to the CLI session. See docs/gateway.md.eukhe dashboardserves the session on127.0.0.1. For a phone, runporos eukhe dashboard. See docs/dashboard.md.
References #
| File | Content |
|---|---|
| docs/install.md | Installer, Nix, Home Manager, mise, source build, daemon versions |
| docs/usage.md | Commands, agents, providers, session state |
| docs/settings.md | Settings files, key binds, all settings, Directors |
| docs/workflows.md | Dynamic workflows: sizes, script API, resume, limits |
| docs/memory.md | Chat memory: use, rules, Bend model, proofs |
| docs/local-models.md | Local models: titles, translation, speech, dictation |
| docs/gateway.md | Signal gateway |
| docs/dashboard.md | Web dashboard |
| docs/develop.md | Build, test, releases |
Limitations #
- eukhe runs model-generated Python and shell commands with your user permissions. It is not a sandbox. Use trusted repositories only.
- Platforms: macOS (Apple Silicon), Linux (x64, arm64). No Windows.
- The kernel needs uv. The chat memory needs git. The Nix package supplies both.
- Local models need ONNX Runtime 1.24 or newer.
Attribution #
- Prime Intellect: Prime Agent, the code base of eukhe. Copyright (c) 2025-2026 Prime Intellect Ltd., MIT.
- Mario Zechner: the original code of the Prime Agent TypeScript product, which eukhe ports. Copyright (c) 2025 Mario Zechner, MIT.
- Victor Taelin: the chat memory design, OptChat, and its predecessor OptMem. The memory prompts come from the OptChat specification.
License #
MIT. See LICENSE. Prime Agent copyright stays with Prime Intellect Ltd. and Mario Zechner.