Operating Your Computer

Once your Violoop device is connected, it can do more than chat — it can see your screen and work your computer for you. Ask for something, and it opens apps, clicks and types, browses the web, runs commands, and completes multi-step tasks while you watch.

What Violoop Can Do

When a task needs your computer, Violoop can:

• Open and switch between apps — launch a program by name and bring it to the front.
• See your screen — take a screenshot of your display or the focused window to understand what's there before acting.
• Move the mouse and type — click, double-click, right-click, scroll, type text, and press keyboard shortcuts, just like you would.
• Use your web browser — take over your everyday Chrome or Edge to navigate, fill forms, click through pages, and read results.
• Read and edit files — open, change, and create files in the folders you've allowed (see Safety Boundaries).
• Run terminal commands — execute commands in a real terminal for tasks that need it.
• Send you notifications — pop a native desktop notification when something needs your attention.

You never have to learn any special syntax — just describe the task in plain language, and Violoop decides which of these it needs.

Watching It Work

Violoop is designed so you can always see what it's doing.

The status island

A small floating status bar (the "island") stays on top of your other windows and shows what Violoop is doing right now — thinking, responding, or executing a specific action (with the tool name and a short summary, like the command or web address it's working on). You can drag it out of the way or hide it.

On-screen cursor overlay

When Violoop takes control of the mouse and keyboard, a translucent overlay traces what's happening in real time: a ring follows the cursor, clicks show a ripple, and typing and key-presses are shown as they occur. When it reads the screen, a brief scanning effect appears. This makes it obvious, at a glance, that Violoop — not you — is driving.

Desktop Mode

For tasks that need full control of the screen, Violoop enters Desktop Mode: the main app window steps aside, and the island moves to a corner and shows a "Desktop Mode" card so the screen is clear for the work. When the task finishes, the main window comes back automatically.

Action cards in the conversation

Every action also appears in your chat history as a card — the app it opened, the text it typed, the command it ran and its output, the file changes it made. You can scroll back and review exactly what happened.

Staying in Control

You're always in charge. At any point you can:

• Stop it. The island has a Stop button (also on the Desktop Mode card). One click halts the current task.
• Answer when asked. For anything that needs a decision, Violoop pauses and shows an approve/deny or a question card right on the island — it waits for your answer instead of guessing.
• Just take over. Move the mouse or keyboard yourself whenever you want to step in.

Safety Boundaries

Violoop's ability to touch your files is deliberately limited:

• File editing is restricted to allowed folders. Out of the box, Violoop can read and write only in a set of common, safe locations — its own working and output folders, and existing home folders like Desktop, Documents, Downloads, and common code/project folders. Everything else is off-limits to the file tools.
• You can add folders. Need Violoop to work somewhere else? Add that folder under Settings → Permissions → Allowed Directories. See Settings & Preferences.
• Sensitive actions ask first. Commands and actions that could be risky prompt you for confirmation before running, based on the safety policy on your device — which you can tune under Settings → Permissions.

Permissions on macOS

On macOS, the system requires your explicit permission before any app can control your computer or see your screen. The first time Violoop needs them, grant these in System Settings → Privacy & Security:

Permission	Why it's needed
Accessibility	To move the mouse and type on your behalf.
Automation	To open and control other apps and read which app is in front.
Screen Recording	To see your screen and read window contents.
Full Disk Access (optional)	Only if you want file tools to reach system-protected locations.

Violoop's Settings → System Permissions page shows the status of each and links you straight to the right settings pane. After granting Screen Recording, you'll need to relaunch Violoop for it to take effect.

On Windows and Linux there are no equivalent system prompts — Violoop can operate the computer as soon as the device is connected.

Next Steps

• Fine-tune what Violoop is allowed to do in Settings & Preferences.
• Learn how it remembers your context in Memory & Context.