Module indicator 

On-screen indicator for agent activity.

The MCP server reports each desktop action to the computer-use-linux-indicator overlay as one JSON datagram on a socket in $XDG_RUNTIME_DIR. The overlay draws a software cursor that glides to the target, keycaps for key presses, an edge glow and a status pill. The server starts the overlay on the first action. Set COMPUTER_USE_LINUX_INDICATOR=0 to turn it off.

Every server keeps the overlay out of its screen captures, even with its own indicator disabled, because one overlay serves all agents in the session. For the length of a capture the server holds a shared lock on capture_lock_path, and the overlay draws nothing while anyone holds it. The kernel drops the lock of a server that dies, so a crash cannot freeze the overlay. capture: begin and end datagrams make the overlay react at once; it answers begin with CAPTURE_REPLY_SHOWN or CAPTURE_REPLY_EMPTY, so a capture waits for the compositor only when something was on screen.

Structs

IndicatorEvent

One overlay update.

Enums

Capture

A server starting or finishing a screen capture.

Constants

CAPTURE_REPLY_EMPTY

Reply to capture: begin when nothing was on screen.

CAPTURE_REPLY_SHOWN

Reply to capture: begin when the overlay had something on screen.

GLIDE

How long the overlay cursor takes to reach a target. Pointer actions wait this long so the cursor lands before the real input happens.

HIDE_SETTLE

Time for the compositor to drop overlay surfaces before a capture.

INDICATOR_BINARY

Overlay binary name, resolved next to the server binary or on PATH.

SOCKET_NAME

Socket file name inside $XDG_RUNTIME_DIR.

Functions

agent_display_name

Maps an MCP clientInfo to the name shown on screen.

capture_lock_path

Lock file held shared by every server for the length of a capture.

gnome_indicator_state

State of the activity renderer in the verified GNOME Shell extension.

hide_gnome_indicator

Hides the GNOME indicator and reports whether compositor settling is needed. An absent or older extension cannot show an indicator.

is_gnome_session

Whether the session uses the GNOME Shell renderer.

show_gnome_indicator

Updates the indicator in the verified GNOME Shell extension. The age keeps a capture resume from extending the idle deadline.

socket_path

Path of the overlay socket, or None without XDG_RUNTIME_DIR.