// readme

eukhe

Coding agent with a memory of all things. εὐχή: a wish, a prayer.

Install

curl -fsSL https://eukhe.com/install | sh  # macOS (Apple Silicon), Linux (x64, arm64); rerun to update
eukhe kernel install                       # one time: the Python kernel (needs uv); until then sessions have no ipython tool
  • Nix: nix run github:gildrb/eukhe
  • Home Manager: programs.eukhe.enable = true; (module inputs.eukhe.homeManagerModules.default)
  • Source: cargo build --release --locked -p eukhe-cli

Use

cd /path/to/project
eukhe            # start; run /login at the first start
eukhe agents     # find and open sessions
eukhe gateway    # chat with the session from Signal on your phone
eukhe dashboard  # open the session in a browser

eukhe --help lists the commands. In a session, type / for the slash commands.

Memory

γραμμάτων τε συνθέσεις, μνήμην ἁπάντων, μουσομήτορ᾽ ἐργάνην. And the joining of letters: memory of all things, the Muses’ mother, a worker. (Aeschylus, Prometheus Bound 460-461)

  • Each session keeps an append-only log. Nothing is deleted.
  • A turn sends the newest messages verbatim and a view of the older ones: one-line…