elias/oh-my-opencode
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
oh-my-opencode/src/hooks/AGENTS.md
YeonGyu-Kim a1fe0f8517 docs(agents): regenerate all AGENTS.md files with comprehensive codebase analysis 
- Regenerated root AGENTS.md with overview, structure, and complexity hotspots
- Regenerated all 7 subdirectory AGENTS.md files: hooks, tools, features, agents, cli, auth, shared
- Used 11 background explore agents for comprehensive feature and architecture analysis
- All files within size limits (root: 112 lines, subdirs: 57-68 lines)
- Includes where-to-look guide, conventions, anti-patterns, and agent model information

🤖 Generated with assistance of oh-my-opencode
2026-01-02 10:42:38 +09:00

2.9 KiB
Raw Permalink Blame History

HOOKS KNOWLEDGE BASE

OVERVIEW

22 lifecycle hooks intercepting/modifying agent behavior. Context injection, error recovery, output control, notifications.

STRUCTURE

hooks/
├── anthropic-context-window-limit-recovery/  # Auto-compact at token limit (554 lines)
├── auto-slash-command/         # Detect and execute /command patterns
├── auto-update-checker/        # Version notifications, startup toast
├── background-notification/    # OS notify on task complete
├── claude-code-hooks/          # settings.json PreToolUse/PostToolUse/etc
├── comment-checker/            # Prevent excessive AI comments
│   └── filters/                # docstring, directive, bdd, etc
├── compaction-context-injector/ # Preserve context during compaction
├── directory-agents-injector/  # Auto-inject AGENTS.md
├── directory-readme-injector/  # Auto-inject README.md
├── empty-message-sanitizer/    # Sanitize empty messages
├── interactive-bash-session/   # Tmux session management
├── keyword-detector/           # ultrawork/search keyword activation
├── non-interactive-env/        # CI/headless handling
├── preemptive-compaction/      # Pre-emptive at 85% usage
├── ralph-loop/                 # Self-referential dev loop
├── rules-injector/             # Conditional rules from .claude/rules/
├── session-recovery/           # Recover from errors (430 lines)
├── think-mode/                 # Auto-detect thinking triggers
├── agent-usage-reminder/       # Remind to use specialists
├── context-window-monitor.ts   # Monitor usage (standalone)
├── session-notification.ts     # OS notify on idle
├── todo-continuation-enforcer.ts # Force TODO completion
└── tool-output-truncator.ts    # Truncate verbose outputs

HOOK EVENTS

Event Timing Can Block Use Case
PreToolUse Before tool Yes Validate, modify input
PostToolUse After tool No Add context, warnings
UserPromptSubmit On prompt Yes Inject messages, block
Stop Session idle No Inject follow-ups
onSummarize Compaction No Preserve context

HOW TO ADD

  1. Create src/hooks/my-hook/
  2. Files: index.ts (createMyHook), constants.ts, types.ts (optional)
  3. Return: { PreToolUse?, PostToolUse?, UserPromptSubmit?, Stop?, onSummarize? }
  4. Export from src/hooks/index.ts

PATTERNS

  • Storage: JSON file for persistent state across sessions
  • Once-per-session: Track injected paths in Set
  • Message injection: Return { messages: [...] }
  • Blocking: Return { blocked: true, message: "..." } from PreToolUse

ANTI-PATTERNS

  • Heavy computation in PreToolUse (slows every tool call)
  • Blocking without actionable message
  • Duplicate injection (track what's injected)
  • Missing try/catch (don't crash session)