YeonGyu-Kim
5759a9c503
Updated root + 14 core subdirectory AGENTS.md files to reflect current
state (commit 2892ca4a on dev). Added 4 new AGENTS.md files for gap
directories: hooks/comment-checker (AI slop blocker), features/claude-
code-plugin-loader (CC compat layer), features/claude-code-mcp-loader
(tier 2 MCP loader), cli/doctor (health diagnostics with 25 check files).
42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
# src/hooks/claude-code-hooks/ — Claude Code Compatibility
|
|
|
|
**Generated:** 2026-04-18
|
|
|
|
## OVERVIEW
|
|
|
|
~2110 LOC across 19 files. Provides Claude Code settings.json compatibility layer. Parses CC permission rules and maps CC hooks (PreToolUse, PostToolUse) to OpenCode hooks.
|
|
|
|
## WHAT IT DOES
|
|
|
|
1. Parses Claude Code `settings.json` permission format
|
|
2. Maps CC hook types to OpenCode event types
|
|
3. Enforces CC permission rules (allow/deny per tool)
|
|
4. Supports CC `.claude/settings.json` and `.claude/settings.local.json`
|
|
|
|
## CC → OPENCODE HOOK MAPPING
|
|
|
|
| CC Hook | OpenCode Event |
|
|
|---------|---------------|
|
|
| PreToolUse | tool.execute.before |
|
|
| PostToolUse | tool.execute.after |
|
|
| Notification | event (session.idle) |
|
|
| Stop | event (session.idle) |
|
|
|
|
## PERMISSION SYSTEM
|
|
|
|
CC permissions format:
|
|
```json
|
|
{
|
|
"permissions": {
|
|
"allow": ["Edit", "Write"],
|
|
"deny": ["Bash(rm:*)"]
|
|
}
|
|
}
|
|
```
|
|
|
|
Translated to OpenCode tool restrictions via permission-compat in shared/.
|
|
|
|
## FILES
|
|
|
|
Key files: `settings-loader.ts` (parse CC settings), `hook-mapper.ts` (CC→OC mapping), `permission-handler.ts` (rule enforcement), `types.ts` (CC type definitions).
|