repoprompt-when-available

RepoPrompt When Available Hook

Codex and Claude Code hook that adds RepoPrompt guidance only when rp-cli can reach RepoPrompt.

The hook is intentionally quiet when RepoPrompt is unavailable. That keeps normal Codex and Claude Code sessions clean while still reminding the agent to use RepoPrompt MCP tooling when the local app is reachable.

What It Does

• Short-circuits silently on non-macOS platforms.
• Runs on SessionStart and PostCompact.
• Checks rp-cli -e windows with a short timeout.
• Emits SessionStart context using Codex hook-specific JSON.
• Emits plain reminder text after compaction.
• Mentions the rp-reminder skill only when that skill is installed in the user profile or a Claude Code plugin skill directory.

Install As A Codex Plugin

This repository is shaped as a Codex plugin payload and a marketplace root:

• .codex-plugin/plugin.json declares the plugin.
• hooks.json declares the hook events.
• .agents/plugins/marketplace.json makes the repository installable as a marketplace source.

With the repository published, install the marketplace with:

codex plugin marketplace add clairernovotny/repoprompt-when-available-hook

Install As A Claude Code Plugin

This repository also includes Claude Code plugin metadata:

• .claude-plugin/plugin.json declares the plugin.
• .claude-plugin/marketplace.json declares the marketplace entry.
• hooks.json is shared with the Codex plugin and referenced with ./hooks.json.

With the repository published, install the marketplace with:

claude plugin marketplace add clairernovotny/repoprompt-when-available-hook

Manual Hook Registration

For a direct user-profile hook install, copy scripts/hooks/repoprompt-when-available.js into your Codex hooks directory and register it in your user hooks.json:

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/repoprompt-when-available.js\"",
            "timeout": 3
          }
        ]
      }
    ],
    "PostCompact": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/repoprompt-when-available.js\"",
            "timeout": 3
          }
        ]
      }
    ]
  }
}

If you are not installing through the plugin runtime, replace ${CLAUDE_PLUGIN_ROOT} with the directory that contains this repository.

Development

npm test

The test suite stubs rp-cli, so it does not require RepoPrompt to be running.