Skip to content

feat(linux): add GTK desktop pet port - #6

Open
nhathuynguyen19 wants to merge 27 commits into
alterhq:mainfrom
nhathuynguyen19:feat/linux-gtk
Open

nhathuynguyen19 wants to merge 27 commits into
alterhq:mainfrom
nhathuynguyen19:feat/linux-gtk

Conversation

@nhathuynguyen19

Copy link
Copy Markdown

Summary

  • Add an experimental Python/GTK3 Linux host with pet selection, notifications, plugin surfaces, MCP tools, follow-cursor/free-roam movement, and compact overlays.
  • Add Linux packaging, CI, verification and setup docs; leave existing Swift/macOS sources and release workflow untouched.
  • Package the preview as openpets_0.1.0_all.deb.

Verification

Scope

  • Experimental X11/GTK3 Linux preview; not full macOS feature parity.
  • No macOS build was run in this Linux environment.

Add the Linux GTK3 host, autonomous movement, MCP integration, opt-in plugins, packaging, CI, and verification docs while leaving the macOS implementation unchanged.
Add the Linux GTK3 host, autonomous movement, MCP integration, opt-in plugins, packaging, CI, and verification docs while leaving the macOS implementation unchanged.
Report the configured host and port, distinguish EADDRINUSE from other bind failures, and explain how to locate or resolve the listener.
Load Codex Pets v2 8x11 spritesheets and add persistent controls for pet scale, message bubble width, and message font size.
Add persisted light/dark themes, independent surface opacity, adjustable rounded corners, compositor blur guidance, and collapsible messages with an unread badge.
Use the v2 atlas look-direction rows while dragging without moving the pet window, while preserving drag-to-move for v1 pets.
# Conflicts:
#	Linux/openpets_linux/overlay.py
#	Linux/openpets_linux/settings.py
#	Linux/openpets_linux/ui.py
#	Linux/tests/test_gui_features.py
#	Linux/tests/test_overlay.py
#	docs/linux-port.md
* fix(linux): clarify MCP port conflict diagnostics

Report the configured host and port, distinguish EADDRINUSE from other bind failures, and explain how to locate or resolve the listener.

* feat(linux): support pet atlas v2 and display settings

Load Codex Pets v2 8x11 spritesheets and add persistent controls for pet scale, message bubble width, and message font size.

* feat(linux): add overlay appearance controls

Add persisted light/dark themes, independent surface opacity, adjustable rounded corners, compositor blur guidance, and collapsible messages with an unread badge.

* feat(linux): add look-direction drag for v2 pets

Use the v2 atlas look-direction rows while dragging without moving the pet window, while preserving drag-to-move for v1 pets.

* feat(linux): polish pet overlay controls and previews
…reeze

feat(linux): freeze pet while tasks are active
Add an opt-in speech bubble with adjustable geometry, opacity, and display duration. Preserve collapsed message previews and cache Pango layout work.
Keep MCP enabled while a port is busy, report pending readiness until the endpoint accepts connections, and stop the child server before quitting the GTK host.
Stop the replaced GLib preview timeout instead of allowing old sources to multiply. Keep expired previews and pet motion aligned with the queued bubble lifetime, render bubbles in a cached separate overlay, and add lifecycle regressions and private diagnostics.
The unit-test CI step runs without Xvfb, so GTK window tests must be skipped there. Keep these checks active in the dedicated Xvfb test runs.
The listener can accept connections before the GTK poll updates its indicator. Keep pumping the main context until both report readiness to avoid racing the active-state assertion.
# Conflicts:
#	Linux/openpets_linux/__main__.py
#	Linux/openpets_linux/animation.py
#	Linux/openpets_linux/core.py
#	Linux/openpets_linux/library_ui.py
#	Linux/openpets_linux/mcp_runtime.py
#	Linux/openpets_linux/mcp_server.py
#	Linux/openpets_linux/motion.py
#	Linux/openpets_linux/notification_ui.py
#	Linux/openpets_linux/overlay.py
#	Linux/openpets_linux/pet.py
#	Linux/openpets_linux/plugin_ui.py
#	Linux/openpets_linux/settings.py
#	Linux/openpets_linux/ui.py
#	Linux/tests/test_animation.py
#	Linux/tests/test_animation_gui.py
#	Linux/tests/test_core.py
#	Linux/tests/test_feature_safety.py
#	Linux/tests/test_gui_features.py
#	Linux/tests/test_motion.py
#	Linux/tests/test_motion_gui.py
#	Linux/tests/test_overlay.py
#	Linux/tests/test_pet.py
#	Linux/tests/test_settings.py
#	docs/linux-mcp.md
#	docs/linux-overlay.md
#	docs/linux-port.md
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