wander-monitor

# Wander — CI/CD Monitor Skill

**Don't watch. Wander.** Elegant automation for monitoring GitHub Actions without polling.

## When to use this skill

- User wants to monitor a GitHub Actions workflow after push
- User asks how to get notified when CI completes
- User wants to avoid refreshing the Actions page
- User integrates CI monitoring into a project (e.g. ClawHub publish)

---

## Install

```bash
git clone https://github.com/ERerGB/wander.git
cd wander
chmod +x *.sh
```

**Prerequisites**: `gh` CLI (authenticated), `jq`, macOS (for notifications)

---

## Usage patterns

### 1. Smart push (recommended for Wander's own repo)

```bash
cd wander
./smart-push.sh
```

Recommends smoke / e2e / skip based on changed files. Pushes and monitors.

### 2. Manual control (any repo)

```bash
# From target repo (e.g. openclaw-uninstall)
git push

# Choose monitoring mode:
../wander/watch-workflow.sh publish.yml      # Foreground, block until done
../wander/watch-workflow-bg.sh publish.yml  # Background, macOS notify when done
../wander/watch-workflow-detached.sh publish.yml  # Detached, can close terminal
```

### 3. Project integration

Add a wrapper script in the project:

```bash
#!/bin/bash
# scripts/watch-publish.sh
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
WANDER_DIR="${WANDER_DIR:-$(dirname "$REPO_ROOT")/wander}"
cd "$REPO_ROOT"
exec "$WANDER_DIR/watch-workflow-bg.sh" publish.yml "$@"
```

Then: `git push && ./scripts/watch-publish.sh`

---

## Edge cases (from experience)

| Scenario | Behavior | Tip |
|----------|----------|-----|
| Workflow finishes in < 30s | "Already completed" + immediate notify | Use `watch-workflow-bg`; it detects recent completion |
| Push then monitor immediately | Workflow may not start for 5–10s | Script waits up to 30s for workflow to appear |
| Wrong branch | No workflow after 30s | Ensure workflow is configured for current branch |
| No lock file in repo | setup-node `cache: npm` fails | Remove `cache: "npm"` fr...

# Wander Monitor Skill

ClawHub skill for using [Wander](https://github.com/ERerGB/wander) to monitor GitHub Actions workflows.

## Install

```bash
clawhub install wander-monitor
```

## Usage

When the user asks about:
- Monitoring CI/CD after push
- Getting notified when GitHub Actions complete
- Integrating Wander with a project

— respond with guidance from this skill (see `SKILL.md`).

## License

MIT