New to Claude Skills? Learn how to install them →

Ddanielmiessler on GitHub

Daemon

Free

Automate your public digital presence securely.

Get this skill

Free · Opens the source repo

What Daemon does

The Daemon skill is designed to manage your public daemon profile, which acts as a digital representation of your current projects, thoughts, and activities. It integrates seamlessly with your LifeOS system, aggregating data from various sources like TELOS, KNOWLEDGE, PROJECTS, and MEMORY/WORK to create a dynamic profile page. The skill ensures that only safe, publicly shareable content is displayed by employing a deterministic security filter that strips sensitive information, such as names, paths, and credentials, before deployment.

This skill is particularly useful for individuals who want to maintain an up-to-date public profile without the hassle of manual updates. By automating the aggregation and sanitization of data, Daemon minimizes the risk of accidentally exposing private information. Users can preview the content before it goes live, ensuring that only the intended information is shared with the public. The workflows provided, including UpdateDaemon, ReadDaemon, PreviewDaemon, and DeployDaemon, facilitate easy management of the daemon profile.

The architecture of the Daemon skill follows a two-repo pattern, separating public and private data. This design choice enhances security by ensuring that sensitive files are never accessed by the aggregator. The skill operates through a series of scripts and tools that work together to read from LifeOS sources, filter content, and deploy a static site to a public endpoint. The security philosophy emphasizes that all data is private by default, with explicit actions required to classify data as public.

Overall, Daemon is an essential tool for anyone looking to maintain a professional online presence while safeguarding their personal information. It streamlines the process of updating a public profile, allowing users to focus on their work without compromising their privacy.

When to use it

Use this skill when you need to automate the management of your public digital presence without exposing private data.

When not to use it

This skill is not suitable for general LifeOS system management tasks beyond public profile management.

What you can build with it

Automating Profile Updates

Use Daemon to automatically update your public profile with the latest projects and thoughts without manual input.

Previewing Public Content

Before deploying your profile, utilize the PreviewDaemon workflow to check what will be made public.

Ensuring Data Privacy

Leverage the security filter to ensure that sensitive information is never included in your public profile.

How to install Daemon

View source

1. Install with the skills CLI

npx skills add danielmiessler/lifeos/Daemon --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by danielmiessler

Customization

Before executing, check for user customizations at: ~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/Daemon/

If this directory exists, load and apply any SecurityOverrides.md or PREFERENCES.md found there. These override default security classification. If the directory does not exist, proceed with skill defaults.

Voice Notification

curl -s -X POST http://localhost:31337/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "Running the WORKFLOWNAME workflow in the Daemon skill to ACTION"}' \
  > /dev/null 2>&1 &

Daemon Skill

What It Does

Manages your public daemon profile — a living page of what you're working on, thinking about, reading, and building. It pulls data from your LifeOS system, runs it through a deterministic security filter so only publicly safe content survives, and deploys a static site. Workflows cover update, read, preview, and deploy.

The Problem

You want a public presence that stays current without hand-editing a profile page every week, and without ever leaking private data. Your real context lives in LifeOS — goals, projects, ideas, identity — mixed with things that must never go public: contacts, finances, health, names, paths, credentials. Manually copying the safe parts is slow and one slip publishes something you can't take back. This skill aggregates the safe sources, blocks the sensitive ones at the code level, and gives you a preview-then-approve gate before anything ships.

How It Works

The DaemonAggregator reads LifeOS sources and merges them into daemon-data.json; a deterministic SecurityFilter (pattern matching, not an LLM) strips names, paths, credentials, and internal refs; the deploy step builds a fully static site. Sensitive files are never opened by the aggregator at all.

Workflow Routing

WorkflowTriggerFile
UpdateDaemon"update daemon", "refresh daemon"Workflows/UpdateDaemon.md
ReadDaemon"read daemon", "check daemon", "daemon status"Workflows/ReadDaemon.md
PreviewDaemon"preview daemon", "daemon diff"Workflows/PreviewDaemon.md
DeployDaemon"deploy daemon", "push daemon", "ship daemon"Workflows/DeployDaemon.md

