eukhe
Coding agent with a memory of all things
Star 0
Fork 0
Watch
eukhe docs install.md
2.7 kB · 66 lines
Markdown
at bend/all-docs

Install #

curl #

macOS (Apple Silicon), Linux (x64, arm64). No root.

curl -fsSL https://eukhe.com/install | sh               # install, or update in place
curl -fsSL https://eukhe.com/install | sh -s -- 0.10.41 # pin a version
  • Payload ~/.local/share/eukhe/eukhe-<version>, launcher ~/.local/bin/eukhe; move with EUKHE_INSTALL_ROOT, EUKHE_INSTALL_BIN_DIR.
  • Verifies against the release SHA256SUMS and, for the newest release, the hash pinned in nix/release.json.
  • Update keeps the previous payload for running daemons, prunes older ones.
  • Uninstall: eukhe shutdown, remove both paths.
  • Warns if uv (kernel) or git (chat memory) is missing; the Nix package supplies both.
  • https://eukhe.com/install 302-redirects to releases/latest/download/install.sh: the installer CI released with the newest release, never untested main. https://eukhe.com/ redirects the same for non-HTML clients (curl, wget); browsers get the eukhe page. Served by Cloudflare Worker gildrb-products (repo gildrb/gildrb.com, worker/products.ts). curl -L follows.

Nix #

nix run github:gildrb/eukhe

Home Manager #

{
  inputs.eukhe.url = "github:gildrb/eukhe";

  # in the home configuration:
  imports = [ inputs.eukhe.homeManagerModules.default ];
  programs.eukhe = {
    enable = true;
    daemon.enable = true; # Linux: systemd user service
    settings.telemetry.enabled = false;
  };
}
  • programs.eukhe.settings → ~/.eukhe/settings.json, copied at each activation.
  • programs.eukhe.files links files into ~/.eukhe.

mise #

Newest GitHub release. eukhe tags: eukhe-v<version>; upstream v* tags also exist.

[tools]
"github:gildrb/eukhe" = { version = "latest", version_prefix = "eukhe-v" }

Source #

cargo build --release --locked -p eukhe-cli  # eukhe --version reports <series>-dev, e.g. 0.10.0-dev; only a release reports a release version

Versions and the daemon #

  • Build id: <version>+<commit>, plus .dirty.<hash> (hash of changes) if sources differ from the commit; <version>+src.<hash> (hash of sources) with no commit. Different sources never share an id.
  • Order: semver for releases; -dev is below its series' releases.
  • After an upgrade, the next interactive eukhe start replaces an idle lower-version daemon, or a pre-rename prime-agent daemon on the socket.
  • Background clients (eukhe dashboard, eukhe gateway, ACP) never replace a daemon.
  • No client replaces a newer daemon or another build of the same version; it tells you. eukhe shutdown stops the daemon.
  • A busy daemon runs until the next idle start. Sessions persist and reattach.