Skip to content

hqterm 0.3.0: Windows installer, Tailscale hosts, server setup, full docs + new landing page - #7

Merged
ralyodio merged 1 commit into
mainfrom
docs/hqsh-sell-and-document
Oct 6, 2026
Merged

ralyodio merged 1 commit into
mainfrom
docs/hqsh-sell-and-document

Conversation

@ralyodio

@ralyodio ralyodio commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Anthony: "does hqterm install hqsh too for server? it needs to and we need to sell it and document its full usage", then "use systemd on *nix", "it needs to work there too on those servers/devices" (macOS/Windows), and "support tailscale optional (if detected)". The hqsh side shipped as hqsh v0.3.0 (#3, #4, #5).

Install

  • install.ps1 (irm https://hqterm.sh/install.ps1 | iex): hqsh.exe for Windows x64/ARM64 into ~\.local\bin, SHA256-verified. It moves a running hqsh.exe aside rather than failing, adds the dir to the user PATH (so ssh sessions find it), runs hqsh server setup, and explains how to enable the OpenSSH server.
  • install.sh --server now runs hqsh server setup: systemd user units with lingering, or launchd.

Tailscale: online tailnet peers join the host list (TUI note ts, desktop + menu too); HQTERM_TAILSCALE=off hides them.

Docs (site/docs.html, served at hqterm.sh/docs):

  • install on every OS, with all flags and env vars
  • hqterm commands and manager keys
  • hqsh, shared sessions, Tailscale
  • what runs on servers (systemd/launchd/Windows; setup, list, journalctl, linger)
  • Windows hosts, fleets, the desktop app (keys, settings, layout, GPU log)
  • images, environment, troubleshooting (including "connection closed (status 1)"), how it works, update and uninstall

Landing page: rewritten to sell, with six value cards, a comparison table against mosh, Eternal Terminal and ssh+tmux, the Windows install, and a docs CTA.

Version: 0.3.0.

Tests

  • 34 pass (4 new: tailnet peer parsing, merge order, off switch), and tsc is clean.
  • New CI job windows-install runs install.ps1 for real, under Windows PowerShell and pwsh, then hqsh version from the user PATH.

Deploy note: dev2's hqterm.sh sync must also fetch site/docs.html and install.ps1, and nginx should serve /docs. That change is made on the box after merge.

🤖 Generated with Claude Code

…docs

- install.ps1 (irm https://hqterm.sh/install.ps1 | iex): hqsh.exe for
  Windows x64/ARM64 into ~\.local\bin, SHA256-checked, on the user PATH,
  then hqsh server setup; notes how to enable the OpenSSH server.
- install.sh --server runs hqsh server setup (systemd lingering / launchd).
- Online Tailscale peers join the host list (marked "ts");
  HQTERM_TAILSCALE=off hides them.
- site/docs.html (hqterm.sh/docs): install on every OS, hqterm, the manager,
  hqsh, shared sessions, Tailscale, servers (systemd/launchd/Windows), fleets,
  the desktop app, images, environment, troubleshooting, how it works,
  update and uninstall. site/index.html rewritten to sell it.
- CI runs install.ps1 for real on windows-latest, twice.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ralyodio
ralyodio merged commit cc8c725 into main Oct 6, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant