# existence-trace

> existence-trace is an open-source agent for personal assistants. Personal journal AI that reads your daily notes, asks questions, and proves it used your. It is available on CLI, macOS, Linux, Windows and self-hosted.

- **Kind:** Agent
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/maxont/existence-trace
- **Categories:** [personal assistants](https://ai-powered.com/categories/personal-assistants)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## 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.

## Alternatives

- [Kun](https://ai-powered.com/agents/kun): Kun is a hosted agent for personal assistants.
- [CowAgent](https://ai-powered.com/agents/cowagent): CowAgent is an open-source agent for personal assistants.
- [Cinnamon AI](https://ai-powered.com/agents/cinnamon-ai): Cinnamon AI is a hosted agent for personal assistants.
- [openagent](https://ai-powered.com/agents/openagent): openagent is an open-source agent for personal assistants.
- [Pizza](https://ai-powered.com/agents/pizza): Pizza is an open-source agent for developer tools.
- [Aris](https://ai-powered.com/agents/aris): Aris is an open-source agent for personal assistants.

---
Source: https://ai-powered.com/agents/existence-trace
