Skip to main content
hook CX Codex

board — Claude Code hook: terminal kanban board on plain Markdown

A SessionStart hook that tells the agent what is on the project board. The board lives in plain Markdown files, so you can read it straight from the terminal.

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 board does

When a session starts, the hook runs session-start.sh and tells the agent whether the project has a board and what is on it. Codex or Claude Code writes to it, you read it: kanban, checklists, charts, forms and live logs all sit in ordinary Markdown files.\n\nConfiguration goes into .claude/settings.json next to claude-hooks.json. The script fires with a 5-second timeout and a .* matcher, so every session triggers it.\n\nThat 5-second cap is the main constraint. The script has to finish fast, and if the board grows large, the summary it prints has to stay small.

What it helps with

  • show the agent what is on the board at session start
  • keep tasks and logs as plain Markdown files
  • read the board in the terminal without an extra service
  • put kanban, checklists and charts on one board
  • make the agent announce the board when a session opens

Example prompts for the agent

  • Add the board hook to .claude/settings.json for SessionStart
  • Set up session-start.sh to show the current board to the agent
  • Make the agent report what is on the board at the start of each session

How to install board

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 board

How do I install board in Claude Code?

Add the hook config to .claude/settings.json, using the structure from claude-hooks.json. It triggers on SessionStart and runs session-start.sh.

What does board do?

At the start of a session it runs a script that tells the agent whether the project has a board and what is on it. The board is stored in Markdown files: kanban, checklists, charts, forms and logs.

Why is the hook timeout set to 5 seconds?

The hook matches every session with .*, so session-start.sh must complete within 5 seconds. A slow script will not finish in time.

Source text

codex-hooks.json · Apache-2.0
Hooks bundle shipped with the board plugin for Claude Code.

A terminal board Codex writes to and you read, with kanban, checklists, charts, forms and live logs kept as plain Markdown files.

Triggers on: SessionStart.

```json
{
  "description": "At the start of a session, say whether the project has a board and what is on it. Claude Code uses claude-hooks.json, beside this file.",
  "hooks": {
    "SessionStart": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "\"${PLUGIN_ROOT}/scripts/session-start.sh\"",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

```

© LeeSwallow · 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 →
vibestretch vibestretch is a Claude Code hook that prints a stretch or eye-rest prompt and plays a soft chime after the agent has kept you waiting. It runs on prompt submission, tool use, and agent stop. CX Codex ★ 1,596repo stars tree-ring-memory tree-ring-memory is a Claude Code hook that loads saved context when a session starts and checks memory when it ends. It also runs at subagent start and stop. CX Codex ★ 1,596repo stars tailtest tailtest detects files modified during an agent turn and triggers automated test writing and execution. Works across 8 languages with zero config. CX Codex ★ 1,596repo stars stop-that-shit The stop-that-shit hook for Claude Code and Codex checks agent actions against explicit task modes and bounds decisions about dependencies, hashes, and subagents. CX Codex ★ 1,596repo stars 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

Project sponsors

Companies that keep this analytics open