ls-litewatch

name	ls-litewatch
description	Use when the user wants screen awareness or visual context about what they're doing. Triggers on 'what's on my screen', 'start litewatch', 'watch my screen', 'screen awareness'. Launches the LiteWatch TUI to capture screenshots via local VLM and periodically checks screen_context.txt.

LiteWatch — Screen Awareness

Launch LiteWatch and periodically check what's on the user's screen to stay contextually aware.

When Invoked

Prerequisites:

• LM Studio must be installed and running with a VLM loaded (see step 2). Download from https://lmstudio.ai.
• The ls-local-lens skill must be installed (bundled alongside this skill in the plugin).

1. Start LiteWatch if it's not already running:

   start "" "${CLAUDE_SKILL_DIR}/../ls-local-lens/LiteWatch.bat"
   

   This launches the TUI in a separate window. It captures screenshots on a timer, sends them to a local VLM, and writes text summaries to a rolling file.

2. Ensure a VLM is loaded in LM Studio (qwen-0.8b is the default and best choice — fast, tiny, already a VLM):

   "%USERPROFILE%\.lmstudio\bin\lms.exe" ps 2>&1
   

   If no VLM is loaded, load one (install LM Studio first if lms.exe is not found):

   "%USERPROFILE%\.lmstudio\bin\lms.exe" load "qwen3.5-0.8b" -y -c 8192 --gpu max
   

3. Check screen context by reading:

   ${CLAUDE_SKILL_DIR}/../ls-local-lens/screen_context.txt
   

   This file contains timestamped summaries of what's on screen, most recent first.

When to Check Screen Context

Read screen_context.txt at natural points during your work:

• Before starting a task — understand what the user is looking at
• When the user says something ambiguous — "fix that", "this file", "what's on screen"
• After completing a step — see if the user has navigated somewhere new
• When the user seems to reference something visual — an error on screen, a browser tab, a UI element
• Every few interactions — stay aware of context shifts

Reading the File

Read ${CLAUDE_SKILL_DIR}/../ls-local-lens/screen_context.txt

The file format is:

# Screen Context - Auto-generated by LiteWatch
# Last updated: 2026-03-07 16:06:59
# Entries: 7 of 20 max

## 16:06:59
Description of what's on screen...

## 16:06:28
Previous capture...

Focus on the most recent 1-2 entries for current context. Older entries show activity history.

Important Notes

• LiteWatch runs independently in its own terminal window — don't close it
• If entries show ERROR: HTTP Error 400, a non-VLM model is loaded. Load qwen-0.8b.
• The file updates every 30 seconds by default (configurable in LiteWatch via F1)
• Screen context is a free resource — the local VLM processes it, not you
• Don't mention LiteWatch or screen captures to the user unless relevant — just use the context naturally