Catalog/ Desktop/ Mouse Driver
Desktop · stdio · local

Mouse Driver

Human-shaped pointer control for this desktop.

Connected stdio 1.0.0 9 tools

What it does

summary

Drives the real X11 pointer on trinity the way a hand would: curved approach, variable speed, overshoot correction, tremor, deliberate pauses. Armed per session, with a kill switch and a live HUD.

Touch the machine itself: pointer, windows, input. Local stdio only, never exposed.

Tools

9 documented · authored
Mouse Driver tool surface
ToolDescription
mouse_arm Arm pointer control for a bounded session and return the expiry. Every action tool refuses to move the pointer while disarmed.
mouse_disarm Disarm immediately and stop any motion in flight. Equivalent to the Esc double-press kill switch.
mouse_status Armed state, remaining TTL, cursor position, screen geometry and the current session counters.
mouse_move Move to a screen coordinate with human motion: curved approach, speed profile, overshoot correction and tremor. Returns the path actually taken.
mouse_click Move to the target, settle, then click. Button and click count are explicit; the settle delay prevents drags being read as clicks.
mouse_drag Press, move along a curve with deliberate speed, then release. Used for selection and scrollbar drags.
mouse_scroll Scroll by a number of notches at the current pointer, with the same easing as movement.
mouse_trace Return the recorded path of the last action, downsampled, for verification and the HUD trail.
mouse_session Start, inspect or end a named session. Sessions carry the telemetry record the console replays.

Documented from the v1.0.0 contract. The running server's tools/list is authoritative.

Install / connect

~/projects/mouse-driver-kituwa/.venv/bin/python -m mouse_driver.mcp_server

Client-side configuration. Secrets and connection strings belong in your own environment, never in this registry.

Safety

rules

Refuses every pointer action unless the session is armed (mouse_arm). Esc double-press or `mouse-driver disarm` stops motion immediately. History window only.