remindcc

Context injection for Claude Code via the UserPromptSubmit hook.

Store markdown files in .remindcc/ with trigger patterns. When your prompt matches a trigger, that file's content is injected as additional context.

Installation

Clone the repository

# From the remindcc directory
./install.sh

Ensure ~/.deno/bin is in your PATH:

export PATH="$HOME/.deno/bin:$PATH"

Configure Claude Code Hook

Add to .claude/settings.local.json:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "remindcc hook"
          }
        ]
      }
    ]
  }
}

Quick Start

# Initialize .remindcc/ directory
remindcc init

# Add an always-on reminder
remindcc add style-guide --content "Use TypeScript strict mode. Prefer const over let."

# Add a triggered reminder
remindcc add testing --trigger "word:test" --content "Run tests with: npm test"

# List all reminders
remindcc list

# Check for issues
remindcc check

Trigger Types

Type	Format	Description
phrase	phrase:fix bug	Exact substring match (case insensitive)
word	word:api	Word boundary match (won't match "rapid")
regex	regex:auth|login	Full regex pattern support
(none)	trigger: []	Always include

Multiple triggers use OR logic - any match includes the file.

File Format

Reminder files use YAML frontmatter:

---
trigger:
  - word:api
  - phrase:endpoint
  - regex:route|controller
---

# API Guidelines

Use REST conventions. All endpoints should return JSON.

Commands

Command	Description
init	Create .remindcc/ with example file
list	List all reminders with triggers
add <name>	Add new reminder (--trigger, --content)
append <name>	Append to existing reminder (--content)
update <name>	Update triggers and/or content
remove <name>	Delete a reminder file
check	Validate triggers and check for issues
instruct	Generate Claude instructions for managing reminders
hook	Process UserPromptSubmit hook (stdin JSON)

Examples

# Multiple triggers
remindcc add auth-rules \
  --trigger "word:auth" \
  --trigger "word:login" \
  --trigger "regex:jwt|token" \
  --content "Use bcrypt for passwords. JWT expires in 1h."

# Update content only
remindcc update auth-rules --content "New auth instructions here"

# Update triggers only
remindcc update auth-rules --trigger "word:security"

# Append additional content
remindcc append auth-rules --content "Remember to validate CSRF tokens."

How It Works

1. Claude Code calls remindcc hook on every prompt submission
2. The hook reads .remindcc/*.md files from the working directory (or parent directories)
3. Files with matching triggers (or empty triggers) are collected
4. Matched content is wrapped in <additional-user-instruction> tags and injected

Requirements

• Deno 1.40+
• Claude Code with hooks support