cairnquire/scripts/README.md

Cairnquire - Development Scripts

This directory contains helper scripts for monitoring development progress.

Scripts

install-monitor.sh

Installs and starts the progress monitor as a background process.

./scripts/install-monitor.sh

The monitor will:

• Watch for filesystem changes every 10 minutes
• Update docs/STATUS.md with current progress
• Auto-exit if no changes detected for 10 minutes (Codex idle/finished)
• Provide code review notes and action items

monitor.sh

The actual monitoring script. Usually called via install-monitor.sh.

./scripts/monitor.sh

Runs in foreground. Press Ctrl+C to stop.

status.sh

Quick status check without starting the monitor.

./scripts/status.sh

Shows:

• Whether monitor is running
• Current progress report from docs/STATUS.md

Usage

1. Start monitoring (run once):

   ./scripts/install-monitor.sh
   

2. Check status anytime:

   ./scripts/status.sh
   

3. View live logs:

   tail -f monitor.log
   

4. Stop monitor:

   kill $(cat .monitor.pid)
   

Files Generated

• docs/STATUS.md — Current project status and code review notes
• docs/.last_state_hash — Internal file for tracking changes
• monitor.log — Log output from monitor
• .monitor.pid — Process ID of running monitor