SkillAgentSearch skills...

Awareness-SDK

Local-first AI agent memory — one command, 13+ IDEs, works offline. Persistent memory for Claude Code, Cursor, Windsurf, OpenClaw. Zero-code interceptors for OpenAI/Anthropic. Python & TypeScript SDKs.

Install / Use

claude mcp add edwin-hao-ai -- npx -y github:edwin-hao-ai/Awareness-SDK

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

78/100

Supported Platforms

Claude Code
Claude Desktop
Cursor
Windsurf

Our assessment of Awareness-SDK

Awareness-SDK scores 78/100 on our quality scale, 787th of 942 AI & Machine Learning skills we index.

Its MCP Server is 9.6 KB long, well organised into 28 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-08-28 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 91/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Awareness-SDK compared with similar skills

All 4 of these similar skills score higher than Awareness-SDK; compare them before choosing.

SkillScoreStarsUpdatedFormat
Awareness-SDK (this skill)by edwin-hao-ai78107mo agoMCP Server
claude-memby thedotmack100118.1ktodayCLAUDE.md
Agent-Reachby Panniantong100112.9k10d agoCLAUDE.md
Understand-Anythingby Egonex-AI10093.1ktodayCLAUDE.md
hyperframesby heygen-com10086.2ktodayCLAUDE.md

Frequently asked questions

How do I install Awareness-SDK?
Run claude mcp add edwin-hao-ai -- npx -y github:edwin-hao-ai/Awareness-SDK. The install tabs above show the steps for each supported agent.
Which AI agents does Awareness-SDK work with?
It is written for Claude Code, Claude Desktop, Cursor and Windsurf, as a MCP Server file. Other agents that read the same format can often use it too.
Is Awareness-SDK safe to use?
It is Apache-2.0-licensed and scores 91/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is Awareness-SDK still maintained?
The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/awareness-wordmark-dark.svg"/> <img src="assets/awareness-wordmark.svg" alt="Awareness SDK — Persistent Memory for AI Agents" width="760"/> </picture> </p> <p align="center"> <img src="assets/local-20s.gif" alt="Awareness — Long-Term Memory for AI Agents" width="100%"/> </p> <p align="center"> <a href="https://awareness.market/"><img src="https://img.shields.io/badge/Website-awareness.market-0EA5E9?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Website"/></a> <a href="https://awareness.market/docs"><img src="https://img.shields.io/badge/Docs-awareness.market%2Fdocs-14B8A6?style=for-the-badge&logo=readthedocs&logoColor=white" alt="Docs"/></a> <a href="https://pypi.org/project/awareness-memory-cloud/"><img src="https://img.shields.io/badge/PyPI-awareness--memory--cloud-00D4FF?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"/></a> <a href="https://www.npmjs.com/package/@awareness-sdk/memory-cloud"><img src="https://img.shields.io/badge/npm-memory--cloud-7B68EE?style=for-the-badge&logo=npm&logoColor=white" alt="npm memory cloud"/></a> <a href="https://www.npmjs.com/package/@awareness-sdk/local"><img src="https://img.shields.io/badge/npm-local-22C55E?style=for-the-badge&logo=npm&logoColor=white" alt="npm local"/></a> <a href="https://discord.com/invite/nMDrT538Qa"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"/></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-2563EB?style=for-the-badge" alt="License Apache 2.0"/></a> </p> <p align="center"> <strong>Give your AI agent persistent memory across sessions.</strong><br/> Local-first MCP memory platform for AI coding agents, SDK apps, and production workflows.<br/> <a href="https://awareness.market/docs">Docs</a> · <a href="https://awareness.market">Cloud</a> · <a href="https://discord.com/invite/nMDrT538Qa">Discord</a> · <a href="#quick-start">Quick Start</a> </p>

Awareness SDK is a local-first memory layer for AI agents and AI coding workflows. It provides persistent memory, cross-session recall, hybrid retrieval, and easy integration through MCP, Python, and TypeScript SDKs.

Quick Navigation

FAQ

Does it work offline?

Yes. Local mode runs fully on your machine.

Is cloud required?

No. Cloud features are optional.

How do I add memory to an existing app?

Use AwarenessInterceptor.wrap_openai() / wrap_anthropic() (Python) or wrapOpenAI() / wrapAnthropic() (TypeScript).


Why Awareness?

AI agents forget everything when a session ends. Your agent spent hours making architectural decisions, fixing bugs, and planning next steps — and the next session starts from zero.

Awareness gives your AI agent persistent memory — it remembers what it built, what it decided, what's still pending, and why.

How It Works

Session 1: Agent makes decisions, fixes bugs, creates TODOs
    → awareness_record() saves everything as structured knowledge

Session 2: Agent starts fresh
    → awareness_init() loads context: "Last time you were working on JWT auth..."
    → awareness_recall() finds relevant past decisions
    → Agent picks up where it left off — no re-explaining needed

Quick Start

Option 1: One Command Setup (Recommended)

Works with Claude Code, Cursor, Windsurf, Cline, GitHub Copilot, Codex, and 7 more IDEs.

npx @awareness-sdk/setup

That's it. Your AI agent now has persistent memory. No account needed. Works offline.

