name	onezion-turix
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.

OneZion-TuriX Skill

This skill allows OpenClaw/WorkBuddy 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").
When you need the agent to plan, reason, and execute complex tasks autonomously.

Key Features

Multi-Model Architecture

TuriX uses a sophisticated multi-model system:

Brain: Understands the task and generates step-by-step plans
Actor: Executes precise UI actions based on visual understanding
Planner: Coordinates high-level task decomposition (when use_plan: true)
Memory: Maintains context across task steps

Skills System

Skills are markdown playbooks that guide the agent for specific domains:

github-web-actions: GitHub navigation, repo search, starring
browser-tasks: General web browser operations
Custom skills can be added to the skills/ directory

Resume Capability

The agent can resume interrupted tasks by setting a stable agent_id.

Running TuriX

Basic Task

~/.agents/skills/onezion-turix/scripts/run_turix.sh "Open Chrome and go to github.com"

Resume Interrupted Task

~/.agents/skills/onezion-turix/scripts/run_turix.sh --resume my-task-001

Note: run_turix.sh updates examples/config.json for you (task, resume, use_plan, use_skills). If you want to keep a hand-edited config, skip passing a task and edit examples/config.json directly.

Tips for Effective Tasks

Good Examples:

"Open Safari, go to google.com, search for 'TuriX AI', and click the first result"
"Open System Settings, click on Dark Mode, then return to System Settings"
"Open Finder, navigate to Documents, and create a new folder named 'Project X'"

Avoid:

Vague instructions: "Help me" or "Fix this"
Impossible actions: "Delete all files"
Tasks requiring system-level permissions without warning

Best Practices:

Be specific about the target application
Break complex tasks into clear steps, but do not mention the precise coordinates on the screen.

Hotkeys

Force Stop: Cmd+Shift+2 - Immediately stops the agent

Monitoring & Logs

Logs are saved to .turix_tmp/logging.log in the project directory. Check this for:

Step-by-step execution details
LLM interactions and reasoning
Errors and recovery attempts

Important Notes

How TuriX Runs

TuriX can be started via OpenClaw exec with pty:true mode
The first launch takes 2-5 minutes to load all AI models (Brain, Actor, Planner, Memory)
Background output is buffered - you won't see live progress until task completes or stops

Before Running

Always set PATH first:

export PATH="/usr/sbin:$PATH"

Why? The screencapture tool is located at /usr/sbin/screencapture, which is not in the default PATH.

Troubleshooting

Error	Solution
`NoneType has no attribute 'save'`	Screen recording permission missing. Grant in System Settings and restart Terminal.
`Screen recording access denied`	Run: `osascript -e 'tell application "Safari" to do JavaScript "alert(1)"'` and click Allow
`Conda environment not found`	Ensure `turix_env` exists: `conda create -n turix_env python=3.12`
Module import errors	Activate environment: `conda activate turix_env` then `pip install -r requirements.txt`
Permission errors for keyboard listener	Add Terminal/IDE to Accessibility permissions

Architecture

User Request
     |
[OpenClaw] -> [onezion-turix Skill] -> [run_turix.sh] -> [TuriX Agent]
                                                       |
                    +----------------------------------+--------------------+
                    |                                  |                    |
               [Planner]                          [Brain]             [Memory]
                    |                                  |                    |
                                               [Actor] -> [Controller] -> [macOS UI]

Skill System Details

Skills are markdown files with YAML frontmatter in the skills/ directory:

---
name: skill-name
description: When to use this skill
---
# Skill Instructions
High-level workflow like: Open Safari, then go to Google.

The Planner selects relevant skills based on name/description; the Brain uses full content for step guidance.

Advanced Options

Option	Description
`use_plan: true`	Enable planning for complex tasks
`use_skills: true`	Enable skill selection
`resume: true`	Resume from previous interruption
`max_steps: N`	Limit total steps (default: 100)
`max_actions_per_step: N`	Actions per step (default: 5)
`force_stop_hotkey`	Custom hotkey to stop agent

Monitoring and Debugging

Check if TuriX is Running

ps aux | grep "python.*main.py" | grep -v grep

Tail logs in real time

tail -f ~/TuriX-CUA/.turix_tmp/logging.log

Force Stop

pkill -f "python examples/main.py"

Log File Reference

File	Description
`logging.log`	Main log file
`brain_llm_interactions.log_brain_N.txt`	Brain model conversations (one per step)
`actor_llm_interactions.log_actor_N.txt`	Actor model conversations (one per step)

Key log markers:

Step N - New step started
Eval: Success/Failed - Current step evaluation
Goal to achieve this step - Current goal
Action - Executed action
Task completed successfully - Task completed

name	onezion-turix
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.