Open-source skeleton · MIT

An AI that stays on, pays attention, and speaks up.

Daimon is an open-source skeleton for persistent, self-aware AI agents. It runs on a VPS, remembers everything in git-tracked markdown, and gets sharper the longer it runs. Built for support, PR review, on-call, community, sales — anywhere a stream of input meets a human who needs help making sense of it.

View on GitHub — daimon-sh/daimon-skeleton
This is Daimon thinking. Everything you see is a file in a git repo.
The idea

One AI. Always on. Never forgets.

Always on.

Daimon runs as a long-lived Claude Code session under systemd on a cheap VPS. It doesn't wake up when you ask it something — it was already listening.

Remembers in markdown.

Every conversation, learning, correction, and pattern lives in a git-tracked markdown file. No vector DB, no black box. The database is your repo.

Speaks up rarely.

Daimon doesn't spam. It uses noticing — absence, trend, connection — to say something only when it's worth saying. Scheduled dream passes consolidate, verify, and connect in the background.

The stack

Daimon is a skeleton. You pick the body.

A channel.

Telegram today; Intercom, Discord, Slack, GitHub, email tomorrow. Swap the input, keep the brain.

Routes.

Rules for what to do with each kind of input — spam, FAQ, bug, feature request, check-in, anomaly. Your rules, your routes.

Modules.

Pluggable extensions that track what you care about — health, finances, incidents, deals, anything. Each is a folder with a MODULE.md.

Shadow mode.

Every reply is a draft until a human says otherwise. Routes graduate to auto-reply only after they've proven themselves against real judgments.

How it works

The loop.

Same six steps, every run. The brain is identical across use cases — the only thing that changes is the channel and the routes.

  1. 01
    Listen

    Channel in, message captured, attributed, journaled.

  2. 02
    Understand

    Context lookup, disambiguation, history check.

  3. 03
    Classify

    Route the input per the rules you define.

  4. 04
    Research

    Read docs, code, past memory — whatever the route needs.

  5. 05
    Draft

    Internal analysis + proposed action. Shadow by default.

  6. 06
    File & follow up

    Commit memory, file tickets, schedule follow-ups.

Poll on a schedule. Consolidate during dream passes. Commit everything to git. That's the whole system.

Principles

Why it's shaped this way.

  • Markdown is the database. Git is the memory. The AI is the query engine.
  • Awareness, not analysis. Noticing patterns beats generating reports.
  • Ambient over direct. The thoughtful grandmother in the room speaks rarely and is worth more than the security camera.
  • Shadow first. Trust is earned per route, not granted up front.
  • Dormant is not dead. Archive is a real state; nothing is deleted.
  • Yours to own. Your install is a private repo. Your data never leaves your VPS.
Under the hood

No black box.

Claude Code, not an API.

Daimon is a persistent agent with full tool access — reads your codebase, queries your databases, uses your MCPs. Not a thin wrapper around a chat endpoint.

Cheap to run.

A $5–10/mo VPS and a Claude subscription. That's the whole operating cost.

Upgrade by git.

A new release is a git pull. Your data is protected by .gitattributes ours-merge — engine files update, your memory stays untouched.

Build your own.

MIT licensed. Runs on your infra. Your data, your repo, your agent.