Polecenie skribly

Steruj panelami i agentami Skribly Agent spoza okna poleceniem skribly — polecenia, kody wyjścia, przepisy na recenzenta i równoległe worktree oraz bezpieczeństwo.

Polecenie skribly pozwala agentom, skryptom i Tobie sterować panelami spoza okna. Agent może uruchomić obok siebie recenzenta, poczekać na niego i przeczytać wynik. Serwer MCP, skribly mcp, udostępnia te same operacje agentom jako narzędzia MCP; opisuje go osobna strona, która jest planowana.

Jak to działa

API sterowania działa wewnątrz aplikacji i nasłuchuje tylko na 127.0.0.1, na losowym wolnym porcie.
Port i losowy token są zapisywane w ~/.skribly/control.json, który możesz odczytać tylko Ty. Żądania bez poprawnego tokenu dostają 401.
skribly to skrypt Node bez zależności. Działa tylko wtedy, gdy aplikacja jest uruchomiona.
Sesje uruchomione w ten sposób pojawiają się w widoku Agenci jak wszystkie inne.

Włącz

Otwórz Ustawienia → Sesje i sterowanie → Lokalne API sterowania. Domyślnie jest włączone.
W sekcji Polecenie skribly wybierz Zainstaluj, żeby dodać polecenie do PATH.
Opcjonalnie zainstaluj w projekcie skill skribly. Uczy Claude Code i Codexa, kiedy i jak przekazywać pracę.

Polecenia

Polecenia przyjmują cel: nazwę sesji, na przykład reviewer, identyfikator panelu albo current dla panelu, z którego je wywołujesz. Każde polecenie wypisuje JSON, a --text wypisuje zwykły tekst dla read i explain.

Polecenie	Co robi
`skribly status`	Liczba paneli i agentów oraz ich stany
`skribly workspace list`	Projekty, worktree i panele w każdym z nich
`skribly pane list`	Wszystkie panele, powłoki i agenci
`skribly pane create`	Otwiera nowy panel
`skribly pane run`	Wpisuje polecenie powłoki i Enter
`skribly pane read`	Czyta ekran jako tekst
`skribly pane wait-output`	Czeka, aż wyjście dopasuje się do wyrażenia regularnego
`skribly pane rename`	Nadaje panelowi nazwę dla API
`skribly pane close`	Zamyka panel
`skribly agent list`	Agenci i ich stany
`skribly agent start`	Uruchamia nazwanego agenta w nowym panelu, opcjonalnie w worktree
`skribly agent prompt`	Wysyła wiadomość i może poczekać na koniec tury
`skribly agent read`	Czyta ekran agenta
`skribly agent wait`	Czeka na wybrane stany
`skribly agent explain`	Pokazuje, dlaczego agent jest w danym stanie
`skribly agent stop`	Zamyka panel agenta
`skribly worktree list`	Wypisuje worktree projektu
`skribly worktree create`	Tworzy worktree
`skribly worktree remove`	Usuwa worktree i zostawia gałąź
`skribly notify`	Wysyła powiadomienie systemowe
`skribly mcp`	Uruchamia serwer MCP

Kod	Znaczenie
`0`	Sukces
`1`	Błąd, na przykład nieznany cel
`2`	Złe użycie lub brak połączenia
`124`	Przekroczony limit czasu

Przepisy

Recenzent obok wykonawcy

skribly agent start reviewer --kind claude --prompt "Review the changes from git diff."
skribly agent wait reviewer --until done --timeout 600
skribly agent read reviewer --lines 60 --text

Równoległe worktree

Każdy agent dostaje własny katalog i gałąź, więc nie nadpisują sobie plików.

skribly agent start impl-api --kind codex --worktree feature/api-export --prompt "Build the CSV export endpoint per SPEC.md"
skribly agent start impl-ui --kind claude --worktree feature/ui-export --prompt "Build the export button per SPEC.md"
skribly agent wait impl-api --until finished --timeout 1800
skribly agent wait impl-ui --until finished --timeout 1800

Poczekaj i zareaguj

blocked oznacza, że agent prosi o zgodę lub wybór.

skribly agent wait impl-api --until done,blocked --timeout 900
skribly agent explain impl-api --text
skribly agent read impl-api --lines 30 --text
skribly agent prompt impl-api "1"

Poczekaj na polecenie powłoki

skribly pane create tests --kind shell
skribly pane run tests npm test
skribly pane wait-output tests "Tests:.*(passed|failed)" --timeout 300 --new

Bezpieczeństwo

Inni użytkownicy systemu nie mogą czytać control.json, ale może to każdy proces Twojego użytkownika. Jeśli nie używasz API, wyłącz je przełącznikiem w Ustawieniach. Porty otwierane przez aplikację są wymienione w Dane i sieć.

Czytaj dalej

Skróty klawiszowe: klawisze paneli, aplikacji i edytora.
Dane i sieć: co nasłuchuje i kto ma do tego dostęp.
Funkcje: CLI na tle pozostałych widoków.