cursor-session-start-context

hook SessionStart cursor mode: context

Report lightweight Cursor session and repository context.

Registry Entry

Field	Value
id	cursor-session-start-context
status_message	Gathering Cursor session context
mode	context
logical_event	SessionStart
matcher	startup|resume|clear
command	python3 {repo_root}/hooks/wagents-hook.py cursor-session-start-context --harness {harness}
timeout	5
harnesses	["cursor"]

Note

Uses the shared wagents-hook.py dispatcher (policy: _policy_codex_session_start_context). Provides git context + note that hooks are sourced from registry.

Full hook config + command reference

config/hook-registry.json (entry)

{
  "id": "cursor-session-start-context",
  "description": "Report lightweight Cursor session and repository context.",
  "status_message": "Gathering Cursor session context",
  "mode": "context",
  "logical_event": "SessionStart",
  "matcher": "startup|resume|clear",
  "command": "python3 {repo_root}/hooks/wagents-hook.py cursor-session-start-context --harness {harness}",
  "timeout": 5,
  "harnesses": [
    "cursor"
  ]
}

hooks/wagents-hook.py (relevant policy + dispatcher)

# ... (full file at repo root; key entrypoints below)
def _policy_codex_session_start_context(payload: NormalizedPayload) -> int:
    message = (
        f"Cursor session context: {_git_session_context(payload.cwd)}; managed hooks source=config/hook-registry.json."
    )
    return _additional_context(payload, message, policy_id="cursor-session-start-context")

# main dispatch
POLICIES = {
    "cursor-session-start-context": _policy_codex_session_start_context,
    ...
}
if __name__ == "__main__":
    raise SystemExit(main())

Command executed (after template expansion for Cursor harness): python3 /path/to/repo/hooks/wagents-hook.py cursor-session-start-context --harness cursor

See full wagents-hook.py and _git_session_context for implementation.

Resources

Hooks HubAll repo-managed lifecycle hooks.

wagents hooksInspect and validate hooks via CLI.

---

View source on GitHub