turix-mac

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.

1. Przygotuj system: otwórz Ustawienia systemowe macOS, przejdź do Bezpieczeństwo i prywatność, a następnie do sekcji Nagrywanie ekranu. Dodaj /opt/homebrew/bin/node do listy aplikacji, którym zezwalasz na dostęp do nagrywania ekranu. To krok obowiązkowy — bez niego agent nie będzie mógł widzieć pulpitu.

2. Sformułuj zadanie w możliwie konkretny sposób. Zamiast "Otwórz Chrome", użyj "Otwórz Chrome i przejdź do google.com". Im bardziej szczegółowy opis, tym lepiej agent zrozumie, co ma zrobić.

3. Uruchom skrypt pomocniczy poprzez polecenie exec, przekazując pełny opis zadania jako argument. Przykład: skills/local/turix-mac/scripts/run_turix.sh "Otwórz Ustawienia systemowe i przełącz na tryb ciemny". Skrypt automatycznie zaktualizuje plik konfiguracyjny TuriX — nie musisz edytować config.json ręcznie.

4. Czekaj na wykonanie zadania. Ponieważ agent pracuje w tle, monitoruj postęp za pomocą narzędzia process log. Zwróć uwagę na komunikaty o błędach, szczególnie na błąd "NoneType", który zwykle oznacza brak uprawnień do nagrywania ekranu.

5. Jeśli napotkasz błąd "AttributeError: 'NoneType' object has no attribute 'save'", sprawdź ponownie uprawnienia do nagrywania ekranu w Ustawieniach systemowych. Czasami konieczny jest restart procesu.

6. Po pomyślnym wykonaniu zadania agent zwróci wynik. W przypadku zadań wieloetapowych (np. znalezienie faktury i przesłanie jej) agent będzie pracować nad każdym krokiem sekwencyjnie, aż do ukończenia całego przepływu pracy.