turix-mac

TuriX-Mac to umiejętność agenta, która pozwala Ci sterować pulpitem macOS wizualnie. Otwieraj aplikacje, klikaj przyciski i nawiguj interfejsami, które nie mają linii poleceń ani API. Idealny do wieloetapowych przepływów pracy — od odtwarzania muzyki w Spotify po wyszukiwanie faktur w poczcie i przesyłanie ich do portali firmowych. Wymaga uprzedniego przyznania uprawnień do nagrywania ekranu.

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.