Want cloud features later? npx @awareness-sdk/setup --cloud

Option 2: Zero-Code Interceptor (Python/TypeScript SDK)

The fastest way to add memory to existing AI apps. One line — zero code changes.

Python — AwarenessInterceptor.wrap_openai() / .wrap_anthropic()

pip install awareness-memory-cloud
from openai import OpenAI
from memory_cloud import AwarenessInterceptor

client = OpenAI()

# Local mode (no API key needed — data stays on your machine)
interceptor = AwarenessInterceptor(mode="local")

# Cloud mode (team collaboration, semantic search, multi-device sync)
interceptor = AwarenessInterceptor(api_key="aw_...", memory_id="...")

# One line — all conversations automatically remembered
interceptor.wrap_openai(client)

# Use OpenAI as normal — memory happens in the background
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Refactor the auth module"}]
)

TypeScript — AwarenessInterceptor.wrapOpenAI() / .wrapAnthropic()

npm install @awareness-sdk/memory-cloud
import OpenAI from "openai";
import { AwarenessInterceptor } from "@awareness-sdk/memory-cloud";

const openai = new OpenAI();

// Local mode (no API key needed — data stays on your machine)
const interceptor = new AwarenessInterceptor({ mode: "local" });

// Cloud mode (team collaboration, semantic search, multi-device sync)
const interceptor = new AwarenessInterceptor({ apiKey: "aw_...", memoryId: "..." });

// One line — all conversations automatically remembered
interceptor.wrapOpenAI(openai);

// Use as normal — memory happens in the background
const response = await openai.chat.completions.create({
  model: "gpt-4",
  messages: [{ role: "user", content: "What did we decide about the database?" }],
});

Option 3: IDE Plugins

Claude Code

/plugin marketplace add edwin-hao-ai/Awareness-SDK
/plugin install awareness-memory@awareness

Skills: /awareness-memory:session-start · /awareness-memory:recall · /awareness-memory:save · /awareness-memory:done

Documentation · Online docs

OpenClaw

# Plugin (full integration):
openclaw plugins install @awareness-sdk/openclaw-memory

# Or Skill (via ClawHub):
npx clawhub@latest install awareness-memory

Auto-recall on session start. Auto-capture on session end. Zero configuration.

Documentation · npm


Features

| Feature | Local | + Cloud | |---------|-------|---------| | Persistent memory across sessions | ✅ | ✅ | | 13+ IDE support (Claude Code, Cursor, Windsurf...) | ✅ | ✅ | | Zero-code interceptor (wrap_openai / wrap_anthropic) | — | ✅ | | Knowledge card extraction (decisions, solutions, risks) | ✅ | ✅ + LLM | | Workflow rules injection (agent auto-recalls) | ✅ | ✅ | | Full-text + semantic search | ✅ | ✅ | | Progressive disclosure (summary → full) | ✅ | ✅ | | Cross-device sync | Git | Real-time | | Semantic vector search (100+ languages) | — | ✅ | | Multi-agent collaboration | ✅ | ✅ | | Memory marketplace | — | ✅ | | Team collaboration | — | ✅ |

Local-First Architecture

Your machine                          Cloud (optional)
┌─────────────────────┐              ┌─────────────────┐
│  .awareness/        │   sync →     │  Awareness Cloud │
│  ├── memories/*.md  │   ← sync    │  (semantic search│
│  ├── knowledge/     │              │   team sync,     │
│  └── index.db       │              │   marketplace)   │
│                     │              └─────────────────┘
│  Daemon :37800      │
│  ├── FTS5 search    │
│  ├── MCP server     │
│  └── Web dashboard  │
└─────────────────────┘
  • Data stays on your machine by default
  • Works offline — no internet required
  • Markdown files — human-readable, git-friendly, portable
  • Cloud is optional — one click to enable sync, semantic search, team features

Packages

| Package | Description | Install | |---------|-------------|---------| | @awareness-sdk/local | Local daemon + MCP server | npx @awareness-sdk/local start | | @awareness-sdk/setup | CLI setup for all 13+ IDEs | npx @awareness-sdk/setup | | awareness-memory-cloud | Python SDK with interceptors | pip install awareness-memory-cloud | | @awareness-sdk/memory-cloud | TypeScript SDK with interceptors | npm i @awareness-sdk/memory-cloud | | @awareness-sdk/openclaw-memory | OpenClaw plugin | openclaw plugins install @awareness-sdk/openclaw-memory | | claudecode/ | Claude Code plugin | /plugin marketplace add edwin-hao-ai/Awareness-SDK then /plugin install awareness-memory@awareness |


Integrations

Works with any AI framework:


Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | AWARENESS_MCP_URL | MCP endpoint | http://localhost:37800/mcp | | AWARENESS_API_KEY | Cloud API key (aw_...) | — (local mode: not needed) | | AWARENESS_MEMORY_ID | Cloud memory ID | — (local mode: auto) | | AWARENESS_AGENT_ROLE | Agent role filter | builder_agent |


Contributing

Contributions welcome! Please open an issue or pull request.

License

Apache 2.0

Related Skills

View on GitHub
GitHub Stars10
CategoryAI
Updated6mo ago
Forks1

Languages

JavaScript

Trust signals

91/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low1 info