turix-mac

name	turix-mac
description	Computer Use Agent (CUA) for macOS automation using TuriX. Use when you need to perform visual tasks on the desktop, such as opening apps, clicking buttons, or navigating UIs that don't have a CLI or API.

TuriX-Mac Skill

This skill allows Clawdbot to control the macOS desktop visually using the TuriX Computer Use Agent.

When to Use

• When asked to perform actions on the Mac desktop (e.g., "Open Spotify and play my liked songs").
• When navigating applications that lack command-line interfaces.
• For multi-step visual workflows (e.g., "Find the latest invoice in my email and upload it to the company portal").

Workflow

1. Preparation: Ensure the user has granted "Screen Recording" permission to /opt/homebrew/bin/node in System Settings.
2. Execution: Pass the user's task directly to the helper script.

Running TuriX

Invoke the helper script via exec. Pass the full task description as arguments. The script will automatically update the TuriX config.json with your task.

skills/local/turix-mac/scripts/run_turix.sh "Open System Settings and switch to Dark Mode"

💡 Tips for the Agent:

• Task Description: Be specific. Instead of "Open Chrome", use "Open Chrome and navigate to google.com".
• Dynamic Injection: You do NOT need to edit config.json manually; the script handles the JSON injection for you.
• Monitoring: Since this is a GUI-based task, keep the session open and use process log to check for status updates or errors like "NoneType" (permission issues).

Note: The process runs in the background. Monitor the output using the process tool if it doesn't return immediately.

Troubleshooting

• NoneType Error: If TuriX fails with AttributeError: 'NoneType' object has no attribute 'save', it usually means screen recording permission is missing or the process needs a restart.
• Path Issues: The script explicitly sets the PATH to include /usr/sbin so it can find the screencapture utility.