dulus-bar 0.3.0__tar.gz

dulus_bar-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Rojo (Dulus)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dulus_bar-0.3.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: dulus-bar
+Version: 0.3.0
+Summary: Dulus Bar — a cross-platform Dynamic Island for your AI agents (Windows / macOS / Linux)
+Author-email: Dulus <dev@dulus.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/Dulus-Ai/Dulus-bar
+Project-URL: Repository, https://github.com/Dulus-Ai/Dulus-bar
+Project-URL: Issues, https://github.com/Dulus-Ai/Dulus-bar/issues
+Keywords: ai,agents,overlay,dynamic-island,notch,claude,codex,gemini,cursor,dulus,windows,macos,linux
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt6>=6.4.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pywin32>=306; sys_platform == "win32"
+Requires-Dist: pyobjc-framework-Cocoa>=9.0; sys_platform == "darwin"
+Requires-Dist: pyobjc-framework-Quartz>=9.0; sys_platform == "darwin"
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6.0; extra == "build"
+Dynamic: license-file
+
+<h1 align="center">Dulus Bar 🦅</h1>
+
+<p align="center">
+  <strong>A cross-platform Dynamic Island for your AI agents.</strong><br>
+  Free. Native. MIT. Works with <em>any</em> agent — no account, no cloud, no lock-in.
+</p>
+
+<p align="center">
+  <code>pip install dulus-bar</code>
+</p>
+
+<p align="center">
+  <img alt="MIT" src="https://img.shields.io/badge/license-MIT-green">
+  <img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-blue">
+  <img alt="Platforms" src="https://img.shields.io/badge/platform-Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-lightgrey">
+</p>
+
+---
+
+Dulus Bar puts a floating status island at the top of your screen that shows every
+AI coding agent you're running — Claude Code, Codex, Gemini, Cursor, Dulus, and
+any other CLI — and lets you **Allow / Deny** their permission prompts without
+diving back into a terminal.
+
+It's the idea itself, shipped for everyone. **Not tied to Dulus** — wrap any agent
+and it shows up. We built the island we wanted; here it is for the whole world. 🌎
+
+- **All platforms** — Windows, macOS, and Linux.
+- **macOS notch-native** — on MacBooks with a camera notch the island hugs the
+  notch and stays visible across every Space and full-screen app.
+- **Reveal on hover** — everywhere else it rests as a slim tab at the top edge and
+  slides open when your mouse approaches, or when an agent needs you.
+- **Any agent** — anything with a CLI works through a thin wrapper; well-known
+  agents get their own icon and accent color.
+- **100% local** — no cloud, no account, no telemetry. One WebSocket on
+  `127.0.0.1:17372`.
+
+---
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+pip install dulus-bar
+dulusbar
+```
+
+That's it — the island appears at the top of your screen. Move your mouse to the
+top-center to reveal it; right-click the tray icon for the menu.
+
+<details>
+<summary><strong>From source (for the wired-agent extras)</strong></summary>
+
+```bash
+git clone https://github.com/Dulus-Ai/Dulus-bar.git
+cd Dulus-bar
+
+# macOS / Linux
+./setup.sh
+
+# Windows
+.\setup.ps1
+```
+
+> Linux tip: for click-to-focus of a terminal on X11, install `wmctrl` or `xdotool`.
+>
+> macOS: `setup.sh` also builds the native SwiftUI/AppKit notch surface using the
+> Swift toolchain in Xcode Command Line Tools. The Python process stays the local
+> WebSocket hub; Windows and Linux use the PyQt overlay.
+
+</details>
+
+---
+
+## Wire up any AI agent — zero monopoly
+
+Dulus Bar is **agent-agnostic**. Wrap any CLI and it reports to the island:
+
+```bash
+python wrappers/agent_wrapper.py "Codex" codex fix auth bug
+python wrappers/agent_wrapper.py "Gemini" gemini
+python wrappers/claude_wrapper.py            # Claude Code helper
+```
+
+`agent_wrapper.py "Display Name" <command> [args...]` reports that agent to the
+bar. Known names (Claude, Codex, Gemini, Cursor, Copilot, Kimi, DeepSeek, Grok,
+Qwen, Mistral, Windsurf, Zed, Aider, Ollama, …) get a curated icon + color;
+anything else gets a stable auto-assigned color.
+
+Or **right-click the island → Open agent…** and pick any executable from a file
+dialog — Dulus Bar launches it in its own terminal, already wired.
+
+---
+
+## Works beautifully with Dulus (optional)
+
+If you run [Dulus](https://dulus.ai), the island also shows the active **model**
+and live **context usage** — e.g. `kimi/kimi-k2.5 · ctx 38%`. But you never need
+Dulus to use Dulus Bar. The bar is the gift; Dulus is just one of many agents it
+speaks to.
+
+---
+
+## What it does
+
+- Floating island, top-center (or notch-anchored on macOS).
+- Lists active agents with a live status dot (running / waiting / done / error).
+- When an agent asks for permission, shows **Allow / Deny** right on the island and
+  forwards your choice back to the agent over stdin.
+- Reveals on hover, pops open on agent activity, and **stays open on a permission
+  request** until you answer.
+- Click an agent to jump to its terminal / editor window.
+
+---
+
+## How it works
+
+Agents connect to a tiny local WebSocket hub and send status; the island renders
+it and relays your Allow/Deny back.
+
+**Agent → bar:**
+```json
+{ "agent": "Claude", "type": "tool_request", "session_id": "abc123",
+  "payload": { "tool": "Bash", "args": "rm -rf build/" } }
+```
+Event types: `session_started`, `message`, `tool_request`, `tool_approved`,
+`tool_denied`, `completed`, `error`. (`model` / `ctx` payload fields are optional.)
+
+**Bar → agent (Allow/Deny):**
+```json
+{ "type": "decision", "session_id": "abc123", "payload": { "approved": true } }
+```
+
+```
+dulus_bar/
+  overlay.py        Floating island UI (PyQt6), notch-aware + reveal-on-hover
+  server.py         WebSocket hub (ws://127.0.0.1:17372)
+  agents.py         Per-agent icon + accent color registry
+  native/           win32 / pyobjc / wmctrl window focus per platform
+wrappers/
+  base_wrapper.py   Shared: pipe stdio, detect prompts, inject Allow/Deny
+  agent_wrapper.py  Generic wrapper for any CLI agent
+macos/              Native SwiftUI/AppKit notch surface
+```
+
+---
+
+## Build a standalone binary (optional)
+
+```bash
+pip install pyinstaller
+pyinstaller --noconfirm DulusBar.spec
+```
+
+Output lands in `dist/` — `DulusBar.exe` on Windows, `DulusBar.app` on macOS
+(bundled as an `LSUIElement`, so no Dock icon).
+
+---
+
+## Platform notes
+
+- **Windows** — fully tested. `pywin32` for window focus; PyQt overlay with
+  reveal-on-hover.
+- **macOS** — notch hugging + always-visible via `pyobjc`. Without it, still runs
+  as a plain top-most island.
+- **Linux** — X11 window focus via `wmctrl`/`xdotool`; on Wayland the island shows
+  and stays on top, jump-to-terminal is best-effort.
+
+---
+
+## Contributing
+
+PRs welcome — new agent icons/colors, platform fixes, packaging. Open an issue,
+fork it, ship it.
+
+## License
+
+**MIT.** Use it, fork it, ship it. We shipped the idea on purpose — no monopoly.
+
+<p align="center"><sub>Built by one builder in the Dominican Republic 🇩🇴 — for everyone. 🦅</sub></p>

dulus_bar-0.3.0/README.md

@@ -0,0 +1,181 @@
+<h1 align="center">Dulus Bar 🦅</h1>
+
+<p align="center">
+  <strong>A cross-platform Dynamic Island for your AI agents.</strong><br>
+  Free. Native. MIT. Works with <em>any</em> agent — no account, no cloud, no lock-in.
+</p>
+
+<p align="center">
+  <code>pip install dulus-bar</code>
+</p>
+
+<p align="center">
+  <img alt="MIT" src="https://img.shields.io/badge/license-MIT-green">
+  <img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-blue">
+  <img alt="Platforms" src="https://img.shields.io/badge/platform-Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-lightgrey">
+</p>
+
+---
+
+Dulus Bar puts a floating status island at the top of your screen that shows every
+AI coding agent you're running — Claude Code, Codex, Gemini, Cursor, Dulus, and
+any other CLI — and lets you **Allow / Deny** their permission prompts without
+diving back into a terminal.
+
+It's the idea itself, shipped for everyone. **Not tied to Dulus** — wrap any agent
+and it shows up. We built the island we wanted; here it is for the whole world. 🌎
+
+- **All platforms** — Windows, macOS, and Linux.
+- **macOS notch-native** — on MacBooks with a camera notch the island hugs the
+  notch and stays visible across every Space and full-screen app.
+- **Reveal on hover** — everywhere else it rests as a slim tab at the top edge and
+  slides open when your mouse approaches, or when an agent needs you.
+- **Any agent** — anything with a CLI works through a thin wrapper; well-known
+  agents get their own icon and accent color.
+- **100% local** — no cloud, no account, no telemetry. One WebSocket on
+  `127.0.0.1:17372`.
+
+---
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+pip install dulus-bar
+dulusbar
+```
+
+That's it — the island appears at the top of your screen. Move your mouse to the
+top-center to reveal it; right-click the tray icon for the menu.
+
+<details>
+<summary><strong>From source (for the wired-agent extras)</strong></summary>
+
+```bash
+git clone https://github.com/Dulus-Ai/Dulus-bar.git
+cd Dulus-bar
+
+# macOS / Linux
+./setup.sh
+
+# Windows
+.\setup.ps1
+```
+
+> Linux tip: for click-to-focus of a terminal on X11, install `wmctrl` or `xdotool`.
+>
+> macOS: `setup.sh` also builds the native SwiftUI/AppKit notch surface using the
+> Swift toolchain in Xcode Command Line Tools. The Python process stays the local
+> WebSocket hub; Windows and Linux use the PyQt overlay.
+
+</details>
+
+---
+
+## Wire up any AI agent — zero monopoly
+
+Dulus Bar is **agent-agnostic**. Wrap any CLI and it reports to the island:
+
+```bash
+python wrappers/agent_wrapper.py "Codex" codex fix auth bug
+python wrappers/agent_wrapper.py "Gemini" gemini
+python wrappers/claude_wrapper.py            # Claude Code helper
+```
+
+`agent_wrapper.py "Display Name" <command> [args...]` reports that agent to the
+bar. Known names (Claude, Codex, Gemini, Cursor, Copilot, Kimi, DeepSeek, Grok,
+Qwen, Mistral, Windsurf, Zed, Aider, Ollama, …) get a curated icon + color;
+anything else gets a stable auto-assigned color.
+
+Or **right-click the island → Open agent…** and pick any executable from a file
+dialog — Dulus Bar launches it in its own terminal, already wired.
+
+---
+
+## Works beautifully with Dulus (optional)
+
+If you run [Dulus](https://dulus.ai), the island also shows the active **model**
+and live **context usage** — e.g. `kimi/kimi-k2.5 · ctx 38%`. But you never need
+Dulus to use Dulus Bar. The bar is the gift; Dulus is just one of many agents it
+speaks to.
+
+---
+
+## What it does
+
+- Floating island, top-center (or notch-anchored on macOS).
+- Lists active agents with a live status dot (running / waiting / done / error).
+- When an agent asks for permission, shows **Allow / Deny** right on the island and
+  forwards your choice back to the agent over stdin.
+- Reveals on hover, pops open on agent activity, and **stays open on a permission
+  request** until you answer.
+- Click an agent to jump to its terminal / editor window.
+
+---
+
+## How it works
+
+Agents connect to a tiny local WebSocket hub and send status; the island renders
+it and relays your Allow/Deny back.
+
+**Agent → bar:**
+```json
+{ "agent": "Claude", "type": "tool_request", "session_id": "abc123",
+  "payload": { "tool": "Bash", "args": "rm -rf build/" } }
+```
+Event types: `session_started`, `message`, `tool_request`, `tool_approved`,
+`tool_denied`, `completed`, `error`. (`model` / `ctx` payload fields are optional.)
+
+**Bar → agent (Allow/Deny):**
+```json
+{ "type": "decision", "session_id": "abc123", "payload": { "approved": true } }
+```
+
+```
+dulus_bar/
+  overlay.py        Floating island UI (PyQt6), notch-aware + reveal-on-hover
+  server.py         WebSocket hub (ws://127.0.0.1:17372)
+  agents.py         Per-agent icon + accent color registry
+  native/           win32 / pyobjc / wmctrl window focus per platform
+wrappers/
+  base_wrapper.py   Shared: pipe stdio, detect prompts, inject Allow/Deny
+  agent_wrapper.py  Generic wrapper for any CLI agent
+macos/              Native SwiftUI/AppKit notch surface
+```
+
+---
+
+## Build a standalone binary (optional)
+
+```bash
+pip install pyinstaller
+pyinstaller --noconfirm DulusBar.spec
+```
+
+Output lands in `dist/` — `DulusBar.exe` on Windows, `DulusBar.app` on macOS
+(bundled as an `LSUIElement`, so no Dock icon).
+
+---
+
+## Platform notes
+
+- **Windows** — fully tested. `pywin32` for window focus; PyQt overlay with
+  reveal-on-hover.
+- **macOS** — notch hugging + always-visible via `pyobjc`. Without it, still runs
+  as a plain top-most island.
+- **Linux** — X11 window focus via `wmctrl`/`xdotool`; on Wayland the island shows
+  and stays on top, jump-to-terminal is best-effort.
+
+---
+
+## Contributing
+
+PRs welcome — new agent icons/colors, platform fixes, packaging. Open an issue,
+fork it, ship it.
+
+## License
+
+**MIT.** Use it, fork it, ship it. We shipped the idea on purpose — no monopoly.
+
+<p align="center"><sub>Built by one builder in the Dominican Republic 🇩🇴 — for everyone. 🦅</sub></p>

dulus_bar-0.3.0/dulus_bar/__init__.py

@@ -0,0 +1,6 @@
+"""Dulus Bar — a cross-platform Dynamic Island for your AI agents.
+
+Free, native, no subscription. Windows / macOS (notch-aware) / Linux.
+"""
+
+__version__ = "0.2.0"

dulus_bar-0.3.0/dulus_bar/__main__.py

@@ -0,0 +1,6 @@
+"""python -m dulus_bar"""
+
+from .main import main
+
+if __name__ == "__main__":
+    main()

dulus_bar-0.3.0/dulus_bar/agents.py

@@ -0,0 +1,111 @@
+"""Agent catalog — per-agent identity (icon + accent color) for any AI CLI.
+
+Dulus Bar is agent-agnostic: it will happily show *any* agent name a wrapper
+reports. This module just gives the well-known ones a recognizable emoji and
+accent color, and hands unknown agents a stable, nicely-distributed color so
+the UI still looks intentional. It is presentation-only.
+"""
+
+from __future__ import annotations
+
+import shutil
+from dataclasses import dataclass
+from typing import Dict, List, Tuple
+
+
+@dataclass(frozen=True)
+class AgentStyle:
+    key: str
+    display: str
+    emoji: str
+    accent: str  # hex
+    aliases: tuple = ()
+
+
+# Curated identities. `accent` roughly follows each brand.
+_AGENTS: List[AgentStyle] = [
+    AgentStyle("dulus", "Dulus", "🦅", "#f59e0b", ("dulus", "interant")),
+    AgentStyle("claude", "Claude Code", "✳️", "#d97757", ("claude", "claude code", "anthropic")),
+    AgentStyle("codex", "Codex", "◆", "#10a37f", ("codex", "openai", "gpt")),
+    AgentStyle("gemini", "Gemini", "✦", "#4285f4", ("gemini", "google")),
+    AgentStyle("cursor", "Cursor", "▸", "#7c3aed", ("cursor",)),
+    AgentStyle("copilot", "Copilot", "⧉", "#6e7681", ("copilot", "github copilot")),
+    AgentStyle("kimi", "Kimi", "◐", "#2563eb", ("kimi", "moonshot")),
+    AgentStyle("deepseek", "DeepSeek", "≋", "#4d6bfe", ("deepseek",)),
+    AgentStyle("grok", "Grok", "𝕏", "#111827", ("grok", "xai")),
+    AgentStyle("qwen", "Qwen", "✺", "#615ced", ("qwen", "alibaba", "tongyi")),
+    AgentStyle("mistral", "Mistral", "◢", "#fa5010", ("mistral", "codestral")),
+    AgentStyle("windsurf", "Windsurf", "≈", "#09b6a2", ("windsurf", "codeium")),
+    AgentStyle("zed", "Zed", "⚡", "#084ccf", ("zed",)),
+    AgentStyle("aider", "Aider", "✎", "#22c55e", ("aider",)),
+    AgentStyle("cline", "Cline", "◔", "#0ea5e9", ("cline", "roo")),
+    AgentStyle("ollama", "Ollama", "◍", "#000000", ("ollama", "llama")),
+]
+
+_BY_ALIAS: Dict[str, AgentStyle] = {}
+for _a in _AGENTS:
+    _BY_ALIAS[_a.key] = _a
+    for _al in _a.aliases:
+        _BY_ALIAS[_al] = _a
+
+# Fallback palette for unknown agents (kept colorblind-distinct-ish).
+_FALLBACK_PALETTE = (
+    "#38bdf8",
+    "#a78bfa",
+    "#34d399",
+    "#fbbf24",
+    "#fb7185",
+    "#e879f9",
+    "#5eead4",
+    "#93c5fd",
+)
+
+
+def style_for(agent_name: str) -> AgentStyle:
+    """Return an AgentStyle for any agent name (never raises)."""
+    name = (agent_name or "").strip()
+    low = name.lower()
+    if low in _BY_ALIAS:
+        return _BY_ALIAS[low]
+    for alias, style in _BY_ALIAS.items():
+        if alias in low:
+            return style
+    # Deterministic fallback color from the name.
+    idx = sum(ord(c) for c in low) % len(_FALLBACK_PALETTE) if low else 0
+    return AgentStyle(
+        key=low or "agent",
+        display=name or "Agent",
+        emoji="●",
+        accent=_FALLBACK_PALETTE[idx],
+    )
+
+
+def is_dulus(agent_name: str) -> bool:
+    return style_for(agent_name).key == "dulus"
+
+
+# CLI executable names for known agents, used by "quick launch" in the UI.
+# The first name found on PATH wins.
+_LAUNCH_COMMANDS: Dict[str, Tuple[str, ...]] = {
+    "claude": ("claude",),
+    "codex": ("codex",),
+    "gemini": ("gemini",),
+    "cursor": ("cursor-agent", "cursor"),
+    "aider": ("aider",),
+    "qwen": ("qwen",),
+    "grok": ("grok",),
+    "copilot": ("copilot",),
+    "opencode": ("opencode",),
+}
+
+
+def detect_installed() -> List[Tuple[AgentStyle, str]]:
+    """Return (style, resolved_executable) for known agents found on PATH."""
+    found: List[Tuple[AgentStyle, str]] = []
+    for key, exe_names in _LAUNCH_COMMANDS.items():
+        for exe in exe_names:
+            path = shutil.which(exe)
+            if path:
+                found.append((_BY_ALIAS[key], path))
+                break
+    return found

dulus_bar-0.3.0/dulus_bar/macos_native.py

@@ -0,0 +1,118 @@
+"""Lifecycle bridge for the native SwiftUI/AppKit notch surface on macOS."""
+
+from __future__ import annotations
+
+import atexit
+import os
+import signal
+import subprocess
+import sys
+import time
+from pathlib import Path
+from typing import Optional
+
+from .server import AgentEventServer
+
+WS_PORT = 17372
+_NATIVE_EXECUTABLE = "DulusBarNative"
+
+
+def project_root() -> Path:
+    return Path(__file__).resolve().parent.parent
+
+
+def native_binary(root: Optional[Path] = None) -> Path:
+    """Return the preferred release helper path."""
+    base = root or project_root()
+    override = os.environ.get("DULUS_BAR_NATIVE_BINARY")
+    if override:
+        return Path(override).expanduser().resolve()
+    return base / "macos" / ".build" / "release" / _NATIVE_EXECUTABLE
+
+
+def native_available(root: Optional[Path] = None) -> bool:
+    path = native_binary(root)
+    return path.is_file() and os.access(path, os.X_OK)
+
+
+def build_native(root: Optional[Path] = None) -> Path:
+    """Build the native helper and return its executable path."""
+    base = root or project_root()
+    package = base / "macos"
+    if not (package / "Package.swift").is_file():
+        raise FileNotFoundError(f"native package missing: {package}")
+    subprocess.run(
+        ["swift", "build", "-c", "release"],
+        cwd=package,
+        check=True,
+    )
+    binary = native_binary(base)
+    if not binary.is_file():
+        raise FileNotFoundError(f"native build completed without {binary}")
+    return binary
+
+
+def _terminate(process: subprocess.Popen) -> None:
+    if process.poll() is not None:
+        return
+    process.terminate()
+    try:
+        process.wait(timeout=3)
+    except subprocess.TimeoutExpired:
+        process.kill()
+        process.wait(timeout=2)
+
+
+def run_native() -> int:
+    """Own the WebSocket hub and run the native helper until it exits."""
+    binary = native_binary()
+    if not native_available():
+        if os.environ.get("DULUS_BAR_NATIVE_AUTOBUILD", "1") == "0":
+            raise FileNotFoundError(f"native helper not built: {binary}")
+        print("[dulusbar] native helper missing; building release binary...")
+        binary = build_native()
+
+    server = AgentEventServer(port=WS_PORT)
+    server.start()
+    process = subprocess.Popen(
+        [str(binary), "--websocket", f"ws://127.0.0.1:{WS_PORT}"],
+        cwd=project_root(),
+        env={**os.environ, "DULUS_BAR_PARENT_PID": str(os.getpid())},
+    )
+
+    cleaned = False
+
+    def cleanup() -> None:
+        nonlocal cleaned
+        if cleaned:
+            return
+        cleaned = True
+        _terminate(process)
+        server.stop()
+
+    def handle_signal(signum: int, _frame: object) -> None:
+        cleanup()
+        raise SystemExit(128 + signum)
+
+    atexit.register(cleanup)
+    previous_handlers = {}
+    for signum in (signal.SIGINT, signal.SIGTERM):
+        previous_handlers[signum] = signal.getsignal(signum)
+        signal.signal(signum, handle_signal)
+
+    try:
+        while True:
+            code = process.poll()
+            if code is not None:
+                return code
+            time.sleep(0.25)
+    finally:
+        cleanup()
+        for signum, handler in previous_handlers.items():
+            signal.signal(signum, handler)
+
+
+def should_use_native() -> bool:
+    if sys.platform != "darwin":
+        return False
+    return os.environ.get("DULUS_BAR_FORCE_QT", "0").lower() not in {"1", "true", "yes"}