Awareness Cloud Memory

You have access to persistent cloud memory. Memory persists across sessions, devices, and projects.

Automatic Hooks (no action needed)

Hooks run automatically — you don't need to do anything:

• - Before each prompt: Past context is injected as <awareness-memory> XML
• After each response: A checkpoint is saved to memory

Manual Tools

When you need more control beyond automatic hooks, use these Bash commands. All scripts are at ${CLAUDE_SKILL_DIR}/scripts/.

1. Initialize Session

Load cross-session context (summaries, tasks, knowledge cards):

CODEBLOCK0

Call this ONCE at session start if the auto-recall didn't provide enough context.

2. Search Memory (awareness_recall)

Semantic + keyword hybrid search for past decisions, solutions, and knowledge:

CODEBLOCK1

Parameters:

• - keyword_query — 2-5 precise terms (file names, function names, error codes)
• INLINECODE3 — all (default), timeline, knowledge, insights
• INLINECODE4 — max results (default 6, max 30)
• INLINECODE5 — hybrid (default), precise, session, structured, auto
• INLINECODE6 — weight for semantic search (default 0.7)
• INLINECODE7 — weight for keyword search (default 0.3)
• INLINECODE8 — broader context across sessions
• INLINECODE9 — topic-based context expansion
• INLINECODE10 — summary (lightweight) or full (complete content)
• INLINECODE11 — expand specific items from a prior summary call
• INLINECODE12 — filter by user

Call BEFORE starting work to avoid re-solving solved problems.

3. Record to Memory (awareness_record)

Save decisions, implementations, and learnings:

CODEBLOCK2

Call AFTER every meaningful action. If you don't record it, it's lost.

4. Lookup Structured Data (awareness_lookup)

Fast DB queries without vector search (<50ms):

CODEBLOCK3

Use lookup instead of search when you know WHAT you want (type-based, not semantic).

5. Get Agent Prompt (sub-agent spawning)

Fetch the activation prompt for a specific agent role:

CODEBLOCK4

Use the returned prompt as the sub-agent's system prompt for memory isolation.

Workflow Checklist

Follow this workflow every session:

1. 1. Session start: Auto-recall hook loads context. If insufficient, run init.js manually.
2. Before work: Search memory for relevant past context with search.js.
3. After each change: Record what you did and WHY with record.js.
4. Handle insights: When you make decisions or identify risks, use --with-insights to create searchable knowledge cards.
5. Session end: Auto-capture hook saves a checkpoint.

Setup

One-click setup (recommended)

Run this command — it opens your browser, you sign in, and everything is configured automatically:

CODEBLOCK5

The setup script will:

1. 1. Open your browser to sign in / register
2. You click "Authorize" — that's it
3. Auto-create or select a memory
4. Write AWARENESS_API_KEY and AWARENESS_MEMORY_ID to your shell profile

Other setup commands:
CODEBLOCK6

Manual setup (alternative)

Set environment variables directly:

CODEBLOCK7

Local mode (privacy-first, no account needed)

CODEBLOCK8

Not configured?

If the auto-recall hook outputs nothing (no <awareness-memory> block appears), the skill is not configured. Run the setup script above or tell the user to run it.