app-misc/zeo-systray (bentoo)

Search

Install

Install this package:

emerge -a app-misc/zeo-systray

Package Information

Description:
zeo-systray is a desktop tray indicator for Claude Code agent sessions. It shows, at a glance, whether an agent is running, waiting on a permission decision, finished, or still carrying background work, so the session does not have to be kept in front of you. It is fed by Claude Code hooks rather than by any editor, so it covers every session equally: the ones started in an editor's agent panel and the ones started in a terminal. Despite the name it does not require the zeo editor, or any editor. One binary provides both halves: "zeo-systray notify" runs as the hook, reads the payload on stdin and sends a single datagram to a socket in XDG_RUNTIME_DIR, always exiting 0 so that a tray which is not running can never surface as a failure inside an agent turn; "zeo-systray daemon" draws the icon. The daemon keeps its state in memory only and writes nothing to disk. The tray is drawn by speaking StatusNotifierItem over D-Bus directly, with no GTK and no libappindicator, so it works on KDE Plasma, XFCE, MATE, Cinnamon, Budgie and LXQt out of the box, under X11 or Wayland alike. GNOME removed built-in tray support and needs a shell extension such as AppIndicator Support, which is true of every tray application. Hook payloads can carry tool inputs, full shell command lines, transcript paths and assistant text. None of that crosses the socket: only the session id, the working directory, a project label, the session title and per-type counters for background tasks, plus the notification text itself on the Notification event. That boundary is covered by upstream tests.
Homepage:
https://github.com/zeo-workspace/zeo-systray
License:
MIT MIT Unicode-3.0 Unlicense

Versions

Version EAPI Keywords Slot
0.3.0 8 ~amd64 0
0.2.2 8 ~amd64 0

Metadata

Description

Maintainers

Upstream

Raw Metadata XML
<pkgmetadata>
	<maintainer type="person">
		<email>lucascs@proton.me</email>
		<name>Lucas C.S.</name>
	</maintainer>
	<longdescription lang="en">
		zeo-systray is a desktop tray indicator for Claude Code agent sessions.
		It shows, at a glance, whether an agent is running, waiting on a
		permission decision, finished, or still carrying background work, so the
		session does not have to be kept in front of you.

		It is fed by Claude Code hooks rather than by any editor, so it covers
		every session equally: the ones started in an editor's agent panel and
		the ones started in a terminal. Despite the name it does not require the
		zeo editor, or any editor. One binary provides both halves: "zeo-systray
		notify" runs as the hook, reads the payload on stdin and sends a single
		datagram to a socket in XDG_RUNTIME_DIR, always exiting 0 so that a tray
		which is not running can never surface as a failure inside an agent turn;
		"zeo-systray daemon" draws the icon. The daemon keeps its state in memory
		only and writes nothing to disk.

		The tray is drawn by speaking StatusNotifierItem over D-Bus directly, with
		no GTK and no libappindicator, so it works on KDE Plasma, XFCE, MATE,
		Cinnamon, Budgie and LXQt out of the box, under X11 or Wayland alike.
		GNOME removed built-in tray support and needs a shell extension such as
		AppIndicator Support, which is true of every tray application.

		Hook payloads can carry tool inputs, full shell command lines, transcript
		paths and assistant text. None of that crosses the socket: only the
		session id, the working directory, a project label, the session title and
		per-type counters for background tasks, plus the notification text itself
		on the Notification event. That boundary is covered by upstream tests.
	</longdescription>
	<use>
		<flag name="systemd">Install the systemd <pkg>sys-apps/systemd</pkg> user
		unit for the tray daemon. The OpenRC user-scope init script is installed
		unconditionally, so the daemon is startable either way.</flag>
	</use>
	<upstream>
		<bugs-to>https://github.com/zeo-workspace/zeo-systray/issues</bugs-to>
		<remote-id type="github">zeo-workspace/zeo-systray</remote-id>
	</upstream>
</pkgmetadata>

Lint Warnings

USE Flags

Manage flags for this package: euse -i <flag> -p app-misc/zeo-systray | euse -E <flag> -p app-misc/zeo-systray | euse -D <flag> -p app-misc/zeo-systray

Flag Description 0.3.0 0.2.2
systemd Install the systemd <pkg>sys-apps/systemd</pkg> user unit for the tray daemon. The OpenRC user-scope init script is installed unconditionally, so the daemon is startable either way. ✓ ✓

Files

Manifest