Architecture

Two-repo pattern: public framework + private content.

LifeOS SOURCES (private, read-only)
  TELOS/ (missions, goals, books, movies, wisdom)
  KNOWLEDGE/Ideas/ (title + thesis only)
  PROJECTS.md (public projects only)
  MEMORY/WORK/ (abstracted to topic themes)
  PRINCIPAL_IDENTITY.md (public bio data)
    │
    ├──[DaemonAggregator.ts]──→ Reads sources, merges with existing data
    │
    ├──[SecurityFilter.ts]──→ Deterministic code-level allowlist filter
    │                          Strips names, paths, credentials, internal refs
    │                          NOT an LLM filter — enforced by pattern matching
    │
    └──→ daemon-data.json → ~/Projects/daemon-dm/ (PRIVATE repo)
              │
              ├──[Tools/DeployGate.ts]──→ Deterministic pre-deploy gate (blocks on
              │                            expired/ungated ephemera, street-address/ZIP/
              │                            coordinate/home-area strings, unapproved
              │                            real-time phrasing, credentials, private feed URLs)
              │
              └──[deploy.sh]──→ Copies JSON into framework → VitePress build → Cloudflare WORKER
                                    │
                              ~/Projects/daemon/ (PUBLIC repo — forkable framework)
                                    │
                              src/worker.ts (generic):
                                • /daemon-data.json — served through the edge with expired
                                  ephemera STRIPPED at request time (status/now/offerings/
                                  requesting items with past `expires`; non-default location
                                  falls back to location_default)
                                • /feed.json — live-activity items aggregated every 30 min
                                  (cron + lazy refresh) from PUBLIC sources only, configured
                                  in daemon-data.json `feeds` (rss | beehiiv | github | x);
                                  cached in KV FEED_KV
                                • secrets (CF worker secrets, never in code): X_BEARER_TOKEN,
                                  BEEHIIV_API_KEY

    STRUCTURALLY EXCLUDED (never read):
          CONTACTS.md, FINANCES/, HEALTH/, TRAUMAS.md,
          KNOWLEDGE/People/, KNOWLEDGE/Companies/,

Skill Structure

skills/Daemon/
├── SKILL.md              (this file)
├── Tools/
│   ├── DaemonAggregator.ts   (reads LifeOS sources → daemon-data.json)
│   └── SecurityFilter.ts     (deterministic content sanitizer)
├── Workflows/
│   ├── UpdateDaemon.md       (aggregate → preview → approve → deploy)
│   ├── ReadDaemon.md         (read current daemon-data.json)
│   ├── PreviewDaemon.md      (show diff without deploying)
│   └── DeployDaemon.md       (bash deploy.sh from daemon-dm)
└── Docs/
    └── SecurityClassification.md  (public/private data categories)

Important Paths

PurposePath
Private data repo~/Projects/daemon-dm/
daemon-data.json~/Projects/daemon-dm/daemon-data.json
Deploy script~/Projects/daemon-dm/deploy.sh
Public framework repo~/Projects/daemon/
Security classification${LIFEOS_SKILL_DIR}/Docs/SecurityClassification.md
Security overrides${LIFEOS_USER_DIR}/SKILLCUSTOMIZATIONS/Daemon/SecurityOverrides.md

Live Endpoints

EndpointPurpose
daemon.example.comPublic website (Cloudflare Pages, fully static)

Security Philosophy

  1. Private by default: All data is private until explicitly classified as public
  2. Code-level enforcement: SecurityFilter.ts is deterministic pattern matching, NOT LLM judgment
  3. Structural exclusion: Sensitive files (CONTACTS, FINANCES, HEALTH) are never opened by the aggregator
  4. Defense in depth: Aggregator filter + SecurityFilter + pre-commit hook + manual approval
  5. Fail closed: If uncertain, exclude the content

Data Sources

The DaemonAggregator reads from these LifeOS sources:

