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
.claude/settings.jsonWhat 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.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 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