eukhe
Coding agent with a memory of all things
Star 0
Fork 0
Watch
5.3k 129 60
Files
.github
bend
crates
docs
eukhe-runtime
nix
scripts
skills
vendor
.gitignore
.gitleaks.toml
.pre-commit-config.yaml
AGENTS.md
Cargo.lock
Cargo.toml
deny.toml
flake.lock
flake.nix
install.sh
LAWS.bend
LICENSE
Makefile
PROOF.bend
README.md
rust-toolchain.toml
SECURITY.md
THIRD-PARTY-NOTICES
README.md

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.

A coding agent forgets. A new session starts empty. A compaction removes the start of a long session. 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.
  • /memory shows the view. /memory zoom <id> <n> opens a node.
  • /memory-model selects 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 message sends a message to a family agent.
  • /agents lists 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|large sets how many agents run. /workflow-size sets the default.
  • /workflows shows each run: phases, agents, log.

Details: docs/workflows.md.

Phone and browser #

  • eukhe gateway connects Signal to the CLI session. See docs/gateway.md.
  • eukhe dashboard serves the session on 127.0.0.1. For a phone, run poros 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.