SourceWhat's ExtractedSection
TELOS/MISSION.mdM1, M2 (public missions)[MISSION]
TELOS/GOALS.mdPublic project goals[TELOS]
TELOS/BOOKS.mdBook titles[FAVORITE_BOOKS]
TELOS/MOVIES.mdMovie titles[FAVORITE_MOVIES]
TELOS/WISDOM.mdTop 5 quotes[WISDOM]
KNOWLEDGE/Ideas/_index.md10 recent Ideas (title + thesis)[RECENT_IDEAS]
PROJECTS.mdPublic repos and sitesProjects integration
MEMORY/WORK/Topic themes (last 14 days)[CURRENTLY_WORKING_ON]
PRINCIPAL_IDENTITY.mdPublic bio, role, focus[ABOUT]
Existing daemon.mdPreserved sections (predictions, routine, podcasts, preferences)Various

For Community Forks

This skill is designed to be generic:

  1. Fork the public Daemon repo
  2. Create your own private data repo with daemon-data.json
  3. Configure with your own blocked names/paths
  4. The aggregator reads from standard LifeOS directory structure
  5. Use deploy.sh to build and deploy to your own Cloudflare Pages

Examples

Example 1: Full update cycle

User: "update daemon"
→ Aggregates LifeOS data sources
→ Applies security filter (deterministic)
→ Shows preview diff to user
→ User approves
→ Writes daemon-data.json to daemon-dm → deploys static site

Example 2: Check what's current

User: "check daemon"
→ Reads daemon-data.json from daemon-dm
→ Shows section-by-section status

Example 3: Preview before committing

User: "preview daemon"
→ Runs aggregator in preview mode
→ Shows diff against current daemon-data.json
→ No writes, no deploys

Gotchas

  • Two repos: Public framework (~/Projects/daemon/) and private content (~/Projects/daemon-dm/). The framework is forkable. The content is yours.
  • deploy.sh runs DeployGate FIRST, then copies data into the framework at build time, then cleans up. A gate failure blocks the deploy — fix the data, never bypass the gate. Personal data never gets committed to the public repo.
  • SecurityFilter is code, not prompts. If you need to add new blocked patterns, edit SecurityFilter.ts, not the workflow markdown.
  • Ephemera needs expires. status, now (via now_meta), time-bound offerings/requesting items, and any non-default location all carry ISO expires fields. Three enforcement layers: DeployGate (blocks), the worker (strips at serve time), the dashboard (hides client-side). Refreshing a stale status = edit daemon-data.json with a new expires and run deploy.sh.
  • Location doctrine: coarse by default, real-time by exception. City/region granularity only; street/ZIP/coordinate/home-area strings are gate-blocked. "Tonight/I'm at" phrasing requires an explicit realtime_approved: true on that item — reserved for events where the principal WANTS to be findable. No automatic GPS/calendar pipeline; location changes only on explicit command.
  • The live feed is public-exhaust only. The worker polls blog RSS, Beehiiv (official API), YouTube RSS, GitHub public events, and the owner's own X posts — already-published content, zero privacy risk by construction. Never add a LifeOS-internal source to feeds.
  • Beehiiv blocks RSS scrapers (403). The newsletter source uses the official Beehiiv API (type: "beehiiv" + BEEHIIV_API_KEY worker secret), not the /feed URL.
  • Serving is edge-dynamic, page shell is static. /daemon-data.json and /feed.json are computed per-request by the worker (run_worker_first); the rest is static assets. Data changes still require deploy.sh; feed content refreshes itself.
  • Public repo is a GENERATED template (2026-07-21, merge-back doctrine). github.com/danielmiessler/Daemon main is a clean generic template published from a scrubbed staging copy — never push the working tree directly. The working framework lives at ~/Projects/daemon (has {{PRINCIPAL_NAME}}'s analytics, Butterick fonts, favicons); the template excludes analytics, licensed fonts, favicons, and all personal content, and its identity is data-driven (owner_name/owner_handle/fork_url in daemon-data.json). Old Astro line preserved on branch astro-archive. To update the template: re-stage, run the identity/secret grep scan, ours-merge, fast-forward push.

Execution Log

After completing any workflow, append a single JSONL entry:

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"Daemon","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl

Frequently asked questions about Daemon

Similar skills