SessionStart

SessionStart is a hook for coding agents from edwin-hao-ai/Awareness-SDK. Its token cost is not measured, scanned A, original, Apache-2.0.

A session-start hook that runs a Node.js setup script when a session begins and starts or checks the Awareness Memory service.

In plain words
What is it for?
It is for checking local or cloud configuration, starting the local daemon when needed, and reporting whether Awareness Memory is ready.
Why use it?
It reduces manual setup by making the memory connection ready at the beginning of a session.

Hook

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the awareness-memory plugin — 5 skills, 4 hooks, 1 MCP server shipped together

One of 4 entries in hooks.json — they are configured in one file and arrive together.

Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

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

Or install awareness-memory, the plugin that ships this one along with the rest of its 5 skills, 4 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for SessionStart

README.md
[![agentmods](https://agentmods.dev/badge/hooks/edwin-hao-ai/awareness-sdk/session-start.svg)](https://agentmods.dev/hooks/edwin-hao-ai/awareness-sdk/session-start)
Your own site
<a href="https://agentmods.dev/hooks/edwin-hao-ai/awareness-sdk/session-start"><img src="https://agentmods.dev/badge/hooks/edwin-hao-ai/awareness-sdk/session-start.svg" alt="Measured on agentmods" height="20"></a>
Per session not measured What this adds to a session before it is invoked.
When invoked not measured Not applicable: nothing here is loaded into a session.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Security

Grade A, and why

SessionStart scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the commands this hook runs, not an audit. A hook is shell that executes on your machine at the event it names, which is why every command in it is printed with what was found.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

"command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/ensure-mcp.js\" 2>/dev/null; FIRST_RUN=0; if curl -sf http://localhost:37800/healthz > /dev/null 2>&1; then echo '[Awareness Memory] Ready. Dashboard: http://localhost:378
claudecode/hooks/hooks.json · 13 lines

What it actually says

{
  "SessionStart": [
    {
      "matcher": "",
      "hooks": [
        {
          "type": "command",
          "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/ensure-mcp.js\" 2>/dev/null; FIRST_RUN=0; if curl -sf http://localhost:37800/healthz > /dev/null 2>&1; then echo '[Awareness Memory] Ready. Dashboard: http://localhost:37800'; elif [ -n \"$AWARENESS_API_KEY\" ] && [ \"$AWARENESS_API_KEY\" != \"aw_your-api-key-here\" ] && [ -n \"$AWARENESS_MEMORY_ID\" ] && [ \"$AWARENESS_MEMORY_ID\" != \"your-memory-id-here\" ]; then echo '[Awareness Memory] Cloud mode ready.'; else FIRST_RUN=1; echo '[Awareness Memory] Installing & starting local daemon (first time may take ~30s)...'; npx -y @awareness-sdk/local start > /dev/null 2>&1 & for i in $(seq 1 30); do sleep 1; if curl -sf http://localhost:37800/healthz > /dev/null 2>&1; then echo '[Awareness Memory] Ready. Dashboard: http://localhost:37800'; break; fi; done; fi; if [ $FIRST_RUN -eq 1 ] && curl -sf http://localhost:37800/healthz > /dev/null 2>&1; then if command -v open > /dev/null 2>&1; then open http://localhost:37800; elif command -v xdg-open > /dev/null 2>&1; then xdg-open http://localhost:37800; fi; fi"
        }
      ]
    }
  ]
}
Same file

What else hooks.json configures

This page is one entry in a file that holds 4. Installing the file brings all of them; each is measured and scanned on its own page.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 13 lines scan A b3f7cfed3ae6

Subscribe to this mod's changes

SessionStart is a hook published in the GitHub repository edwin-hao-ai/Awareness-SDK (9 stars, last pushed 4mo ago), licensed Apache-2.0. Its token cost is not measured: a hook is shell that never enters the context. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.