tailtest — Claude Code hook: what it does, how to install
tailtest detects files modified during an agent turn and triggers automated test writing and execution. Works across 8 languages with zero config.
MIT ★ 1,596 updated 2026-10-29
.claude/settings.jsonWhat tailtest does
tailtest monitors code modifications made during an agent turn. Once files change, it directs Codex to write and execute relevant test suites automatically. It supports 8 programming languages out of the box. Zero setup is required.
The bundle attaches to three lifecycle triggers: SessionStart, PostToolUse, and Stop. Starting a session runs session_start.py. Every tool invocation triggers post_tool_use.py, while session termination calls stop.py.
Each trigger relies on python3 pointing to $HOME/.codex/plugins/tailtest/hooks/. Without python3 installed, the hooks will fail immediately. If you place plugin files outside that specific home directory, you must adjust the paths inside the hook definitions.
What it helps with
- track files modified during an agent turn
- generate tests automatically for touched source files
- run test suites without executing manual terminal commands
Example prompts for the agent
- Implement email validation logic in the registration module
- Refactor the discount calculation helper in the checkout service
How to install tailtest
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 tailtest
How to install tailtest in Claude Code?
Add the hook definitions to .claude/settings.json. Configure the command entries under the hooks section for SessionStart, PostToolUse, and Stop.
What does tailtest do?
It detects which files changed during an agent turn, then directs Codex to create and run tests for them. It handles 8 programming languages without extra setup.
What dependencies does tailtest require?
Your environment must have python3 installed. The scripts must also reside at $HOME/.codex/plugins/tailtest/hooks/.
Source text
hooks.json · MIT
Hooks bundle shipped with the tailtest plugin for Claude Code.
Hook-powered test generation -- detects files changed during an agent turn and instructs Codex to write and run tests automatically. Zero config, 8 languages.
Triggers on: PostToolUse, SessionStart, Stop.
```json
{
"hooks": {
"SessionStart": [
{
"matcher": "startup",
"hooks": [
{
"type": "command",
"command": "python3 $HOME/.codex/plugins/tailtest/hooks/session_start.py"
}
]
}
],
"PostToolUse": [
{
"matcher": ".*",
"hooks": [
{
"type": "command",
"command": "python3 $HOME/.codex/plugins/tailtest/hooks/post_tool_use.py"
}
]
}
],
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "python3 $HOME/.codex/plugins/tailtest/hooks/stop.py"
}
]
}
]
}
}
```
© AvanSaber Inc. · MIT · hashgraph-online/awesome-codex-plugins