Skip to content

chore(gui)!: retire the desktop app#35

Merged
scarletkc merged 1 commit into
mainfrom
chore/retire-gui
Jul 12, 2026
Merged

chore(gui)!: retire the desktop app#35
scarletkc merged 1 commit into
mainfrom
chore/retire-gui

Conversation

@scarletkc

Copy link
Copy Markdown
Owner

Motivation

Download data settled the question: the GUI desktop zips in recent releases have ~1 download each, and the asset attached to v0.24.x releases was still the stale 0.19.0 build — five package releases went by without anyone noticing the GUI never updated. Meanwhile the CLI ships through PyPI (~714/month). Maintenance mode still costs real money (Electron CVE churn, dependabot noise, a whole npm toolchain in the contributor guide, GUI branches in publish.yml, --gui in the bump script) for a product with no measurable users.

Archival — nothing is lost

  • archive/gui branch is a full snapshot of main taken immediately before this change: the entire gui/ tree, assets/gui_demo.png, the GUI sections of README/AGENTS, the publish.yml GUI pipeline, the bump-script GUI code — verified file-by-file before deletion. Git history additionally preserves everything forever.
  • The last shipped builds (vexor-desktop-0.19.0-*.zip) remain downloadable from old releases; existing installs keep working.

Changes

  • Delete gui/ and assets/gui_demo.png.
  • publish.yml: remove the GUI version-detection outputs, the reuse-previous-asset step, and the Node/npm build steps (YAML validated; CLI binary + PyPI + MCP-registry pipeline untouched).
  • scripts/bump_version.py: drop --gui and the SemVer-normalization helpers; tests updated (unknown options now rejected, with a regression test).
  • README: intro now says "Python API, a CLI tool, and an MCP server"; Desktop App section removed.
  • AGENTS.md: gui structure bullet, npm commands, gui scope example, and GUI-screenshot guidance removed.
  • Roadmap: GUI policy section replaced with a tombstone pointing at archive/gui and the VS Code extension (P2); the porcelain contract test item reframed for scripts/agents (still valuable without the GUI); the GUI/package version-alignment Engineering TODO removed (moot).
  • docs/workflow-diagram.md updated to match the slimmed pipeline.

Compatibility

Marked ! because a distributed product surface is removed. No Python API, config-schema, or cache-schema change; the pip package never included the GUI.

Tests

python -m pytest tests -q (.venv, offline): 549 passed. publish.yml parses (yaml.safe_load). Doc/CI/tooling change only — no runtime code touched.

🤖 Generated with Claude Code

Release assets had stalled at 0.19.0 with effectively zero downloads
while the CLI ships through PyPI, so the Electron app is retired
rather than kept in maintenance mode. The full source, screenshot, and
docs are preserved on the archive/gui branch, and the last shipped
builds remain downloadable from old releases. Removes the gui/ tree,
the GUI build/reuse pipeline from publish.yml, the --gui flag from
bump_version.py, and GUI references across README, AGENTS.md, and the
roadmap (porcelain contract test reframed for scripts/agents; the
GUI/package version-alignment TODO is moot).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@scarletkc
scarletkc merged commit 70dcce6 into main Jul 12, 2026
7 checks passed
@scarletkc
scarletkc deleted the chore/retire-gui branch July 12, 2026 02:09
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