System Online

Give Your Claude Code Long-Term Memory

Install the Awareness plugin for Claude Code — persistent, structured memory with skills and hooks across sessions.

One-Click Install Manual Setup Full Documentation

Select Memory Project

Loading memories...

API Key

Saved automatically

Agent Roles

builder_agent

One-Click Install - Let Claude Code Do It

Copy this prompt and paste it into your Claude Code session. It will install the Awareness Memory plugin with skills, hooks, and MCP tools automatically.

Help me install the Awareness Memory plugin for Claude Code. Follow these steps exactly:

1. Add the Awareness plugin marketplace:
   Run this in your Claude Code session: /plugin marketplace add edwin-hao-ai/Awareness-SDK

2. Install the plugin:
   Run: /plugin install awareness-memory@awareness

3. After installation, update the plugin settings with my credentials.
   Find the plugin's settings.json and set these values:
   {
     "env": {
       "AWARENESS_MCP_URL": "https://awareness.market/mcp",
       "AWARENESS_MEMORY_ID": "<MEMORY_ID>",
       "AWARENESS_API_KEY": "<API_KEY>",
       "AWARENESS_AGENT_ROLE": "builder_agent"
     }
   }

   - Ask me for my Awareness API key (starts with "aw_")
   - Ask me for my Memory ID (UUID format)
4. Verify the installation:
   - Run /mcp to confirm "awareness-memory" appears in the MCP server list
   - Check that skills are available: /awareness-memory:session-start
   - Test the connection by calling: awareness_init with source="claude-code"

If any step fails, show me the error and suggest a fix.

You will need your API Key and Memory ID from the Settings page. Claude Code will ask you for them during setup.

Why Awareness for Claude Code?

Cross-Session Memory

Claude Code remembers past decisions, code changes, and architecture across sessions - no more repeating context.

Structured Knowledge

Auto-extracts KnowledgeCards, Risks, and ActionItems - your codebase knowledge grows with every session.

Semantic Recall

Hybrid vector + full-text search finds the most relevant past context before you start coding.

Multi-User & Multi-Role

Team projects with per-user memory isolation. Each role sees its own relevant knowledge.

Knowledge Evolution

Conflict detection auto-supersedes outdated decisions. Your knowledge base stays current.

Cross-IDE Portability

Same memory works in Cursor, VS Code, OpenClaw, or any MCP-compatible IDE.

Manual Setup

Step 1: Add Plugin Marketplace

Run this command in your Claude Code session to add the Awareness plugin marketplace:

/plugin marketplace add edwin-hao-ai/Awareness-SDK

Step 2: Install Plugin

Run this command in your Claude Code session to install the Awareness Memory plugin:

/plugin install awareness-memory@awareness

Step 3: Configure Credentials

Update the plugin's settings.json with your API key and Memory ID:

{
  "env": {
    "AWARENESS_MCP_URL": "https://awareness.market/mcp",
    "AWARENESS_MEMORY_ID": "YOUR_MEMORY_ID",
    "AWARENESS_API_KEY": "YOUR_AWARENESS_API_KEY",
    "AWARENESS_AGENT_ROLE": "builder_agent"
  }
}

Get your API key and Memory ID from the Settings page.

Step 4: Verify

/mcp

You should see awareness-memory in the MCP server list with all 4 skills available.

Available Skills

Skill	Command	When to Use
session-start	/awareness-memory:session-start	Start of every session
recall	/awareness-memory:recall <query>	Before implementing anything
save	/awareness-memory:save	After completing a step
done	/awareness-memory:done	End of session

MCP Tools Available

Tool	Description
awareness_init	Initialize session + load context (narratives, tasks, knowledge cards)
awareness_recall	Semantic + keyword hybrid search across all memories
awareness_lookup	Structured data: context, tasks, knowledge, risks, timeline, rules, graph, agents
awareness_record	Write: unified content recording with inline insights, update_task
__awareness_workflow__	Workflow checklist — call when unsure what to do next

Feature Comparison

Capability	No Memory	CLAUDE.md Only
Cross-session recall	—
Structured knowledge extraction	—	—
Conflict detection & supersede	—	—
Task tracking (ActionItems)	—	—
Risk identification	—	—
Multi-user isolation	—	—
Knowledge graph (entities)	—	—
Daily narratives	—	—
Cross-IDE portability	—	—
Memory marketplace	—	—

Troubleshooting

Problem	Solution
Plugin not appearing after install	Make sure you added the marketplace first. Restart Claude Code after installation.
401 Unauthorized	Verify your API key in the plugin settings. Keys start with aw_.
Skills not appearing	Run /mcp to check connection status. Try /reload-plugins to refresh.
Cloud endpoint	Set AWARENESS_MCP_URL to https://awareness.market/mcp in the plugin settings.json.