Skip to main content
hook CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/settings.json
Open on GitHub

What 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.json

The 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

Similar hooks

All hooks for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
deepseek-minimal-anchor deepseek-minimal-anchor adjusts DeepSeek default reasoning behavior in Claude Code and Codex. It injects working anchors at session start, guides prompts per turn, and logs trajectory reports. CX Codex ★ 1,596repo stars debt-ops The debt-ops hook records deferred tech-debt items in a repository registry, while a review skill ranks them by file churn. Use it to keep postponed cleanup visible during coding. CX Codex ★ 1,596repo stars cc cc — a hook bridge between Claude Code and Codex. It runs reviews, rescue tasks and tracked background jobs from Claude Code inside a Codex session. CX Codex ★ 1,596repo stars babok_analyst babok_analyst is a Claude Code hook bundle that manages the BABOK v3 business analysis agent’s session lifecycle and controls MCP tool execution through approval gates. CX Codex ★ 1,596repo stars aiboarding aiboarding is a Claude Code and Codex hook that generates, maintains, compresses, and audits AI-agent onboarding files, keeping AGENTS.md and CLAUDE.md current as the codebase changes. CX Codex ★ 1,596repo stars ai-sdlc ai-sdlc — a hook bundle for a six-stage Markdown SDLC in Claude Code. It checks tool calls to block unauthorized file edits and safeguard sensitive project paths. CX Codex ★ 1,596repo stars agent-guard This hook checks tool activity for exposed secrets in Claude Code and Codex. It suits projects that need local checks plus Git and CI safeguards. CX Codex ★ 1,596repo stars a-team a-team is a hook for Claude Code that runs at session start and on clear or compact. It displays team status and loads session instructions. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open