Skip to content

feat(dashboard): use inotify for event-driven redraws on Linux #14

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MuLinForest wants to merge 4 commits into
base: main
Choose a base branch
from
+17 −2
Open

feat(dashboard): use inotify for event-driven redraws on Linux #14

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
2c82975
feat(dashboard): use inotify for event-driven redraws on Linux
MuLinForest Mar 25, 2026
f824f97
fix(dashboard): suppress .status file-not-found error in sh/dash
MuLinForest Mar 25, 2026
7733512
fix(dashboard): exclude .hb.dat from inotify watch to prevent spuriou…
MuLinForest Mar 26, 2026
8608042
fix(dashboard): suppress inotifywait event output to stdout
MuLinForest Mar 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 17 additions & 2 deletions statusline/dashboard.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,11 @@ render() {
ts=$(date '+%Y-%m-%d %H:%M:%S')
now=$(date +%s)

printf '%b' "${C_TITLE}Claude Code Dashboard${R} ${ts} ${DIM}(every ${INTERVAL}s)${R}"
if [ "${_REFRESH_MODE:-polling}" = "inotify" ]; then
printf '%b' "${C_TITLE}Claude Code Dashboard${R} ${ts} ${DIM}(event-driven)${R}"
else
printf '%b' "${C_TITLE}Claude Code Dashboard${R} ${ts} ${DIM}(every ${INTERVAL}s)${R}"
fi
printf '\n\n'

# Column headers
Expand Down Expand Up @@ -107,7 +111,7 @@ render() {

# Determine display status: prefer event-driven .status file
disp_status="" _status_epoch=""
read -r disp_status _status_epoch < "$SESSIONS_DIR/${pid}.status" 2>/dev/null || disp_status=""
[ -f "$SESSIONS_DIR/${pid}.status" ] && read -r disp_status _status_epoch < "$SESSIONS_DIR/${pid}.status"
# Fallback: JSON field, then file age
if [ -z "$disp_status" ]; then
age=$(( now - epoch ))
Expand Down Expand Up @@ -183,6 +187,17 @@ render() {
mkdir -p "$SESSIONS_DIR"
trap 'printf "\n"; exit 0' INT TERM

if command -v inotifywait > /dev/null 2>&1; then
_REFRESH_MODE="inotify"
render
while inotifywait -q -e modify,create,delete --include '\.(status|json)$' "$SESSIONS_DIR" > /dev/null 2>/dev/null; do
render
done
# inotifywait exited unexpectedly — fall back to polling
_REFRESH_MODE="polling"
fi

# Polling loop (primary on macOS, fallback if inotifywait fails)
while true; do
render
sleep "$INTERVAL"
Expand Down