Daimon
Your AI coding agent forgets everything between sessions. Daimon writes a small cognitive checkpoint when a session ends, then renders a "while you were away" briefing when the next one starts — so the agent resumes from a faithful record of where you left off instead of a confident guess. Everything runs locally: per-project JSON checkpoints plus a derived SQLite index, no server, no external memory backend.
Every briefing item carries a trust class. ✓ verbatim items are pinned to an exact
quote from the transcript and are never reworded. ~ inferred items are the agent's
own conclusions and are allowed to evolve. Items carried from older sessions are
tagged [carried]. Knowing which memories are quotes and which are guesses is the
whole point.
Install
pip install daimon-briefing
# or, as an isolated tool:
uv tool install daimon-briefing
Add the [pretty] extra for rich tables and panels in status/brief
(plain text works without it):
uv tool install 'daimon-briefing[pretty]'
The installed command is daimon. Requires Python 3.10+, stdlib-only at runtime.
Connect an LLM (one time)
Writing a checkpoint needs an LLM endpoint. If the claude CLI is on your PATH you
are zero-config — daimon configure prints ✓ ready and you are done. Otherwise
point it at any OpenAI-compatible endpoint:
daimon configure --backend litellm \
--base-url https://generativelanguage.googleapis.com/v1beta/openai \
--api-key <YOUR-KEY> --model gemini-2.5-flash
daimon configure --test # send one tiny prompt and confirm the backend works
Or point it at a headless LLM CLI you already have installed:
daimon configure --backend command --command "mycli -p"
Some CLIs don't read the prompt from stdin — the Devin CLI takes it as a flag
pointing at a file. --input controls how the prompt reaches the command
(stdin default, arg appends it as the final argument, file:<flag>
writes it to a tempfile and passes <flag> <path>):
daimon configure --backend command --command "devin -p" --input "file:--prompt-file"
Config lives in ~/.daimon/env (hooks run with the host's inherited environment, not
your shell profile). Kill switch: DAIMON_DISABLE=1.
Hook up your host
Claude Code (plugin — recommended):
/plugin marketplace add Daily-Nerd/daimon
/plugin install daimon@daimon
The plugin registers the SessionStart/SessionEnd hooks itself.
Windsurf (and other hosts that ship packaged hooks):
daimon hooks install windsurf # copies the hook script + prints the registration snippet
daimon hooks list # hosts with packaged hook scripts
Codex and other hosts use the manual hook installer from a repository clone — see the GitHub docs.
Then end a session → a checkpoint is written; start the next → the briefing appears.
Quickstart without a host
The CLI also works on any plain-text or markdown transcript, no host required:
daimon serialize path/to/transcript.md # transcript → checkpoint
daimon brief # render the "while you were away" briefing
daimon status # did the last checkpoint get written?
Teach your agent the protocol
Hooks capture your sessions; the skill teaches the agent on the other side to read the
briefing at session start and treat verbatim items as immutable quotes:
daimon skill install claude # also: codex, windsurf, cursor, gemini
daimon skill list # which scopes each host supports
Commands
| Command | What it does |
|---|---|
daimon brief |
Render the "while you were away" briefing from the latest checkpoint |
daimon status |
Checkpoint presence/age + last capture outcome; reports failures honestly |
daimon recall <terms> |
Full-text search over your whole checkpoint history |
daimon resolve <item> |
Mark a checkpoint item resolved so it stops carrying forward |
daimon reverify <item> |
Evidence-gated reopen of a resolved item |
daimon refute <action> |
Author, ratify, search, guard, revise, or overturn scoped negative knowledge |
daimon heal [--force] |
Re-serialize the most recent failed session, if it can be done safely; --force ignores a prior retry marker to re-heal a retry-exhausted session |
daimon stats |
Local usage + capture aggregates (nothing is transmitted) |
daimon configure |
Detect/repair the LLM backend |
daimon hooks install <host> |
Install packaged host hook scripts |
daimon skill install <host> |
Install the agent skill for a host |
Run daimon --help or daimon <command> --help for the full surface, including
code anchors (daimon anchor) and opt-in team memory (daimon team).
Docs
Full documentation, architecture, and the research trail live in the GitHub repository: https://github.com/Daily-Nerd/daimon
License: Apache-2.0 · Org: Daily-Nerd
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file daimon_briefing-0.32.0.tar.gz.
File metadata
- Download URL: daimon_briefing-0.32.0.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1634055c351198046adfb2427c8d9f3818581188b05cad686a545282c63dab14
|
|
| MD5 |
5a1e41adf208cfecdbbe48615dc58bb1
|
|
| BLAKE2b-256 |
f6ae9c0842501633e5d325d74e6012f0390fb52867795abf95eb21ee88301e4c
|
Provenance
The following attestation bundles were made for daimon_briefing-0.32.0.tar.gz:
Publisher:
release.yml on Daily-Nerd/daimon
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
daimon_briefing-0.32.0.tar.gz -
Subject digest:
1634055c351198046adfb2427c8d9f3818581188b05cad686a545282c63dab14 - Sigstore transparency entry: 2568679012
- Sigstore integration time:
-
Permalink:
Daily-Nerd/daimon@468c0b248dd98b89b41e5eef4cc4dcce8f6ed1c8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Daily-Nerd
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@468c0b248dd98b89b41e5eef4cc4dcce8f6ed1c8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file daimon_briefing-0.32.0-py3-none-any.whl.
File metadata
- Download URL: daimon_briefing-0.32.0-py3-none-any.whl
- Upload date:
- Size: 541.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9f0baade4502ccfb847ae0c52df388ef9af48355008f3a1548b7e5f938b5a987
|
|
| MD5 |
fe93642f3b658cccb26cfc4867443e76
|
|
| BLAKE2b-256 |
f8dc50cc1deea9c5d3e594978f12ce6c9358840bbf9d3dfc70fe8bc844e69de6
|
Provenance
The following attestation bundles were made for daimon_briefing-0.32.0-py3-none-any.whl:
Publisher:
release.yml on Daily-Nerd/daimon
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
daimon_briefing-0.32.0-py3-none-any.whl -
Subject digest:
9f0baade4502ccfb847ae0c52df388ef9af48355008f3a1548b7e5f938b5a987 - Sigstore transparency entry: 2568679027
- Sigstore integration time:
-
Permalink:
Daily-Nerd/daimon@468c0b248dd98b89b41e5eef4cc4dcce8f6ed1c8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Daily-Nerd
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@468c0b248dd98b89b41e5eef4cc4dcce8f6ed1c8 -
Trigger Event:
push
-
Statement type:
