ls-watch

Monitor external conditions and emit JSON event payloads for specified watcher types.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahostbr/liteharness --skill ls-watch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ls-watch
Source: https://github.com/ahostbr/liteharness/tree/main/liteharness/catalog/skills/ls-watch
Command: npx skills add https://github.com/ahostbr/liteharness --skill ls-watch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of waiting on external conditions without manually checking logs, services, or running processes until something happens.

Core Features & Use Cases

  • Condition watchers: Monitor file appearance, file patterns, port open/close, process exit, command success, HTTP endpoint status/body/header, and RSS/Atom feed updates.
  • Background notifications: Runs polling scripts in the background and notifies the conversation when the condition is met (or when it times out).
  • Optional follow-up actions: Supports a then-command to run immediately after the trigger (e.g., fetch a transcript, inspect output, or run a follow-up check).
  • Persistent monitoring pattern: Combines one-shot watchers with looping behavior to re-arm monitoring after each trigger.

Quick Start

Ask the assistant to start watching for a new build log match by saying: /watch pattern build.log "BUILD SUCCESSFUL" --timeout 10m --interval 2s --name build

Frequently Asked Questions about ls-watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor a background process and get notified when it exits?

To monitor a background process and get notified when it exits, you can use a watcher to track process IDs and trigger alerts on shutdown. This Skill polls the PID and emits a JSON event payload when the process terminates, eliminating manual log checking.

Can I wait for an HTTP health endpoint to change status without manual polling?

Yes, you can wait for an HTTP health endpoint to change status without manual polling by configuring a web watcher. It runs background polling scripts to monitor URL status codes, headers, or body content, and notifies the conversation when the condition is met.

What is the best way to trigger an alert when a specific pattern appears in a log file?

The best way to trigger an alert when a specific pattern appears in a log file is to use a pattern watcher. It monitors file appearance and content matches, such as waiting for 'BUILD SUCCESSFUL' in build logs, and sends a notification upon detection.

How do I watch for new RSS feed updates automatically?

To watch for new RSS feed updates automatically, you can set up a feed watcher. It monitors RSS and Atom feeds in the background, applying validated interval and timeout constraints to emit event payloads when new entries are detected.

Does this background monitoring tool support running follow-up commands after a trigger fires?

Yes, this background monitoring tool supports running follow-up commands after a trigger fires. You can specify a then-command to execute immediately after the watcher condition is met, allowing you to fetch transcripts, inspect outputs, or run subsequent checks automatically.

How do I monitor a port to check if a service is ready?

To monitor a port to check if a service is ready, you configure a port watcher to track open or close states. The Skill handles developer workflows like waiting for service readiness by polling the port and emitting an event when the condition is satisfied.