Skip to main content

Daimon

codecov

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 required daemon, no external memory backend. The MCP server and browser viewer are optional local read surfaces.

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 any host that ships packaged hooks):

daimon hooks install windsurf    # copies the hook script + prints the registration snippet
daimon hooks list                # hosts with packaged hook scripts

Codex and Kimi Code use the same packaged installer:

daimon hooks install codex
daimon hooks install kimi

Gemini CLI uses the manual hook/gemini-hooks.py 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, kimi
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

Metadata

Release files for daimon-briefing 0.68.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for daimon-briefing 0.68.1
File Size Uploaded Provenance Actions
daimon_briefing-0.68.1.tar.gz 2.9 MB With provenance Details for daimon_briefing-0.68.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for daimon-briefing 0.68.1
File Interpreter ABI Platform Actions
daimon_briefing-0.68.1-py3-none-any.whl Python 3 none any Details for daimon_briefing-0.68.1-py3-none-any.whl

Total release size: 4.1 MB

Release files / daimon_briefing-0.68.1.tar.gz

Download URL daimon_briefing-0.68.1.tar.gz
Size 2.9 MB
Tags Source
SHA-256 checksum
How to use checksums
6e59474d05100d6b72f4d6e7c44729db6ba88e28028d5db19a1caf7f433d44e7
BLAKE2b-256 checksum
How to use checksums
af85586dafa14f5a3d617b07ada8a5afabcd7a925f49d0060b278c178da08b93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Release files / daimon_briefing-0.68.1-py3-none-any.whl

Download URL daimon_briefing-0.68.1-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ab828964b18cc6db6accb3115d9e6e094b6db0dd1eccf52151ce6a1814c9f38d
BLAKE2b-256 checksum
How to use checksums
ca969878a521d1d98218ab21c5623e16c7bfd9c863214a5fd22915a1983ef76f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Security for daimon-briefing 0.68.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for daimon_briefing-0.68.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.68.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page