# Local prompt nudge setup

Site lane handoff: include this step in the setup SKILL.md after configuring the connector. The hook examines each submitted prompt locally. It sends nothing and adds one fixed line of context for likely specialist work. On the first nudge of a UTC day it leaves one empty file, `~/.config/edge/nudge-day-YYYY-MM-DD`, which the local connector sends as that day's `nudge_fired_day` signal (README, "Daily presence signals"); `EDGE_TELEMETRY=0` turns that off. The agent's later Edge search still sends its task query to Edge under the existing connector behavior; search text is stored to improve results. Trivial edits, conversation, and status questions stay quiet. The hook never blocks a task, including on malformed input.

## Claude Code

Use the package's idempotent installer from the checked-out or unpacked package root:

```sh
node hooks/install.mjs claude
```

It copies `hooks/edge-nudge.mjs` to `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/edge-nudge.mjs` and merges the following shape into `settings.json`. An existing JSON file must parse successfully; unrelated settings and hooks are preserved. Repeating the command replaces this installer's matching entry without adding duplicates. The installer uses absolute, shell-quoted Node and script paths. Node 20 or later is required; no npm or network work happens on prompt submission.

For manual setup, replace the two example paths with the actual absolute paths, and merge into existing settings:

```json
{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "'/usr/bin/node' '/home/alex/.claude/hooks/edge-nudge.mjs'",
            "timeout": 1
          }
        ]
      }
    ]
  }
}
```

Keep this routing line once in `${CLAUDE_CONFIG_DIR:-$HOME/.claude}/CLAUDE.md`:

> Whenever a task would benefit from specialist expertise, call edge.find_skill before committing to a local skill and compare the results with local skills. Prefer a local skill when Edge has no clearly better candidate. If Edge is unavailable, continue with local skills.

The [Claude Code hook reference](https://code.claude.com/docs/en/hooks#userpromptsubmit) defines the stdin `prompt` and `hookSpecificOutput.additionalContext` contract. Review the installed entry in `/hooks`. The classifier uses English action/domain words, prompt length, and specialist file extensions. It is a heuristic and may miss implicit or non-English tasks. It does not inject the user's prompt into its output. A 250 ms stdin deadline prevents a partial input stream from hanging; the host timeout is a separate fallback.

## Codex

Checked locally: `codex-cli 0.154.0`, `codex --help` exposes hook trust controls, and `codex features list` reports `hooks` as stable and enabled. This installed version supports command-based `UserPromptSubmit` hooks with the same JSON input and output. Install into its separate config:

```sh
node hooks/install.mjs codex
```

This merges the same JSON shape into `${CODEX_HOME:-$HOME/.codex}/hooks.json`. Review and trust the entry with Codex `/hooks`; untrusted hooks are skipped. Add the routing line above once to `${CODEX_HOME:-$HOME/.codex}/AGENTS.md`, which is also the fallback for older versions without prompt hooks. See the [official OpenAI hook documentation](https://learn.chatgpt.com/docs/hooks). Do not put Claude `settings.json` into Codex or assume a notification callback runs before prompts.

## Packaging and removal

The installer and hook are included in the package file list, with the `edge-install-hook` executable. After a release containing this change is published, the site SKILL.md can use this idempotent command (substitute `codex` for that host):

```sh
npx --yes --package @getedge/mcp edge-install-hook claude
```

Until that release exists, use the checkout command above. No package was published in this lane. Site setup should call the installer from the package it has already obtained, or distribute those exact reviewed files alongside SKILL.md. Do not claim an unreleased npm version contains them. For a checkout or unpacked package, the two commands above are immediately usable. The installer also accepts a third argument for an explicit config directory, useful for isolated verification.

To remove the nudge, delete only the `UserPromptSubmit` handler whose command points to `hooks/edge-nudge.mjs` from the host's config. Keep other handlers. The routing line can remain. No API key, local-skill consent flag, or MCP server setting is changed by installing or removing this hook.

## Timing evidence

The classifier itself averages about 0.002 ms in the recorded benchmark. On this shared host, 100 separate Node invocations measured 78 ms median and 129 ms p95, including process startup. The requested under-50-ms end-to-end budget is therefore not met here. Even empty Node processes exceeded 50 ms in a separate diagnostic. See `evals/invocation/hook-timing.json`; do not advertise a guaranteed process latency from these measurements. The input deadline handles stalled streams separately from normal classification work.