Back to catalogue
NotificationPostToolUsePostToolUseAfter tool execution · non-blocking· non-blocking
Tool usage tracking
Increments a counter per tool type after each use and logs the activity, providing a view of the agent's usage intensity per session.
Use cases
- Observability
- Usage analysis
- Agentic FinOps
Providers & tags
Claude Code
#notification#observability#metrics#finops
settings.json fragment
{
"hooks": {
"PostToolUse": [
{
"hooks": [
{
"command": "node $CLAUDE_PROJECT_DIR/.claude/hooks/tool-usage.mjs",
"type": "command"
}
]
}
]
}
}Script · .claude/hooks/tool-usage.mjs
#!/usr/bin/env node
// Journalise les commandes Bash avec leur durée (PostToolUse Bash)
import { readFileSync, appendFileSync, mkdirSync } from 'fs';
import { join } from 'path';
import { fileURLToPath } from 'url';
export function run(
input,
{
append = appendFileSync,
mkdir = mkdirSync,
projectDir = process.env.CLAUDE_PROJECT_DIR ?? process.cwd(),
now = () => new Date().toISOString(),
} = {},
) {
const command = input.tool_input?.command ?? '';
if (!command) return null;
const logDir = join(projectDir, '.claude', 'data');
mkdir(logDir, { recursive: true });
const entry = {
ts: now(),
cmd: command.slice(0, 500),
exit: input.tool_response?.exit_code ?? null,
};
append(join(logDir, 'bash-history.jsonl'), JSON.stringify(entry) + '\n');
return entry;
}
/* v8 ignore next 4 */
if (process.argv[1] === fileURLToPath(import.meta.url)) {
const input = JSON.parse(readFileSync(0, 'utf8'));
run(input);
}