ts-band

Reviewed at commit 0a2174b New version, not yet reviewed

Tailscale nodes above the prompt from tailscale status --json, listing only the relayed or offline ones, with a toast when a node comes up or goes down.

Made by
hoobnn
What we checked

Runs the local tailscale CLI (`tailscale status --json`) every 60 seconds and before each prompt, and shows your Tailscale nodes in a band above the prompt. A toast appears when a node comes online or goes offline. It sends nothing over the network itself, uses no tokens and stores only its show/hide setting.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since ceaba79; the rest carries over from the review at that commit. The only change in this version is an added "claude-code" keyword in plugin.json; no code changed. Registers session.start, session.attach, command.run (/ts [off|on]), prompt.edit, prompt.change, prompt.submit, tool.call (Bash, observation only) and ui.render (AbovePrompt). Uses $.process.run with a fixed argument list [candidate, 'status', '--json'] and a 10 s timeout; candidates are 'tailscale' on PATH, /usr/local/bin/tailscale, /opt/homebrew/bin/tailscale, the macOS Tailscale app binary, or the path the user sets in the tailscalePath option. Failed reads back off up to 10 minutes. Output is parsed as JSON for peer host names, online state and link type, and only that is shown. The Bash tool.call hook calls next(e) first and then refreshes the band when a command matches tailscale up, down, set, switch, login or logout; it never changes the call. Also uses $.settings.read (language only), $.env.get for LC_ALL, LC_MESSAGES and LANG, $.store (one-time migration of an old flag), $.config.set on its own ts-band.visible row and $.ui.toast. Start-up runs once from session.start or the session.attach hook (desktop app, headless sessions) and for non-interactive sessions that have a surface; the hidden state falls back to the saved visible row in resumed or cleared sessions; prompt.change only re-checks whether a slash or @ picker is open. No fetch, fs or model calls.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of ts-band

Tailscale nodes' state in a band above the prompt, with a toast when a node comes up or goes down

Made this mod? Add a badge to your README

modsforClaude badge for ts-band

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/ts-band.svg)](https://modsforclaude.com/mods/ts-band/)

← All mods