Add Tailscale Simple: compact attached Tailscale controls - #675
Draft
alivault wants to merge 5 commits into
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Plugin
alivault/tailscale-simpleplugin.toml)What it does
An independently maintained, UI-focused fork of
davemhammer/tailscale1.0.6. It keeps the upstreamTailscale backend while offering a smaller attached panel designed around everyday actions:
/tsslauncher prefix to avoid colliding with the original/tsprovider.The original author and upstream contributors are credited in README and LICENSE. The backend is unchanged
from the original 1.0.6 plugin. The launcher retains upstream behavior with renamed panel references and
the documented
onQuery/onActivateentry points. This is not affiliated with Tailscale Inc.Draft for author review: AI-assisted implementation and submission preparation were used. The code is
plain, readable Luau, not a bundled/minified artifact. The author should review the source and confirm the
remaining provenance/licensing attestations before marking this ready, including whether the repository's
wording about generated code permits this submission. If a separate UI-focused fork is not wanted, guidance
on contributing these changes upstream would be welcome.
External dependencies
tailscale: read-onlystatus --json,debug prefs, andexit-node listpolling; explicit user-triggeredup,down,set,ping -c 3, andsshactions. A running/authenticatedtailscaledand operator permissionsare required. Connection/preference actions can change connectivity and daemon-managed state.
jq: filters large status JSON and projects non-secret preference fields before Luau decoding.xdg-open: opens the default Tailscale admin URL or the user's configured URL in a browser.No plugin HTTP client, telemetry, credential files, or remote-code download/execution. Network requests happen
through the Tailscale CLI/daemon, selected-peer Ping/SSH, or the browser opened on explicit user action.
The plugin does not directly write files. Tailscale, the browser, terminal, and Noctalia manage their own
preferences, state, and logs. Copy actions write to the clipboard; device data is held in runtime state
and may be shown in notifications. Shell arguments are quoted.
Testing
Tested on Niri
Tested on Hyprland
Tested on Sway
Tested on another compositor:
Noctalia version tested against: 5.0.1
Plugin API level: 30
Loaded the release copy as a temporary path source on Niri; enabled its service and opened its panel with
real read-only Tailscale status. No live connection, exit-node, or preference changes were made by the tests.
Visually exercised Devices, Exit node, and Settings with a temporary synthetic snapshot service; captured
dark/light screenshots. That fixture is not in this PR. Screenshots use a solid theme background for privacy.
A local Luau mock-host harness exercised connection up/down dispatch, all five preferences in both directions,
pending-action guards, exit-node selection/clearing, search/empty states, expandable actions, clipboard/SSH/Ping
dispatch, refresh completion, launcher queries/actions, widget callbacks, and shell quoting in the backend.
It executes the actual entry sources with host/CLI calls stubbed; it is not a live network integration test.
noctalia plugins lint tailscale-simple: 0 errors, 0 warnings.python3 .github/workflows/scripts/validate-plugins.py: all 164 manifests passed.python3 -m unittest discover -s .github/workflows/scripts -p 'test_*.py': 83 tests passed.git diff --cached --check: clean.The temporary test source was removed afterward; the existing local plugin and original dark theme were restored.
Screenshots / Videos
Demo-only names and addresses; no personal tailnet data included.
Devices, light theme, settings, and exit nodes
Checklist
idafter the/inplugin.tomlexactly.plugin.toml,README.md,thumbnail.webp, andtranslations/en.json.README.mdfollows the README template, documents every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.thumbnail.webpis present and relevant; for a new plugin I created it with the thumbnail generator, and for an update I regenerated it with the generator if the visual identity or user-facing appearance changed.versionfollows semver and is bumped in this PR;plugin_apiis the oldest API level this plugin requires.catalog.toml; CI generates it.Only English translations are included. API 30 is selected per the README's guidance to target the currently
documented level for a new plugin, rather than retaining the original plugin's API 10 target.
Code review attestation
licensedeclared inplugin.toml.The remaining boxes are intentionally left for the author's review. The upstream manifest declares MIT,
and the fork includes attribution and MIT terms; this draft does not substitute for the author's confirmation.