existence-trace
Personal journal AI that reads your daily notes, asks questions, and proves it used your
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Listing updated
- 1 day ago
Similar agents
About existence-trace
existence-trace is an open-source agent for personal assistants. It is available on CLI, macOS, Linux, Windows and self-hosted.
The README says the tool reads a journal you keep in plain files, writes a daily report through three lenses (emotion, stability and exploration, growth), and asks a question when it is unsure about you. Your answers are turned into versioned rules, and when a rule changes a report, a receipt records the before and after. A weekly audit fails if a rule was never applied.
Your own words are kept verbatim in a protected block that the AI cannot rewrite, and the AI's inferences are labelled apart from what you said. Data lives in a folder you choose, versioned with git, and the model is any OpenAI-compatible or Anthropic API, or Ollama, that you connect with your own key.
It suits people who already work with Claude Code, Codex or ChatGPT and want a personal memory they can read, grep and back up, or who want to import years of old diary entries from .md, .txt or Day One exports.
What it does
- Daily reflective reports
- Writes a daily report scoring emotion (PAD), stability and exploration (G), and growth (XP).
- Verbatim journal storage
- Keeps your own words word for word in a protected block the AI cannot rewrite.
- Clarifying questions
- Asks one evidence-backed question when it is unsure about a preference instead of guessing.
- Preference receipts
- Records before and after receipts when a learned rule changes a report.
- Weekly rule audit
- Fails the audit if a recorded decision was never applied in a report.
- Diary import
- Imports folders of .md, .txt and Day One JSON files, placing entries by date.
- Bring your own model
- Works with Anthropic, OpenAI, DeepSeek, OpenRouter, Ollama or any OpenAI-compatible endpoint.
Good for
- Keep a private daily journal that an AI reads and reflects on
- Import years of old diary entries and have them processed by date
- Teach an AI assistant your preferences with auditable receipts
- Review weekly patterns in mood, stability and growth as personal reflection
Pricing
Open source
MIT licensed, free to run with your own AI API key.
existence-trace FAQ
Which AI models can it use?
The README lists Anthropic, OpenAI, DeepSeek, OpenRouter and Ollama, plus any OpenAI-compatible address set with a custom URL.
Where is my data stored?
The README says data lives in your own data folder outside the repository, as plain text files that can be versioned with git.
Is it a clinical tool?
No. The README states PAD, G and XP are personal reflection aids, not clinical scales, and not a substitute for professional care.
How is my API key handled?
The README says the key is read from an environment variable or a mode-600 file, is never passed as a command-line argument, and is never written to the data folder or config.
Is existence-trace free?
Yes. existence-trace is open source, so you can use and self-host it for free.
What are the best alternatives to existence-trace?
The closest alternatives to existence-trace are Kun, CowAgent, Cinnamon AI, openagent and Pizza.
Where this comes from
- Description: written from the project's README.


