Computer Use

Computer Use lets Amara operate your desktop the way a person would: moving the pointer, clicking, typing, and reading the screen. It extends Syntic Code beyond the shell and the filesystem to graphical applications that have no command-line interface, such as design tools, admin consoles, and legacy desktop software. When a task cannot be completed with commands alone, Computer Use gives the agent a controlled way to drive the GUI.

Enabling Computer Use

Computer Use is off by default because it grants broad control over your machine. Enable it explicitly, and only in an environment you are comfortable handing to an agent, ideally a dedicated VM or a scratch user account.

# Enable computer use for the current project
syntic config set computer-use.enabled true
 
# Start a session with a screen the agent may control
syntic --computer-use

Once enabled, the agent can request screenshots and issue input events. Each session shows what the agent is doing so you can watch and intervene.

How it works

When Amara needs to act on the screen, it captures a screenshot, decides on the next action, and sends a synthetic input event, then captures the result and repeats. This perceive-act loop lets it navigate menus, fill in forms, and verify outcomes visually. You can pause the loop at any time, and permission prompts gate actions that could be destructive.

Safety guidance

Because Computer Use can control anything on the machine, treat it like giving someone remote access. Run it in an isolated environment without access to production credentials, personal accounts, or sensitive files. Keep the session visible while it runs, set narrow permissions, and stop the agent if it heads somewhere unexpected. Never enable Computer Use on a machine where a mistaken click could cause irreversible damage.