archcore — Claude Code hook: features and setup
archcore is a Claude Code hook that brings Git project context into spec-driven development. It runs at session start, before file edits, and after Archcore document operations.
Apache-2.0 ★ 1,596 updated 2026-10-29
.claude/settings.jsonWhat archcore does
archcore runs commands at three points: when a session begins, before the agent calls Write, Edit, or apply_patch, and after Archcore tools change documents or their relations.
The hook bundle uses session-start, pre-tool-use, and post-tool-use commands. The last one handles document creation, updates, and removal, along with relation changes. Its pre-tool command has a 2-second timeout; the post-tool command has a 4-second timeout.
What it helps with
- load Git project context at session start
- run a hook before the agent edits files
- handle changes to Archcore documents and relations
Example prompts for the agent
- Start a project session and load its context from Git.
- Edit a project file and run the pre-edit hook.
- Create an Archcore document and process the change after the tool call.
How to install archcore
Manually: put the files in place
.claude/settings.jsonThe hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json
Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command
Questions about archcore
How do I install archcore in Claude Code?
Configure the hook in .claude/settings.json.
What does archcore do?
It runs commands at session start, before file changes, and after Archcore tools modify documents or relations.
Which events trigger the archcore hook?
It responds to SessionStart, Write, Edit, and apply_patch, plus Archcore tools for creating, updating, or removing documents and relations.
Source text
codex.hooks.json · Apache-2.0
Hooks bundle shipped with the archcore plugin for Claude Code.
Spec-driven development and context engineering for Claude Code, Cursor, Codex, and GitHub Copilot — backed by project context in Git.
Triggers on: PreToolUse, PostToolUse, SessionStart.
```json
{
"hooks": {
"SessionStart": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "ARCHCORE_HOST=codex \"${PLUGIN_ROOT}\"/bin/session-start"
}
]
}
],
"PreToolUse": [
{
"matcher": "Write|Edit|apply_patch",
"hooks": [
{
"type": "command",
"command": "ARCHCORE_HOST=codex \"${PLUGIN_ROOT}\"/bin/pre-tool-use",
"timeout": 2
}
]
}
],
"PostToolUse": [
{
"matcher": "mcp__archcore__create_document|mcp__plugin_archcore_archcore__create_document|mcp__archcore__update_document|mcp__plugin_archcore_archcore__update_document|mcp__archcore__remove_document|mcp__plugin_archcore_archcore__remove_document|mcp__archcore__add_relation|mcp__plugin_archcore_archcore__add_relation|mcp__archcore__remove_relation|mcp__plugin_archcore_archcore__remove_relation",
"hooks": [
{
"type": "command",
"command": "ARCHCORE_HOST=codex \"${PLUGIN_ROOT}\"/bin/post-tool-use",
"timeout": 4
}
]
}
]
}
}
```
© Archcore · Apache-2.0 · hashgraph-online/awesome-codex-plugins