cursor-hooks
File-based agent loop hooks via `.cursor/hooks.json` — pre/post commands, governance gates. Use when enforcing policy without modifying agent prompts.
معلومات المصدر
- المستودع
- HKTITAN/cursor-sdk
- آخر نشاط في المصدر
- ٣ مايو ٢٠٢٦ في ٠٨:٢٣
- لغة SKILL.md المكتشفة
- الإنجليزية
- النجوم
- ٢
- التفرعات
- ٠
خيارات التثبيت
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
مراجعة ملفات المصدر
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
مستكشف الملفات
4 ملفاتعرض SKILL.md
SKILL.md
تعليمات المصدر · معاينة للقراءة فقط- name
- cursor-hooks
- description
- File-based agent loop hooks via `.cursor/hooks.json` — pre/post commands, governance gates. Use when enforcing policy without modifying agent prompts.
- metadata
- {"internal":false,"source":"https://cursor.com/docs/sdk/typescript"}
# cursor-hooks
Hooks are **file-based**, not programmatic. The SDK does not expose JS callbacks for the agent loop — use `.cursor/hooks.json` and rely on `local.settingSources` to load them.
## When to use
- Lint / type-check gates before agent commits
- Audit logging or compliance commands after each turn
- Fail-fast policies that must run regardless of prompt
## Concepts
- [[references/file-format]] — `.cursor/hooks.json` shape
- [[references/loading]] — `settingSources` and project vs user vs team scope
- [[references/programmatic-alternatives]] — what to use when you need JS callbacks (`onDelta`, `onStep`)
## Cross-links
- `local.settingSources` → [[../cursor-sdk/references/local-options]]
- Stream-side observation → [[../cursor-runs/references/interaction-updates]]
- Sibling `.cursor/` features → [[../cursor-rules/SKILL]] · [[../cursor-skills-system/SKILL]]
عرض على GitHub