post-command.md•2.17 kB
# hook post-command
Execute post-command processing including output analysis and state updates.
## Usage
```bash
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
```bash
npx claude-flow hook post-command --command "npm test" --exit-code 0
```
### With output analysis
```bash
npx claude-flow hook post-command -c "git status" -e 0 --analyze-output
```
### Cache update
```bash
npx claude-flow hook post-command -c "npm list" -e 0 --update-cache
```
### Performance tracking
```bash
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:
```bash
# After running commands
npx claude-flow hook post-command --command "npm build" --exit-code 0 --analyze-output
```
## Output
Returns JSON with:
```json
{
"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