0.5.0 - 2026-08-18

Release Notes

Added

• A user-level ~/.config/vissue/config.toml can send named projects to
  another checkout. A route wins over --root and VISSUE_ROOT, so a
  process whose default root is one tracker can still create and show
  issues that live on another. --no-route and VISSUE_NO_ROUTE=1 keep
  every verb on the process default. projects and identity list the
  routed names; show and claim find an id on any configured layout.
  vissue.el still parses the original identity and projects lines;
  route lines are appended.

  refile and reject route their destination as well, so a bounce onto a
  routed name lands on that name's tracker. serve, and the TUI and HUD
  that talk to it, stay on the single layout the server was started with.

• vissue hud is an overlay. On Sway it floats and centers itself over
  the compositor IPC socket. No Sway include or for_window rule.

• vissue reject closes a heading as CANCELLED and writes a successor
  edge (PIVOTED_TO / DISCOVERED_FROM) in one edit, so a bounce is a
  walkable wire rather than a body mention. vissue wait --id --until-terminal
  blocks until that id is DONE or CANCELLED (exit 2 on timeout). State
  changes emit a state_change event that names the id.

• vissue update --if-state / --if-gen refuse a write when the heading
  or corpus moved since the caller last read it. Disagreeing terminals
  keep the first close and record :SIBLING_TERMINAL:; vissue resolve
  picks one. vissue check warns on a DONE that reads as a reject and on
  a body [[id:]] with no successor edge.

Fixed

• A freshly started serve owner is now waited on for 15 seconds rather than
  5, and VISSUE_ACCEPT_TIMEOUT_MS overrides that. A cold start binds its
  socket only after building a runtime and loading the tracker, so a loaded
  machine could reach the old deadline and be reported as a spawn failure.
  The HUD's detach path reads the same deadline.

vissue-hud 0.5.0

Install vissue-hud 0.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/HaoZeke/vissue/releases/download/v0.5.0/vissue-hud-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/HaoZeke/vissue/releases/download/v0.5.0/vissue-hud-installer.ps1 | iex"

Download vissue-hud 0.5.0

File	Platform	Checksum
vissue-hud-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
vissue-hud-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
vissue-hud-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
vissue-hud-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
vissue-hud-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo HaoZeke/vissue

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

vissue-cli 0.5.0

Install vissue-cli 0.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/HaoZeke/vissue/releases/download/v0.5.0/vissue-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/HaoZeke/vissue/releases/download/v0.5.0/vissue-cli-installer.ps1 | iex"

Download vissue-cli 0.5.0

File	Platform	Checksum
vissue-cli-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
vissue-cli-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
vissue-cli-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
vissue-cli-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
vissue-cli-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
vissue-cli-aarch64-unknown-linux-musl.tar.xz	ARM64 MUSL Linux	checksum
vissue-cli-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo HaoZeke/vissue

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>

vissue-mcp 0.5.0

Install vissue-mcp 0.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/HaoZeke/vissue/releases/download/v0.5.0/vissue-mcp-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/HaoZeke/vissue/releases/download/v0.5.0/vissue-mcp-installer.ps1 | iex"

Download vissue-mcp 0.5.0

File	Platform	Checksum
vissue-mcp-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
vissue-mcp-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
vissue-mcp-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
vissue-mcp-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
vissue-mcp-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum
vissue-mcp-aarch64-unknown-linux-musl.tar.xz	ARM64 MUSL Linux	checksum
vissue-mcp-x86_64-unknown-linux-musl.tar.xz	x64 MUSL Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo HaoZeke/vissue

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>