hook post-command

Execute post-command processing including output analysis and state updates.

Usage

npx claude-flow hook post-command [options]

Options

• --command, -c <cmd> - Command that was executed
• --exit-code, -e <code> - Command exit code
• --analyze-output - Analyze command output (default: true)
• --update-cache - Update command cache
• --track-metrics - Track performance metrics

Examples

Basic post-command hook

npx claude-flow hook post-command --command "npm test" --exit-code 0

With output analysis

npx claude-flow hook post-command -c "git status" -e 0 --analyze-output

Cache update

npx claude-flow hook post-command -c "npm list" -e 0 --update-cache

Performance tracking

npx claude-flow hook post-command -c "build.sh" -e 0 --track-metrics

Features

Output Analysis

• Parses command output
• Extracts key information
• Identifies errors/warnings
• Summarizes results

Cache Management

• Stores command results
• Enables fast re-execution
• Tracks output changes
• Reduces redundant runs

Metric Tracking

• Records execution time
• Monitors resource usage
• Tracks success rates
• Identifies bottlenecks

State Updates

• Updates project state
• Refreshes file indexes
• Syncs dependencies
• Maintains consistency

Integration

This hook is automatically called by Claude Code when:

• After Bash tool execution
• Following shell commands
• Post build/test operations
• After system changes

Manual usage in agents:

# After running commands
npx claude-flow hook post-command --command "npm build" --exit-code 0 --analyze-output

Output

Returns JSON with:

{
  "command": "npm test",
  "exitCode": 0,
  "duration": 45230,
  "outputSummary": "All 42 tests passed",
  "cached": true,
  "metrics": {
    "cpuUsage": "45%",
    "memoryPeak": "256MB"
  },
  "stateChanges": ["test-results.json updated"],
  "warnings": []
}

See Also

• hook pre-command - Pre-command validation
• Bash - Command execution tool
• cache manage - Cache operations
• metrics collect - Performance data