coding-agent

Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.

1. Upewnij się, że masz zainstalowany co najmniej jeden z obsługiwanych agentów kodowania: Claude, Codex, OpenCode lub Pi. Skill będzie szukać dostępnych binariów w systemie.

2. Uruchamiając agenta, zawsze użyj parametru pty:true, ponieważ agenty kodowania są aplikacjami interaktywnego terminala i wymagają pseudo-terminala do poprawnego działania. Bez PTY możesz uzyskać uszkodzony output, brakujące kolory lub zawieszenie się procesu.

3. Aby uruchomić agenta w trybie interaktywnym, użyj polecenia bash z parametrem command zawierającym instrukcję dla agenta, na przykład: bash pty:true command:"codex exec 'Twoja instrukcja'". Zastąp 'codex' nazwą zainstalowanego agenta i dostosuj instrukcję do swoich potrzeb.

4. Jeśli chcesz uruchomić agenta w tle, dodaj parametr background:true. Polecenie zwróci identyfikator sesji, który możesz wykorzystać do monitorowania postępu i pobierania wyników bez czekania na zakończenie procesu.

5. Opcjonalnie ustaw katalog roboczy za pomocą parametru workdir, aby ograniczyć kontekst agenta do określonego folderu, oraz timeout (w sekundach), aby zabezpieczyć się przed długotrwałymi procesami.

6. Aby monitorować sesje działające w tle, użyj akcji list (wyświetla wszystkie sesje) lub poll (sprawdza status konkretnej sesji). Po zakończeniu pracy możesz pobrać pełne wyniki sesji.