Eukhe
Source: https://github.com/gildrb/eukhe
▍ μὴ παντάπασιν ἡμᾶς εὐχὰς εἰρηκέναι, ἀλλὰ χαλεπὰ μέν, δυνατὰ δέ πῃ.
▍ That we have not spoken mere wishes, but things hard, yet somehow possible.
▍ (Plato, Republic 7.540d)
Eukhe is an agent harness that works a task with no person watching, counts it
done only when the user's checks pass on the final code, and gives a report at
the end.
Install
sh [copy]
# macOS (Apple Silicon), Linux (x64, arm64)
curl -fsSL https://eukhe.com/install | sh
Use
sh [copy]
cd project
# start; /login at the first start
eukhe
# script; exit 0 only when all checks pass
eukhe -p --accept-cmd 'npm test' "fix the failing tests"
In a session, /accept cmd --protect tests/app.test.js npm test sets a check.
Then type the task. eukhe --help shows all commands.
Checks
Task: "sort the list"
The agent says done. The check passes.
Next task: "make the sort faster"
Two values are out of order. The task goes back to the agent.
Before a pass counts:
Eukhe breaks the code on purpose. The check finds the break.
The agent cannot set, change, skip or remove a check. A check that finds less
than 80 % of the breaks is weak, and the task ends checks passed, not certified.
After 3 failed checks in sequence, the task ends failed.
When every check finds enough breaks, up to two attackers each write a version
of a changed file that they claim is wrong, and a command that shows it wrong.
An attacker is a model request that does not see the agent's reasoning or
answer. When such a version passes every check, its command shows it wrong and a
separate model request agrees, the task ends checks passed, not certified.
Limits
/budget set cost=5 time=2h: a step that needs the money kept for the report does
not start.
Each step reserves its maximum cost before it starts. The report gives the work
done, the work not done and the limit that stopped it.
Models
When a model cannot continue because its retries are used up, its login expired
or its usage limit is reached, the run continues with another model that the
user configured and is logged in to. Eukhe shows each change. When no model is
left and the provider reports when its usage limit resets, the run waits for the
reset; a script run stops at its wait limit and leaves the session waiting. Any
other failure ends the run with its report.
Crash recovery
After a crash, completed steps stay complete. An interrupted step runs again
when that is safe.
Eukhe settles an interrupted step from its evidence: the file content, the git
ref or the job exit. A step that is not safe to repeat is recorded as not run,
and the run continues. /effects shows these steps.
Parallel work
Two child agents each sort one half at the same time. The parent agent merges
the halves.
Each child works on its own files in its own copy. A parent can set the checks
of a child.
Report
At the end, one report gives the agent's final answer and the result of each
check.
Target: each step runs without a question in the terminal, the browser, the
phone and a script; one message at the end lists each irreversible effect.
Status: being built.
Target: /undo puts the files back to their state before a prompt and names the
irreversible effects that it cannot undo. Status: being built.
Limitations
▍ ἃ μὴ οἶδα οὐδὲ οἴομαι εἰδέναι.
▍ What I do not know, I do not think I know either. (Plato, Apology 21d)
There is no sandbox. Code that the agent runs has the user's permissions and can
change the files that a check reads; a check fails on a change only to its
--protect files. A check that finds the breaks can pass on wrong code that is
not similar to a break and that no attacker writes, for example a hard-coded
answer. A model request that a crash interrupts is not sent again, and its
reserved cost stays counted until its usage is known. A limit that is not set
has no maximum.
Credits
Eukhe is a fork of Prime Intellect's Prime Agent, built on Mario Zechner's pi.
The memory design is Victor Taelin's OptChat and OptMem. The edit tools, the
tokenizers and the harness design come from oh-my-pi, and the Claude tokenizer
vocabulary from Sander Land's ctok. Made by Gil Rodrigues. Notices:
THIRD-PARTY-NOTICES.
License
Apache-2.0. See LICENSE.
Source: https://github.com/gildrb/eukhe