Skip to main content
hook CX Codex

praxis — Claude Code hook: what it does, how to install

This hook loads Praxis triage when a session starts or resumes, so the agent can work toward a defined outcome instead of a step list.

MIT ★ 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 praxis does

praxis is a hook for Claude Code and Codex. It runs on SessionStart and handles startup, resume, clear, and compact events. The hook calls run-hook.cmd from ${CLAUDE_PLUGIN_ROOT} and reports “Loading Praxis triage” while it runs.

The workflow is outcome-led: describe what “done” should look like rather than prescribing every action. Praxis covers design, TDD, debugging, review, and release workflows, with triage used before the main work begins. The command runs synchronously, and Windows has a separate commandWindows entry.

Claude Code setup uses .claude/settings.json with a SessionStart handler. The hook will not connect to Claude Code until that file contains the relevant configuration.

What it helps with

  • start triage when an agent session begins
  • describe a target outcome instead of every coding step
  • keep token use focused across workflow stages
  • prepare design, TDD, debug, and review tasks

Example prompts for the agent

  • Start a new session by identifying the outcome that should be ready at the end.
  • After resuming the session, triage the task before choosing implementation steps.
  • Prepare this change for review using the intended result as the guide.

How to install praxis

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 praxis

How do I install praxis in Claude Code?

Connect the hook through .claude/settings.json and add a SessionStart handler there.

What does praxis do?

It loads Praxis triage when a Claude Code or Codex session reaches a SessionStart event. The workflow focuses the agent on the finished result rather than a fixed sequence of steps.

Which session events trigger the praxis hook?

The matcher covers startup, resume, clear, and compact. On Windows, the hook uses the commandWindows command.

Source text

codex-hooks.json · MIT
Hooks bundle shipped with the praxis plugin for Claude Code.

Intent-driven workflow skills for coding agents: describe what done looks like, not the steps. Triage-first design keeps token costs low across design, TDD, debug, review, and release.

Triggers on: SessionStart.

```json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume|clear|compact",
        "hooks": [
          {
            "type": "command",
            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
            "commandWindows": "& \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
            "async": false,
            "statusMessage": "Loading Praxis triage"
          }
        ]
      }
    ]
  }
}

```

© ouonet · MIT · hashgraph-online/awesome-codex-plugins

Similar hooks

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

From the same set391

The whole set →
steinwall The steinwall hook for Claude Code and Codex provides cost controls, action guards, and loop recovery for unattended agent sessions with shell execution. CX Codex ★ 1,596repo stars session-orchestrator session-orchestrator — a hook for Claude Code and Codex that wraps each agent session in structured planning, staged execution, and quality gates. Fires on SessionStart, PreToolUse, PostToolUse, Stop, and SubagentStop. CX Codex ★ 1,596repo stars repopilot repopilot takes a repo snapshot at session start and checks it again before the agent stops. If tests, suppressions or CI gates got weaker, the session will not end quietly. CX Codex ★ 1,596repo stars codex-project-autopilot codex-project-autopilot — a hook for Claude Code and Codex that runs a check after every file write or edit. Fires automatically on PostToolUse events. CX Codex ★ 1,596repo stars off-the-wall The off-the-wall hook quotes your earlier fixes into the prompt before every Codex answer. The model sees what you corrected before and stops repeating the same mistakes. CX Codex ★ 1,596repo stars nightshift nightshift binds Codex work sessions to strict time limits, tracking punch lists, deferred decisions, and run logs. CX Codex ★ 1,596repo stars homie homie checks tool calls, pauses risky actions for approval, and removes secrets from results the model reads. CX Codex ★ 1,596repo stars codex-goal-progress codex-goal-progress is a Claude Code hook that tracks Codex Goals with checklist progress and token usage. It shows goal status in the interface. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open