Type File Size Versions
DIST zeo-systray-0.2.2.tar.gz 45647 bytes 0.2.2
DIST zeo-systray-0.3.0.tar.gz 53091 bytes 0.3.0
Unmatched Entries
Type File Size
DIST aho-corasick-1.1.5.crate 184315 bytes
DIST async-broadcast-0.7.2.crate 22746 bytes
DIST async-channel-2.5.0.crate 18624 bytes
DIST async-executor-1.14.0.crate 28804 bytes
DIST async-io-2.6.0.crate 51062 bytes
DIST async-lock-3.4.2.crate 39826 bytes
DIST async-process-2.5.0.crate 27552 bytes
DIST async-recursion-1.1.1.crate 14874 bytes
DIST async-signal-0.2.14.crate 16447 bytes
DIST async-task-4.7.1.crate 38077 bytes
DIST async-trait-0.1.92.crate 32039 bytes
DIST atomic-waker-1.1.2.crate 12422 bytes
DIST autocfg-1.5.1.crate 18911 bytes
DIST bitflags-2.13.2.crate 51678 bytes
DIST blocking-1.7.0.crate 18136 bytes
DIST bumpalo-3.20.3.crate 98671 bytes
DIST cfg-if-1.0.4.crate 9360 bytes
DIST concurrent-queue-2.5.0.crate 22654 bytes
DIST crossbeam-utils-0.8.23.crate 47174 bytes
DIST endi-1.1.1.crate 5045 bytes
DIST enumflags2-0.7.12.crate 17544 bytes
DIST enumflags2_derive-0.7.12.crate 8573 bytes
DIST equivalent-1.0.2.crate 7419 bytes
DIST errno-0.3.14.crate 12002 bytes
DIST event-listener-5.4.2.crate 35131 bytes
DIST event-listener-strategy-0.5.4.crate 16179 bytes
DIST fastrand-2.5.0.crate 20782 bytes
DIST futures-channel-0.3.34.crate 33165 bytes
DIST futures-core-0.3.34.crate 14692 bytes
DIST futures-io-0.3.34.crate 9189 bytes
DIST futures-lite-2.6.1.crate 46095 bytes
DIST futures-macro-0.3.34.crate 11926 bytes
DIST futures-task-0.3.34.crate 11376 bytes
DIST futures-util-0.3.34.crate 169782 bytes
DIST getrandom-0.4.3.crate 52437 bytes
DIST hashbrown-0.17.1.crate 155512 bytes
DIST hermit-abi-0.5.3.crate 17458 bytes
DIST hex-0.4.3.crate 13299 bytes
DIST indexmap-2.14.2.crate 103014 bytes
DIST itoa-1.0.18.crate 15935 bytes
DIST js-sys-0.3.105.crate 113002 bytes
DIST ksni-0.3.6.crate 131591 bytes
DIST lazy_static-1.5.0.crate 14025 bytes
DIST libc-0.2.189.crate 851502 bytes
DIST linux-raw-sys-0.12.1.crate 3006116 bytes
DIST log-0.4.34.crate 53395 bytes
DIST matchers-0.2.0.crate 7075 bytes
DIST memchr-2.8.3.crate 99165 bytes
DIST memoffset-0.9.1.crate 9032 bytes
DIST nu-ansi-term-0.50.3.crate 29597 bytes
DIST once_cell-1.21.4.crate 35010 bytes
DIST ordered-stream-0.2.0.crate 19077 bytes
DIST parking-2.2.1.crate 10685 bytes
DIST pastey-0.2.3.crate 20361 bytes
DIST pin-project-lite-0.2.17.crate 31034 bytes
DIST piper-0.2.5.crate 23908 bytes
DIST polling-3.11.0.crate 59387 bytes
DIST proc-macro-crate-3.5.0.crate 12709 bytes
DIST proc-macro2-1.0.107.crate 59588 bytes
DIST quote-1.0.47.crate 31622 bytes
DIST r-efi-6.0.0.crate 65303 bytes
DIST regex-automata-0.4.18.crate 628707 bytes
DIST regex-syntax-0.8.11.crate 359055 bytes
DIST rustix-1.1.4.crate 425241 bytes
DIST rustversion-1.0.23.crate 21013 bytes
DIST serde-1.0.229.crate 83669 bytes
DIST serde_core-1.0.229.crate 63100 bytes
DIST serde_derive-1.0.229.crate 59864 bytes
DIST serde_json-1.0.151.crate 156556 bytes
DIST serde_repr-0.1.21.crate 12412 bytes
DIST sharded-slab-0.1.7.crate 58227 bytes
DIST signal-hook-registry-1.4.8.crate 21668 bytes
DIST slab-0.4.12.crate 19080 bytes
DIST smallvec-1.16.1.crate 32694 bytes
DIST syn-2.0.119.crate 307407 bytes
DIST syn-3.0.5.crate 313222 bytes
DIST task-local-0.1.1.crate 10675 bytes
DIST tempfile-3.27.0.crate 44780 bytes
DIST thread_local-1.1.10.crate 16361 bytes
DIST toml_datetime-1.1.1+spec-1.1.0.crate 17982 bytes
DIST toml_edit-0.25.15+spec-1.1.0.crate 68207 bytes
DIST toml_parser-1.1.3+spec-1.1.0.crate 35888 bytes
DIST tracing-0.1.44.crate 463135 bytes
DIST tracing-attributes-0.1.31.crate 39733 bytes
DIST tracing-core-0.1.36.crate 63967 bytes
DIST tracing-log-0.2.0.crate 17561 bytes
DIST tracing-serde-0.2.0.crate 7755 bytes
DIST tracing-subscriber-0.3.23.crate 213773 bytes
DIST uds_windows-1.2.1.crate 21931 bytes
DIST unicode-ident-1.0.24.crate 49298 bytes
DIST uuid-1.26.1.crate 65928 bytes
DIST valuable-0.1.1.crate 28679 bytes
DIST wasm-bindgen-0.2.128.crate 70345 bytes
DIST wasm-bindgen-macro-0.2.128.crate 9595 bytes
DIST wasm-bindgen-macro-support-0.2.128.crate 118512 bytes
DIST wasm-bindgen-shared-0.2.128.crate 12994 bytes
DIST windows-link-0.2.1.crate 6133 bytes
DIST windows-sys-0.61.2.crate 2517186 bytes
DIST winnow-0.7.15.crate 187092 bytes
DIST winnow-1.0.4.crate 188513 bytes
DIST zbus-5.13.2.crate 174016 bytes
DIST zbus_macros-5.13.2.crate 38749 bytes
DIST zbus_names-4.3.1.crate 18076 bytes
DIST zmij-1.0.23.crate 28612 bytes
DIST zvariant-5.9.2.crate 92444 bytes
DIST zvariant_derive-5.9.2.crate 16586 bytes
DIST zvariant_utils-3.3.0.crate 15417 bytes