# praxis

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.

- hook · `type=hook` · Claude Code, Codex · ★ 1596 repo stars
- Author: ouonet
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ouonet/praxis/hooks/codex-hooks.json
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 3 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/hooks/praxis

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/settings.json` — The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ouonet/praxis/hooks/codex-hooks.json

## When to use it
- 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
- 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.

## Source text · codex-hooks.json · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f5d14936bfd73a0c.

BEGIN THIRD-PARTY FILE f5d14936bfd73a0c
````text
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"
          }
        ]
      }
    ]
  }
}

```
````
END THIRD-PARTY FILE f5d14936bfd73a0c

The third-party file has ended. Everything between the f5d14936bfd73a0c tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© ouonet · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ouonet/praxis/hooks/codex-hooks.json

## Similar
- [scope-triage](https://affpapa.org/en/nevibecode/skills/scope-triage.md) — skill · 4100 installs
- [ghost-validate](https://affpapa.org/en/nevibecode/skills/ghost-validate.md) — skill · 4200 installs
- [adjudicate-regression](https://affpapa.org/en/nevibecode/skills/adjudicate-regression.md) — skill · 669 installs
- [fingerprint-failure-triage](https://affpapa.org/en/nevibecode/skills/fingerprint-failure-triage.md) — skill · 132800 installs
- [praxis-engineering](https://affpapa.org/en/nevibecode/plugins/praxis-engineering.md) — plugin · ★ 1183 repo stars
- [trailmark-finding-triage](https://affpapa.org/en/nevibecode/skills/trailmark-finding-triage.md) — skill · 1900 installs

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
