cursor-subagent-start-context

hook SubagentStart cursor mode: context

Inject repository conventions and session context when a Cursor subagent starts.

Registry Entry

Field	Value
id	cursor-subagent-start-context
status_message	Gathering subagent context
mode	context
logical_event	SubagentStart
command	python3 {repo_root}/hooks/wagents-hook.py cursor-subagent-start-context --harness {harness}
timeout	5
harnesses	["cursor"]

Note

Maps to Cursor’s native subagentStart event. Context-tier (never blocks): subagent_start_context in wagents/hooks/policies/subagent_start.py formats a short message with git context and the managed-hook source, surfaced to the spawned subagent.

Full hook config + policy reference

config/hook-registry.json (entry)

{
  "id": "cursor-subagent-start-context",
  "description": "Inject repository conventions and session context when a Cursor subagent starts.",
  "status_message": "Gathering subagent context",
  "mode": "context",
  "logical_event": "SubagentStart",
  "command": "python3 {repo_root}/hooks/wagents-hook.py cursor-subagent-start-context --harness {harness}",
  "timeout": 5,
  "harnesses": [
    "cursor"
  ]
}

wagents/hooks/policies/subagent_start.py (context)

def subagent_start_context(git_context: str, *, source: str = "config/hook-registry.json") -> str:
    """Build the informational context message for a starting subagent."""
    ...

Command: python3 .../wagents-hook.py cursor-subagent-start-context --harness cursor

Resources

Hooks HubAll repo-managed lifecycle hooks.

wagents hooksInspect and validate hooks via CLI.

---

View source on GitHub