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
.claude/settings.jsonWhat 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.jsonfor SessionStart - Set up
session-start.shto 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.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 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