Open source · Self-hosted · MCP

Your AI's memory shouldn't be locked to one app. It should follow you everywhere.

Awareness is a portable knowledge store for your life. Tell one AI about your health, your projects, your preferences — and every AI you use knows it. Permanently, portably, privately.

The problem
Every AI platform keeps its own memory silo. You workshop a design in Claude Desktop, then switch to Claude Code to build it — and none of that context comes with you.
You spend an hour refining an architecture in Claude Desktop. Open Claude Code to implement it — it has no idea what you just decided.
You tell one AI your project roadmap, your preferences, your constraints. Switch to Cursor to write code — you're explaining everything from scratch.
Every conversation starts from zero. Your knowledge evaporates at the end of each chat.
How it works

Your AI reads a briefing. Every conversation.

A compact summary of what matters right now — fired intentions, source health, active alerts, or silence confirming everything was checked.

get_briefing — Claude.ai
{
  "attention_needed": true,
  "sources": {
    "garmin": {
      "status": "warning",
      "headline": "Sleep score 72 (below 7-day avg 81)",
      "drill_down": "awareness://status/garmin"
    },
    "nas": { "status": "ok" },
    "homeassistant": { "status": "ok" }
  },
  "fired_intentions": [
    { "goal": "Schedule dermatology follow-up", "source": "personal" }
  ],
  "active_alerts": 1,
  "pending_intentions": 3,
  "summary": "1 warning (garmin). 1 intention fired.",
  "suggested_mention": "Garmin: sleep score 72. Reminder: schedule derm follow-up."
}
 
// Your AI knows you slept poorly, a reminder fired,
// and your NAS and home are fine. You explained nothing.
Get started

Five minutes to portable memory.

01

Deploy

docker compose up -d starts awareness with Postgres. Or run the install script for a guided setup. No cloud account needed — everything runs on your machine.

02

Connect

Add one MCP server URL to Claude Desktop, Claude Code, Cursor, or any MCP client. Every connected AI reads the same briefing and writes to the same store.

03

Accumulate

Say "remember my dentist is Dr. Park" in any conversation. It's stored with tags, timestamps, and changelog. Every AI you use can retrieve it from now on.

Cross-platform

One brain. Every AI.

Tell your AI about a medication on your phone. Ask about drug interactions on your laptop. Awareness is the portable layer that makes all your AI tools feel like one system.

awareness
Awareness
Mobile
Claude.ai
Claude Code
Cursor /
VS Code
Use cases

What you can do with it.

For building

Cross-platform dev

Start a feature in Claude Code, discuss the design in Claude.ai, review in Cursor. Decisions and project context follow you without re-explaining.

"What's the status of the awareness project?"

Homelab monitoring

NAS, Proxmox, Docker — edge daemons report status and awareness tells your AI before you ask. Silence confirms things are fine.

"Is anything wrong with my servers?"

Decision trail

Every entry is timestamped and changelog-tracked. Why that architecture? Why that financial choice? The reasoning is preserved at the moment you decided.

"Why did we pick Postgres over SQLite last month?"

For living

Everyday life

Your fridge model number. Your wedding anniversary. The fact that you tend to overdress when it's cold. Tell one AI, and every AI you use knows — forever.

"My fridge is a Samsung RS25H5111BC — save that for when I need parts."

Intentions & reminders

You said "remind me to call the dentist next Tuesday" and then forgot. Wednesday morning you open Claude — it already knows. The reminder fired overnight and is waiting in your briefing.

"Oh right — I still need to call the dentist."

Personal knowledge base

Insurance policy numbers, family contacts, financial accounts. Tell your AI once and it's stored with type, tags, and timestamps. No re-explaining, ever.

"My HSA account number is 4821 — save that."
Vision

The product is silence.

Awareness checks your systems, your health data, your reminders — every conversation. When nothing needs your attention, it says so. No notification. No interruption. Just quiet confirmation that everything was checked and everything is fine.

When something does need you, it surfaces exactly that — and nothing else. An attention firewall, not another notification source.

Personal

One person's knowledge, portable across every AI. Working today.

Family

Shared household store. Who's picking up the kids? When was the furnace serviced?

Team

Project knowledge that accumulates through work, not meetings.

Community

Institutional memory for orgs with zero software budget.

Origin

Born from a single memory instruction.

What started as a homelab monitoring experiment turned into a portable knowledge layer for your entire life. A single line in Claude's memory — “check the NAS health on each conversation” — worked surprisingly well. The AI applied contextual judgment, learned what was normal, and surfaced what wasn't.

But it had obvious limits. Knowledge was locked to one platform. It only worked with one system. Diagnostics weren't captured at detection time.

Awareness is the generalization of that experiment — multi-source, multi-platform, portable knowledge that any AI agent can read and write.

Read the original idea that started it all →

Try it in five minutes.

One command. No account needed. Your data stays on your machine.

curl -sSL https://raw.githubusercontent.com/cmeans/mcp-awareness/main/install-demo.sh | bash