Aelfrice

aelfrice

Your AI agent stops forgetting. Set up aelfrice one time. aelfrice then does not interrupt your work.

_No cloud. No account. No telemetry._

[](https://pypi.org/project/aelfrice/) [](https://pypi.org/project/aelfrice/) [](LICENSE) [](https://github.com/robotrocketscience/aelfrice/actions/workflows/ci.yml)

You correct your agent. *"Got it,"* the agent says. In the next session, the agent makes the same mistake.

aelfrice runs in the background. aelfrice stops this loss of memory. Write a rule one time. Each relevant prompt after that carries the rule. The rule is attached *before* the model reads your message. There is no rules file to maintain. There is nothing for the agent to skip, because the matched beliefs are in the prompt itself.

aelfrice is for developers who use AI coding agents. A host that supplies a `UserPromptSubmit` hook gets full support. A tool cannot put the correct beliefs in front of the model before the model reads your message, because the model decides whether to call the tool. The hook therefore makes the guarantee possible. aelfrice is local-only by design. Embeddings, vector retrieval-augmented generation (RAG) and cloud synchronization are outside the scope. [Philosophy](docs/concepts/PHILOSOPHY.md) explains why that trade-off is worth it.

Install

uv tool install aelfrice    # requires uv — https://docs.astral.sh/uv/
aelf setup                  # wire the UserPromptSubmit hook into your agent
aelf onboard .              # deterministic project scan (regex classifie