af-tray

Documentation

Overview

Command af-tray is the AgentField menu-bar companion.

It is a small, separate binary from the main `af`/agentfield control-plane binary on purpose: it carries the GUI/systray dependency so the server binary never has to. In a headless deployment (Railway, ECS, EC2, a container) the tray simply is never installed or run — and if it is run there anyway, it detects the absence of a GUI session and exits cleanly instead of crashing.

Subcommands:

af-tray run         Run the menu-bar tray (default).
af-tray install     Install the desktop tray + control-plane autostart (macOS).
af-tray uninstall   Remove the desktop tray and autostart.
af-tray version     Print version.

The platform-specific behaviour lives in tray_darwin.go / launchd_darwin.go (real implementation) and tray_other.go (no-op stubs for every other OS).