← back to Desktop Dotbar

README.md

15 lines

# desktop-dotbar

Always-on-top strip across the top of the desktop showing each terminal **color dot + live count**.
Click a color → dropdown of that color's tickets + what each is doing → **open terminal** jumps to
that iTerm2 session. Data comes from `allcolordots --json` (cached server-side for a smooth bar).

## Run
    bash start-bar.command      # starts server + floats the Electron strip
Quit with the **✕** on the bar, or: `pkill -f desktop-dotbar`

## Pieces
- `server.js`     — node http server: `/api/dots` (cached), `/health`, `/api/reveal` (jump to tty)
- `electron-main.js` — frameless NSPanel, alwaysOnTop 'screen-saver', self-resizes on dropdown
- `public/index.html` — the bar UI (`?open=<color>` deep-links a dropdown open)