# Hwatch

> Use this skill when the user wants to watch a command periodically with history tracking, diff output, or scrollback capabilities.

- Skill: `javimosch/hwatch` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/hwatch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/hwatch/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/hwatch

---


# hwatch Plugin

Modern alternative to watch command with history and diff support.

## Commands

### Watch
- `hwatch watch run` — Watch a command and show output with history
- `hwatch watch diff` — Watch a command and show diff between runs
- `hwatch watch batch` — Run hwatch in batch mode (non-interactive)

## Usage Examples
- "Watch a command and track changes over time"
- "Monitor a file with diff output"
- "Run a command periodically with history"
- "Watch docker ps in batch mode"

## Installation

```bash
cargo install hwatch
```

## Examples

```bash
# Basic watch with 2-second interval
hwatch -n 2 ls -la

# Watch with diff highlighting
hwatch -d kubectl get pods

# Batch mode for 60 seconds
hwatch --batch -n 5 -d date

# Watch with history and scrollback
hwatch -H docker stats

# Multiple commands with shell
hwatch 'ps aux | grep python'
```

## Key Features
- Command history with scrollback
- Diff mode highlights changes
- Batch mode for non-interactive use
- Customizable interval
- Color themes support
- Multiple command support